How to assign custom host names to Meshnet services with a reverse proxy
Learn how to use the Nginx proxy manager to create custom host names for Meshnet services.
As the popularity of self-hosted services continues to grow, so does the challenge of managing multiple IP addresses, host names, and port numbers. It can quickly become overwhelming to keep track of which port number to enter for services like Home Assistant, Jellyfin, or OpenMediaVault.
While a custom DNS server can help overcome the problem of remembering the IP addresses or host names of your peer devices, it's not enough to handle requests that need to be forwarded to a specific port number. This is where a reverse proxy, such as the Nginx proxy manager (NPM), can come in handy. With NPM, you can easily create reverse proxies without needing prior networking knowledge. By combining a custom DNS server with NPM, you can eliminate the need to remember and enter port numbers altogether.
This article showcases the process of setting up the Nginx proxy manager alongside a DNS server to create custom host names for your Meshnet services, simplifying their management.
Before you begin the setup process, make sure that:
- You have changed the DNS addresses of your devices to your custom DNS server.
- Port 80 is not in use by any service on your system.
Note
For this configuration, a standard AdGuard Home installation is used as an example DNS server. If you are running your DNS server using Docker, the steps may differ.
To start, you need a way to create DNS rewrites from a custom host name to a specific IP or host name. While this can be achieved by editing your operating system’s
hosts file, a much more convenient and easily manageable alternative is a custom DNS server.To create a DNS rewrite using AdGuard Home:
- 1.Open your AdGuard Home web interface.
- 2.From the menu bar, select Filters > DNS rewrites.
- 3.Click Add DNS rewrite.
- 4.In the pop-up window, fill in the following information:
- In the upper field, enter a custom host name that you want to use to access a specific service.
- In the lower field, enter
localhost.Example
- 5.Click Save.
You should now see a new entry in the DNS rewrites table. Repeat this procedure for any other host names you want to create.
Tip
AdGuard Home supports wildcard domain names. You can use the format
*.example.com to redirect all subdomains of example.com. This way, you don’t have to add new DNS entries for each service.With the DNS rewrites created, you can deploy your Nginx proxy manager instance. To set up NPM, you need to use Docker Compose.
Windows
macOS and Linux
- 1.Open PowerShell.
- 2.Create a new folder called
nginx-proxy-managerand navigate to it using this command:mkdir nginx-proxy-manager && cd nginx-proxy-manager - 3.Create a
docker-compose.ymlfile and open it using Notepad with the following command:notepad docker-compose.yml - 4.In the Notepad window, paste the following information that specifies the NPM docker image, publishes the required ports, and creates two new folders in your working directory.version: '3.8'services:app:container_name: nginx-proxy-managerimage: 'jc21/nginx-proxy-manager:latest'restart: unless-stoppedports:- '80:80'- '443:443'- '81:81'volumes:- ./data:/data- ./letsencrypt:/etc/letsencrypt
- 5.Press Ctrl + S to save changes.
- 6.Exit Notepad.
- 1.Open Terminal.
- 2.Create a new folder called
nginx-proxy-managerand navigate to it using this command:mkdir nginx-proxy-manager && cd nginx-proxy-manager - 3.Create a
docker-compose.ymlfile and open it using the Nano text editor with the following command:nano docker-compose.yml - 4.In the terminal window, paste the following information that specifies the NPM docker image, publishes the required ports, and creates two new folders in your working directory.version: '3.8'services:app:container_name: nginx-proxy-managerimage: 'jc21/nginx-proxy-manager:latest'restart: unless-stoppedports:- '80:80'- '443:443'- '81:81'volumes:- ./data:/data- ./letsencrypt:/etc/letsencrypt
- 5.Press Ctrl + X, Y, and Enter to save changes and exit.
With the Compose file created, while in the
nginx-proxy-manager directory, execute the following command in the command line to create your NPM instance:docker-compose up -d
Once the container is active, you can visit the NPM web interface.
- 1.Open your internet browser.
- 2.In the URL bar, enter
localhost:81/and press Enter. - 3.Log in using the default email (
[email protected]) and password (changeme).
After logging in, you will be asked to change the details of your account. Follow the on-screen instructions to update your credentials.
Finally, you can create a proxy redirect for your created host name to reach a specific service.
- 1.From the NPM dashboard, select Proxy hosts.
- 2.Click Add proxy host.
- 3.In the new window, specify the following information:
- In the Domain names field, enter the custom host name you created in the Creating DNS rewrites section.
- In the Forward hostname / IP field, type in the Nord name or the Meshnet IP address of your Meshnet peer device.
- In the Forward port field, enter a port number that the peer device’s service is using. Example
- 4.Click Save.
You should see a new entry for your proxy appear in the Proxy hosts table.
Now you can access your Meshnet services without needing to specify the Nord name or the port that you want to reach.
