update readme, document Data::Validate::IP
This commit is contained in:
Al
parent
e910af8bac
commit
4467c63527
1 changed files with 22 additions and 21 deletions
43
README.md
43
README.md
|
|
@ -29,28 +29,29 @@ Dynamic DNS services currently supported include:
|
|||
Freemyip - See https://freemyip.com for details
|
||||
woima.fi - See https://woima.fi/ for details
|
||||
|
||||
DDclient now supports many of cable/dsl broadband routers.
|
||||
DDclient now supports many of cable/dsl broadband routers.
|
||||
|
||||
Comments, suggestions and requests: use the forums on
|
||||
Comments, suggestions and requests: use the forums on
|
||||
http://sourceforge.net/projects/ddclient/
|
||||
|
||||
The code was originally written by Paul Burry and is now hosted and maintained
|
||||
The code was originally written by Paul Burry and is now hosted and maintained
|
||||
through sourceforge.net. Please check out http://ddclient.sf.net
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
REQUIREMENTS:
|
||||
## REQUIREMENTS:
|
||||
|
||||
- one or more accounts from one of the dynamic DNS services
|
||||
|
||||
- Perl 5.014 or later
|
||||
(you need the IO::Socket::SSL perl library for ssl-support,
|
||||
JSON::PP perl library for JSON support and
|
||||
IO::Socket:INET6 perl library for ipv6-support)
|
||||
- `Data::Validate::IP` perl library
|
||||
- `IO::Socket::SSL` perl library for ssl-support
|
||||
- `JSON::PP` perl library for JSON support
|
||||
- `IO::Socket:INET6` perl library for ipv6-support
|
||||
|
||||
- Linux or probably any common Unix system
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
INSTALLATION:
|
||||
## INSTALLATION:
|
||||
|
||||
cp ddclient /usr/sbin/
|
||||
mkdir /etc/ddclient
|
||||
|
|
@ -71,16 +72,16 @@ INSTALLATION:
|
|||
cp sample-etc_rc.d_init.d_ddclient.alpine /etc/init.d/ddclient
|
||||
## enable automatic startup when booting
|
||||
rc-update add ddclient
|
||||
## make sure you have perl installed
|
||||
## make sure you have perl installed
|
||||
apk add perl
|
||||
## start the first time by hand
|
||||
rc-service ddclient start
|
||||
|
||||
|
||||
## For those using Ubuntu style rc files and using daemon-mode:
|
||||
cp sample-etc_rc.d_init.d_ddclient.ubuntu /etc/init.d/ddclient
|
||||
## enable automatic startup when booting
|
||||
update-rc.d ddclient defaults
|
||||
## make sure you have perl installed
|
||||
## make sure you have perl installed
|
||||
apt-get install perl
|
||||
## start the first time by hand
|
||||
service ddclient start
|
||||
|
|
@ -89,7 +90,7 @@ INSTALLATION:
|
|||
## as described below.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
TROUBLESHOOTING:
|
||||
## TROUBLESHOOTING:
|
||||
|
||||
1. enable debugging and verbose messages.
|
||||
``$ ddclient -daemon=0 -debug -verbose -noquiet``
|
||||
|
|
@ -109,10 +110,10 @@ TROUBLESHOOTING:
|
|||
``fw=url-to-your-router``'s-status-page
|
||||
``fw-skip=any-string-preceding-your-IP-address``
|
||||
|
||||
ddclient does something like this to provide builtin support for
|
||||
ddclient does something like this to provide builtin support for
|
||||
common routers.
|
||||
For example, the Linksys routers could have been added with:
|
||||
|
||||
|
||||
fw=192.168.1.1/Status.htm
|
||||
fw-skip=WAN.*?IP Address
|
||||
|
||||
|
|
@ -134,7 +135,7 @@ TROUBLESHOOTING:
|
|||
while some others accept anything.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
USING DDCLIENT WITH ppp
|
||||
## USING DDCLIENT WITH ppp
|
||||
|
||||
If you are using a ppp connection, you can easily update your DynDNS
|
||||
entry with each connection, with:
|
||||
|
|
@ -146,7 +147,7 @@ Alternatively, you may just configure ddclient to operate as a daemon
|
|||
and monitor your ppp interface.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
USING DDCLIENT WITH cron
|
||||
## USING DDCLIENT WITH cron
|
||||
|
||||
If you have not configured ddclient to use daemon-mode, you'll need to
|
||||
configure cron to force an update once a month so that the dns entry will
|
||||
|
|
@ -157,7 +158,7 @@ not become stale.
|
|||
vi /etc/cron.d/ddclient
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
USING DDCLIENT WITH dhcpcd-1.3.17
|
||||
## USING DDCLIENT WITH dhcpcd-1.3.17
|
||||
|
||||
If you are using dhcpcd-1.3.17 or thereabouts, you can easily update
|
||||
your DynDNS entry automatically every time your lease is obtained
|
||||
|
|
@ -171,19 +172,19 @@ In my case, it is named dhcpcd-eth0.exe and contains the lines:
|
|||
#!/bin/sh
|
||||
PATH=/usr/sbin:/root/bin:${PATH}
|
||||
logger -t dhcpcd IP address changed to $1
|
||||
ddclient -proxy fasthttp.sympatico.ca -wildcard -ip $1 | logger -t ddclient
|
||||
ddclient -proxy fasthttp.sympatico.ca -wildcard -ip $1 | logger -t ddclient
|
||||
exit 0
|
||||
|
||||
Other DHCP clients may have another method of calling out to programs
|
||||
for updating DNS entries.
|
||||
for updating DNS entries.
|
||||
|
||||
Alternatively, you may just configure ddclient to operate as a daemon
|
||||
and monitor your ethernet interface.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
USING DDCLIENT WITH dhclient
|
||||
## USING DDCLIENT WITH dhclient
|
||||
|
||||
If you are using the ISC DHCP client (dhclient), you can update
|
||||
If you are using the ISC DHCP client (dhclient), you can update
|
||||
your DynDNS entry automatically every time your lease is obtained
|
||||
or renewed by creating an executable file named:
|
||||
/etc/dhclient-exit-hooks
|
||||
|
|
|
|||
Loading…
Reference in a new issue