Skip to content
A dynamic dns client for updating hostnames
JavaScript
Find file
Latest commit 0ce9834 @kersten fixed minor bugs
Failed to load latest commit information.
example fixed minor bugs
lib fixed minor bugs
.gitignore Code reformatted
LICENSE just added some files
README.md fixed minor bugs
index.js just added some files
package.json fixed minor bugs

README.md

node-dyndns-client

A dynamic dns client for updating hostnames

Options

  • url: The URL of the dynamic dns service (eg: http://[USERNAME]:[PASSWORD]@members.dyndns.org/nic/update?hostname=[HOSTNAME]&myip=[IP])
  • hostname: Dynamic dns hostname that should be updated. Can be array (for multi host update) or string
  • username: Username for authenticate at the service
  • password: Password for authenticate at the service
  • interface: Networkinterface that is connected to the internet (eg: ppp0). If empty API from externalip.net is used
  • protocol: IP protocol should be ipv4 or ipv6
  • check: Interval in minutes to check current IP

URL Parsing

The URL you provide to the API will be parsed and the given placeholders will be replaced with the given parameters. If you have a service where no password is required, just an API-Key use ether the password or username parameter for replacing.

Usage

var DynDNSClient = require("node-dyndns-client"),
    dyndns = new DynDNSClient({
        url                 : "http://members.dyndns.org/nic/update",
        hostname            : [
            "test.dyndns.org",
            "customtest.dyndns.org"
        ],
        username            : 'username',
        password            : 'password',
        network_interface   : 'en0',
        protocol            : 'ipv4',
        check               : 60
    });

dyndns.on('IP:changed', function (newIP, oldIP) {
    // IP has changed
});

dyndns.on('update:success', function () {
    // Update at services succeeded
});

dyndns.on('error', function (err) {
    // Update at services failed
});
Something went wrong with that request. Please try again.