Fabio/ddclient
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update readme, document Data::Validate::IP

Browse source
This commit is contained in:
Al 2019-06-25 14:16:37 -04:00
parent e910af8bac
commit 4467c63527
1 changed files with 22 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

43
README.md
View file

@ -29,28 +29,29 @@ Dynamic DNS services currently supported include:
Freemyip - See https://freemyip.com for details Freemyip - See https://freemyip.com for details
woima.fi - See https://woima.fi/ 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/ 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 through sourceforge.net. Please check out http://ddclient.sf.net
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
REQUIREMENTS: ## REQUIREMENTS:
- one or more accounts from one of the dynamic DNS services - one or more accounts from one of the dynamic DNS services
- Perl 5.014 or later - Perl 5.014 or later
(you need the IO::Socket::SSL perl library for ssl-support, - `Data::Validate::IP` perl library
JSON::PP perl library for JSON support and - `IO::Socket::SSL` perl library for ssl-support
IO::Socket:INET6 perl library for ipv6-support) - `JSON::PP` perl library for JSON support
- `IO::Socket:INET6` perl library for ipv6-support
- Linux or probably any common Unix system - Linux or probably any common Unix system
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
INSTALLATION: ## INSTALLATION:
cp ddclient /usr/sbin/ cp ddclient /usr/sbin/
mkdir /etc/ddclient mkdir /etc/ddclient
@ -71,16 +72,16 @@ INSTALLATION:
cp sample-etc_rc.d_init.d_ddclient.alpine /etc/init.d/ddclient cp sample-etc_rc.d_init.d_ddclient.alpine /etc/init.d/ddclient
## enable automatic startup when booting ## enable automatic startup when booting
rc-update add ddclient rc-update add ddclient
## make sure you have perl installed ## make sure you have perl installed
apk add perl apk add perl
## start the first time by hand ## start the first time by hand
rc-service ddclient start rc-service ddclient start
## For those using Ubuntu style rc files and using daemon-mode: ## For those using Ubuntu style rc files and using daemon-mode:
cp sample-etc_rc.d_init.d_ddclient.ubuntu /etc/init.d/ddclient cp sample-etc_rc.d_init.d_ddclient.ubuntu /etc/init.d/ddclient
## enable automatic startup when booting ## enable automatic startup when booting
update-rc.d ddclient defaults update-rc.d ddclient defaults
## make sure you have perl installed ## make sure you have perl installed
apt-get install perl apt-get install perl
## start the first time by hand ## start the first time by hand
service ddclient start service ddclient start
@ -89,7 +90,7 @@ INSTALLATION:
## as described below. ## as described below.
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
TROUBLESHOOTING: ## TROUBLESHOOTING:
1. enable debugging and verbose messages. 1. enable debugging and verbose messages.
``$ ddclient -daemon=0 -debug -verbose -noquiet`` ``$ ddclient -daemon=0 -debug -verbose -noquiet``
@ -109,10 +110,10 @@ TROUBLESHOOTING:
``fw=url-to-your-router``'s-status-page ``fw=url-to-your-router``'s-status-page
``fw-skip=any-string-preceding-your-IP-address`` ``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. common routers.
For example, the Linksys routers could have been added with: For example, the Linksys routers could have been added with:
fw=192.168.1.1/Status.htm fw=192.168.1.1/Status.htm
fw-skip=WAN.*?IP Address fw-skip=WAN.*?IP Address
@ -134,7 +135,7 @@ TROUBLESHOOTING:
while some others accept anything. 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 If you are using a ppp connection, you can easily update your DynDNS
entry with each connection, with: 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. 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 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 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 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 If you are using dhcpcd-1.3.17 or thereabouts, you can easily update
your DynDNS entry automatically every time your lease is obtained 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 #!/bin/sh
PATH=/usr/sbin:/root/bin:${PATH} PATH=/usr/sbin:/root/bin:${PATH}
logger -t dhcpcd IP address changed to $1 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 exit 0
Other DHCP clients may have another method of calling out to programs 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 Alternatively, you may just configure ddclient to operate as a daemon
and monitor your ethernet interface. 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 your DynDNS entry automatically every time your lease is obtained
or renewed by creating an executable file named: or renewed by creating an executable file named:
/etc/dhclient-exit-hooks /etc/dhclient-exit-hooks