A tiny command line utility for implementing DDNS with Cloudflare.
- Supports virtually any server that is capable of running Python
- Synology DiskStations supported
- Quick to install using
yum/dnforpip
Update DNS A record for foo.example.com to 1.2.3.4
cloudflareddns --hostname foo.example.com --ip 1.2.3.4Likewise, for an AAAA record:
cloudflareddns --hostname foo.example.com --ip 2001:0db8:85a3:0000:0000:8a2e:0370:7334Get all options by simply running cloudflareddns -h:
usage: cloudflareddns [-h] [--email EMAIL] [--key KEY] [--hostname HOSTNAME]
[--ip IP] [--ttl TTL] [--verbose] [--version]
Update DDNS in Cloudflare.
optional arguments:
-h, --help show this help message and exit
--email EMAIL Cloudflare account email (omit if using API tokens)
--key KEY Cloudflare API key or token
--hostname HOSTNAME Hostname to set IP for
--ip IP The IP address
--ttl TTL TTL in seconds
--verbose
--version show program's version number and exit
When invoked without any options, cloudflareddns will try to point the
FQDN (aka <hostname>.<domain-name> of the machine it runs on to its public IP address (auto-detected).
You can configure a Synology DiskStation with CloudFlare DDNS.
It's worth noting that if your Synology DSM is recent enough, you can simply use Synology's own DDNS service, then create a CNAME record at your domain that points to it. The downside to this solution, however, is extra DNS lookup required to resolve domain to IP.
Alternative solution is to use cloudflaredns which ships with the necessary CLI interface for Synology compatibility: cloudflareddns-syno.
- Login to your DSM
- Go to Control Panel > Terminal & SNMP > Enable SSH service
- Use your client or commandline to access Synology. If you don't have any, I recommend you try out Putty for Windows.
- Use your Synology admin account to connect.
If you're not a lazy man, checkout instructions on installing using virtualenv for this step. For quick setup instead:
curl https://bootstrap.pypa.io/get-pip.py | python
pip install cloudflareddns
Run the following command to add new DDNS provider:
cat >> /etc/ddns_provider.conf << 'EOF'
[USER_Cloudflare]
modulepath=/bin/cloudflareddns-syno
queryurl=https://www.cloudflare.com/
EOF
It is recommended to use a Cloudflare API token. Check the wiki page for instructions on how to get an API token with the most secure permissions.
Alternatively, you can get Cloudflare global API key in your account settings.
- Login to your DSM
- Go to Control Panel > External Access > DDNS > Add
- Select Cloudflare as service provider
- Enter your domain as hostname
- If using token authentication: enter
xin the Username/Email, and API token as Password/Key. The requirement to putxis due to Synology GUI's constraints not allowing for an empty field - If using global API key: enter your Cloudflare account as Username/Email, and API key as Password/Key
sudo yum -y install https://extras.getpagespeed.com/release-latest.rpm
sudo yum install cloudflareddns
Installing with pip is easiest:
pip install cloudflareddns
from cloudflareddns import cloudflareddns
hostname = 'foo.example.com'
ip = '1.2.3.4'
if cloudflareddns.updateRecord(hostname, ip):
print('Record is OK')
...Requires using environment variables (see tips below).
In non-Synology systems, you can store Cloudflare credentials in either environment variables or a configuration file.
Create ~/.cloudflare/cloudflare.cfg and put:
[CloudFlare]
email = [email protected] # Do not set if using an API Token
token = xxxxxxxxxxxxxxxxxxxxxxxxxxxYou can put your Cloudflare credentials into the ~/.bashrc file:
export CF_API_EMAIL="[email protected]" # Do not set if using an API Token
export CF_API_KEY="xxxxxx"Don't forget to source ~/.bashrc if you have just put credentials in there.
The cloudflareddns will pick those up, so no need to pass --email or --key every time.