User Tools

Site Tools


doc:howto:ddns.client

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:howto:ddns.client [2014/08/23 14:41]
charles_brown add info about noip account confirmation
doc:howto:ddns.client [2014/12/13 12:58] (current)
fastred [Requirements] + link to ticket https://dev.openwrt.org/ticket/10192
Line 18: Line 18:
 Here is a list of suggested DDNS providers. Here is a list of suggested DDNS providers.
  
-  * http://​freedns.afraid.org :!: free+  * http://​freedns.afraid.org :!: free - but currently a [[https://​dev.openwrt.org/​ticket/​10192|workaround]] is needed
   * http://​noip.com :!: free but requires annoying account confirmation every 30 days   * http://​noip.com :!: free but requires annoying account confirmation every 30 days
   * http://​changeip.com :!: free   * http://​changeip.com :!: free
Line 45: Line 45:
  
 After ''​luci-app-ddns''​ is installed, just press any other link on the Openwrt LuCI WebUI, and the page will refresh itself and Dynamic DNS will appear under Services > Dynamic DNS. If those tabs don't show up, run ''/​etc/​init.d/​uhttpd restart''​ or reboot the router. After ''​luci-app-ddns''​ is installed, just press any other link on the Openwrt LuCI WebUI, and the page will refresh itself and Dynamic DNS will appear under Services > Dynamic DNS. If those tabs don't show up, run ''/​etc/​init.d/​uhttpd restart''​ or reboot the router.
 +
 +Beginning ddns-scripts Version 1.0.0-23 you need to enable ''​ddns''​ service in "​System"​-"​Startup"​ or run: ''/​etc/​init.d/​ddns enable''​ to enable updates being send on reboot and hotplug events.
  
 ==== Step 2: Configuration ==== ==== Step 2: Configuration ====
Line 58: Line 60:
 | Hostname | The DNS name to update (this name must already be registered with the the DDNS service) | your.domain.name | | Hostname | The DNS name to update (this name must already be registered with the the DDNS service) | your.domain.name |
 | Username | Username of your DDNS service account | yourusername | | Username | Username of your DDNS service account | yourusername |
-| Password | Password of your DDNS service account ​(ensure ​this password does not have "​$1"​ or $ with any number following in it, as this breaks the script| yourpassword |+| Password | Password of your DDNS service account. Ensure ​this password does **not** have "​$1"​ or $ with any number following in it, as this **breaks** the script. **For freedns.afraid.org,​ [[ddns.client#​Specific settings for freedns.afraid.org|read below]]**. ​| yourpassword |
 | Source of IP address | This tells the script how to determine your interface external IP address. See below for a description. | Usually "​network"​ | | Source of IP address | This tells the script how to determine your interface external IP address. See below for a description. | Usually "​network"​ |
 | Network/​Interface/​URL | This will be named based on the section of "​Source of IP address"​. Select the network, interface physical name, or type in the URL to use to determine the external IP address. | Usually "​wan"​ | | Network/​Interface/​URL | This will be named based on the section of "​Source of IP address"​. Select the network, interface physical name, or type in the URL to use to determine the external IP address. | Usually "​wan"​ |
-| Check for changed IP every | Self Explanatory | 10 |+| Check for changed IP every | Self Explanatory. Checks below 5 minutes make no sence because from testing, it takes this time until the global DNS servers be in sync | 10 |
 | Check-time unit | The unit for the value above | min | | Check-time unit | The unit for the value above | min |
 | Force update every | Even if the detected external IP address has not changed, update the DDNS name anyway after this time interval | 72 | | Force update every | Even if the detected external IP address has not changed, update the DDNS name anyway after this time interval | 72 |
Line 68: Line 70:
 Click "Save & Apply" to save changes. Click "Save & Apply" to save changes.
  
-=== Further details ​=== +=== Specific settings for freedns.afraid.org ​=== 
-  * freedns.afraid.org ​specific settings: +    You must **NOT** set your account password in the "​password"​ field. On the contrary, go to http://freedns.afraid.org/dynamic/, login, click "​Direct URL". On the location bar of your browser, copy the the authorisation tokenthe part after http://​freedns.afraid.org/​dynamic/​update.php? ​url. and paste it in the password field.
-    * put the authorisation token from the update url (the part after http://​freedns.afraid.org/​dynamic/​update.php?​in the password field.+
     * DO enter the host into the Hostname field. Although it is not used for the update, it //is// used to check the host's current IP address (via ''​nslookup''​).     * DO enter the host into the Hostname field. Although it is not used for the update, it //is// used to check the host's current IP address (via ''​nslookup''​).
 +
 +=== Further details ===
 +  * **A full list of supported settings (some not supported by LuCI WebUI) and their description you will find [[doc:​uci:​ddns|in UCI documentation]].**
   * Source of IP address ("​ip_source"​ in the configuration file)   * Source of IP address ("​ip_source"​ in the configuration file)
     * The "​ip_source"​ option can be "​network",​ "​interface",​ "​script"​ or "​web",​ with "​network"​ as the default     * The "​ip_source"​ option can be "​network",​ "​interface",​ "​script"​ or "​web",​ with "​network"​ as the default
Line 77: Line 81:
     * If "​ip_source"​ is "​interface"​ you specify a hardware interface (e.g. "​eth1"​) and whatever the current ip of this interface is will be associated with the domain when an update is performed.     * If "​ip_source"​ is "​interface"​ you specify a hardware interface (e.g. "​eth1"​) and whatever the current ip of this interface is will be associated with the domain when an update is performed.
     * If "​ip_source"​ is "​script"​ you specify a script to obtain ip address. The "​ip_script"​ option should contain path to your script. This option is not available through the LuCI web interface.     * If "​ip_source"​ is "​script"​ you specify a script to obtain ip address. The "​ip_script"​ option should contain path to your script. This option is not available through the LuCI web interface.
-    * The last possibility is that "​ip_source"​ is "​web",​ which means that in order to obtain our ip address we will connect to a website (specified in the URL field), and use the first valid ip address listed on that page. Use this option ​of the OpenWrt device is behind a NAT device and does not have a real external IP address assigned to the WAN interface being monitored. The correct URL will depend on the DDNS service being used. Check with the service'​s documentation to determine if they offer this feature and, if so, what the correct URL is.+    * The last possibility is that "​ip_source"​ is "​web",​ which means that in order to obtain our ip address we will connect to a website (specified in the URL field), and use the first valid ip address listed on that page. Use this option ​if the OpenWrt device is behind a NAT device and does not have a real external IP address assigned to the WAN interface being monitored. The correct URL will depend on the DDNS service being used. Check with the service'​s documentation to determine if they offer this feature and, if so, what the correct URL is.
       * For the DynDNS service, the URL is [[http://​checkip.dyndns.org]]       * For the DynDNS service, the URL is [[http://​checkip.dyndns.org]]
       * Multiple URLs can be used by separating the entries with a space.       * Multiple URLs can be used by separating the entries with a space.
Line 86: Line 90:
   * The simplest option is to reboot the router. This will automatically start the scripts as part of the normal interface startup process.   * The simplest option is to reboot the router. This will automatically start the scripts as part of the normal interface startup process.
   * If a reboot should be avoided, the scripts can be started manually by generating a hotplug event from the command line (see below for details)   * If a reboot should be avoided, the scripts can be started manually by generating a hotplug event from the command line (see below for details)
 +  * Beginning ddns-scripts Version 1.0.0-23 you need to enable //​**ddns**//​ service in "​System"​-"​Startup"​ to enable updates being send on reboot and hotplug events.
 +  * You can also start/​stop/​restart the service without reboot or generating a hotplug event.
  
 ==== Step 4: You're done! ==== ==== Step 4: You're done! ====
Line 321: Line 327:
 start_daemon_for_all_ddns_sections "​wan"​ start_daemon_for_all_ddns_sections "​wan"​
 exit exit
 +</​code>​
 +
 +  * Beginning ddns-scripts Version 1.0.0-23
 +    * simply enable/​disable start/​stop/​restart like every other service
 +
 +<​code>​
 +root@OpenWrt:​~#​ /​etc/​init.d/​ddns enable
 +root@OpenWrt:​~#​ /​etc/​init.d/​ddns start
 </​code>​ </​code>​
  
doc/howto/ddns.client.1408797709.txt.bz2 · Last modified: 2014/08/23 14:41 by charles_brown