138 lines
7.7 KiB
HTML
138 lines
7.7 KiB
HTML
<ul class="nav nav-tabs" id="myTab">
|
|
<li class="active"><a href="#generic" data-toggle="tab">General</a></li>
|
|
<li><a href="#avm" data-toggle="tab">AVM Fritz!Box</a></li>
|
|
<li><a href="#ddclient" data-toggle="tab">ddclient</a></li>
|
|
<li><a href="#browser" data-toggle="tab">Browser</a></li>
|
|
</ul>
|
|
|
|
<div class="tab-content">
|
|
<div class="tab-pane active" id="generic">
|
|
<h4>General configuration hints</h4>
|
|
<p>
|
|
Usually, you should configure one system on your network to update the DNS.
|
|
This can be either your router or a host on your network and it will run some software
|
|
called the update client.
|
|
</p>
|
|
<p>
|
|
We have some specific configuration hints for some devices and update clients,
|
|
please see the tabs above. If you don't find yours there, use the generic hints below.
|
|
</p>
|
|
<hr>
|
|
<p>
|
|
Your update client needs to access the following URLs to update the DNS:
|
|
</p>
|
|
For IPv4 updates:
|
|
<div class="well well-sm">
|
|
<a href="http://{{ host.get_fqdn|default:"<your fqdn>" }}:{{ update_secret|default:"<your secret>" }}@ipv4.nsupdate.info/nic/update">http://{{ host.get_fqdn|default:"<your fqdn>" }}:{{ update_secret|default:"<your secret>" }}@ipv4.nsupdate.info/nic/update</a>
|
|
</div>
|
|
For IPv6 updates:
|
|
<div class="well well-sm">
|
|
<a href="http://{{ host.get_fqdn|default:'<your fqdn>' }}:{{ update_secret|default:'<your secret>' }}@ipv6.nsupdate.info/nic/update">http://{{ host.get_fqdn|default:'<your fqdn>' }}:{{ update_secret|default:'<your secret>' }}@ipv6.nsupdate.info/nic/update</a>
|
|
</div>
|
|
The IPs will be determined automatically using the remote address our service is seeing
|
|
(see below for more details).
|
|
<hr>
|
|
<p>
|
|
Your update client has to do the following steps:
|
|
</p>
|
|
<ul>
|
|
<li>Do HTTP Basic Auth with:
|
|
<ul>
|
|
<li>Username: {{ host.get_fqdn|default:"<your fqdn>" }}</li>
|
|
<li>Password: {{ update_secret|default:"<your secret>" }}</li>
|
|
</ul>
|
|
</li>
|
|
<li>Send a http GET request to:
|
|
<ul>
|
|
<li>http://ipv4.nsupdate.info/nic/update (to update IPv4 A record in DNS)</li>
|
|
<li>http://ipv6.nsupdate.info/nic/update (to update IPv6 AAAA record in DNS)</li>
|
|
<li>We support http on port 80 (and soon also https on port 443).</li>
|
|
</ul>
|
|
</li>
|
|
<li>Optionally, we support some URL arguments:
|
|
<ul>
|
|
<li>myip=127.0.0.1 or myip=::1 (by default, we autodetect the IP. If the autodetected IP is not
|
|
the one you want to put into DNS, you need to give the wanted one explicitly using myip=...)
|
|
</li>
|
|
<li>hostname={{ host.get_fqdn|default:"<your fqdn>" }} (if not given: autodetect from http basic auth)</li>
|
|
</ul>
|
|
</li>
|
|
<li>The response status and content will be:
|
|
<ul>
|
|
<li>Status 200 and "good <your ip>" <i class="icon-long-arrow-right"></i> new IP accepted</li>
|
|
<li>Status 200 and "nochg <your ip>" <i class="icon-long-arrow-right"></i> IP accepted, but did not change since last update</li>
|
|
<li>Status 401: Authorization Required <i class="icon-long-arrow-right"></i> Incorrect authentication or no http basic auth header received</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="tab-pane" id="avm">
|
|
<h4>Fritz!Box 6360, 7390 and maybe others:</h4>
|
|
<hr>
|
|
<h5>Go to:</h5>
|
|
<div class="well well-sm">
|
|
Internet <i class="icon-long-arrow-right"></i>
|
|
Permit Access <i class="icon-long-arrow-right"></i>
|
|
Dynamic DNS
|
|
</div>
|
|
<h5>Enter the following data</h5>
|
|
<table class="table">
|
|
<thead><tr><th>Setting</th><th>Value</th></tr></thead>
|
|
<tr><td>Dynamic DNS provider</td><td>Custom</td></tr>
|
|
<tr><td>Update-URL</td><td>http://nsupdate.info/nic/update</td></tr>
|
|
<tr><td>Domain Name</td><td>{{ host.get_fqdn|default:"<your hostname>" }}</td></tr>
|
|
<tr><td>User name</td><td>{{ host.get_fqdn|default:"<your hostname>" }}</td></tr>
|
|
<tr><td>Password</td><td>{{ update_secret|default:"<your secret>" }}</td></tr>
|
|
</table>
|
|
<h5>If you have IPv4 and IPv6</h5>
|
|
Set Update-URL to the following (two URLs, separated by one space)
|
|
<div class="well well-sm">http://ipv4.nsupdate.info/nic/update http://ipv6.nsupdate.info/nic/update</div>
|
|
</div>
|
|
<div class="tab-pane" id="ddclient">
|
|
<h4>ddclient</h4>
|
|
<p>
|
|
ddclient is a popular dyndns update daemon on Linux.
|
|
</p>
|
|
<pre># /etc/ddclient.conf
|
|
protocol=dyndns2
|
|
use=web, web=http://nsupdate.info/myip
|
|
server=nsupdate.info
|
|
login={{ host.get_fqdn|default:"<your hostname>" }}
|
|
password='{{ update_secret|default:"<your secret>" }}'
|
|
{{ host.get_fqdn|default:"<your hostname>" }}
|
|
</pre>
|
|
</div>
|
|
<div class="tab-pane" id="browser">
|
|
<h4>Easy update URLs</h4>
|
|
Explanation of parameters:
|
|
<ul>
|
|
{% if not host %}
|
|
<li><your hostname>: your fully qualified hostname, something like example.nsupdate.info</li>
|
|
{% endif %}
|
|
{% if not update_secret %}
|
|
<li><your secret>: the secret you have configured for this hostname</li>
|
|
{% endif %}
|
|
<li>IP addresses: we use the v4 and v6 localhost addresses in the examples, but
|
|
of course you need to use your real public IP instead of that.
|
|
</li>
|
|
</ul>
|
|
For browser / interactive use (will ask for username (give your hostname) and password (give yoursecret)):
|
|
<ul>
|
|
<li>http://nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
|
|
<li>http://ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
|
|
<li>http://ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
|
|
</ul>
|
|
For browser / interactive use (give http basic auth username and password in URL):
|
|
<ul>
|
|
<li>http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update (updates hostname to point to remote ipv4 or ipv6 address)</li>
|
|
<li>http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@ipv4.nsupdate.info/nic/update (updates hostname to point to remote ipv4 address)</li>
|
|
<li>http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@ipv6.nsupdate.info/nic/update (updates hostname to point to remote ipv6 address)</li>
|
|
</ul>
|
|
For browser / interactive use as above, but manually specifying the IP address:
|
|
<ul>
|
|
<li>http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update?myip=127.0.0.1 (updates hostname to point to ipv4 127.0.0.1)</li>
|
|
<li>http://{{ host.get_fqdn|default:"<your hostname>" }}:{{ update_secret|default:"<your secret>" }}@nsupdate.info/nic/update?myip=::1 (updates hostname to point to ipv6 ::1)</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|