A Dynamic DNS (DDNS) Windows service for Cloudflare.
DnsTube is a Windows service that helps you access your computer remotely even if its IP address changes. It does this by using Cloudflare’s free DNS hosting and API to update the DNS entries for your domain name. This way, you can always access your computer using its domain name instead of having to remember its IP address.
Head over to the Releases page to download the latest binary.
Note: This application is built using .NET 8. You may need to download and install it from here: https://dotnet.microsoft.com/en-us/download. Once you've installed .NET 8:
install-service.bat
.You should see the following output:
PS C:\Program Files\DnsTubeService> .\install-service.bat
sc create "DnsTube Service" binPath="C:\Program Files\DnsTubeService\DnsTube.Service.exe" start=auto
[SC] CreateService SUCCESS
[SC] ChangeServiceConfig2 SUCCESS
SERVICE_NAME: DnsTube Service
TYPE : 10 WIN32_OWN_PROCESS
STATE : 2 START_PENDING
(NOT_STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x7d0
PID : 21408
FLAGS :
PS C:\Program Files\DnsTubeService>
Once the service has started you can view the UI at the URL http://localhost:5666/index.html. See the Configuration section for additional config, or if you need to host the UI on a different port.
If you haven't already done so, you will need to create an account with Cloudflare and make it the DNS authority for your domain. You then need to configure your DNS entries as appropriate. See Managing DNS records in Cloudflare for more info.
By default the service hosts the web application on your local machine at port 5666. If you wish to change this, edit appsettings.json
accordingly. Once the service is running you can launch the interface at http://localhost:5666/ (or whatever port you have chosen).
After that, you'll need to generate an API Token (preferred) or Key in order to access the API via DnsTube. The details for doing that can be found at Creating API tokens.
Then, go the DsnTube settings page and enter your email address, API key/token, etc. Go back to the main tab (refresh if necessary) and you should see a table listing your Cloudflare DNS entries. Check off the ones you want to dynamically update and the service should take it from there.
You can use nslookup to make sure DNS resolution is working correctly, e.g.,
nslookup mydomain.com
stop-service.bat
. Note, the service will stop more quickly if you close the web UI.start-service.bat
Open a command prompt as Administrator and uninstall the service using uninstall-service.bat
. Note, the service will stop more quickly if you close the web UI. You should see the following output:
PS C:\Program Files\DnsTubeService> .\uninstall-service.bat
SERVICE_NAME: DnsTube Service
TYPE : 10 WIN32_OWN_PROCESS
STATE : 3 STOP_PENDING
(STOPPABLE, NOT_PAUSABLE, ACCEPTS_SHUTDOWN)
WIN32_EXIT_CODE : 0 (0x0)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0
[SC] DeleteService SUCCESS
PS C:\Program Files\DnsTubeService>
appsettings.json
.)The front-end application must be built before starting the .NET application. To do this, open a command prompt and go to [YOUR_INSTALL_FOLDER]\DnsTube.Service\ClientApp
. Then run
npm install
npm run build
This will build your files and copy them to the [YOUR_INSTALL_FOLDER]\DnsTube.Service\wwwroot
folder.
At this point you can load the solution in Visual Studio 2022 and run the application with Ctrl - F5
. You should then be able to load the application UI at the URL http://localhost:5666.
We all know the internet is a series of tubes. This application uses those very same tubes to update your DNS.
Contributions are welcome!
This project is licensed under the MIT License - see the LICENSE file for details.