Bash script to update IPv4 and IPv6 records in Cloudflare. Update with WAN or LAN IP.

• 1. Dynamic DNS - Cloudflare
  • 1.1. Real life example
  • 1.2. About
  • 1.3. Requirements
  • 1.4. Installation
  • 1.5. Configuration file
  • 1.6. Configuration Parameters
  • 1.7. Running The Script
  • 1.8. Automation With Crontab
  • 1.9. Logs
• 2. Information for Developers
  • 2.1. Units Test y Code Coverage
  • 2.2. Github CI (actions)
• 3. More info
  • 3.1. Code Quality
  • 3.2. Code Coverage
  • 3.3. License

Result

Settings

domains: - name: jmrp.dev ip_type: external ipv4: true ipv6: true proxied: true ttl: auto - name: git.jmrp.dev ip_type: external ipv4: true ipv6: true proxied: true ttl: auto - name: jenkins.jmrp.dev ip_type: external ipv4: true ipv6: true proxied: true ttl: auto settings: cloudflare: - zone_id: ######### - zone_api_token: ######## misc: - create_if_no_exist: false notifications: telegram: enabled: false bot_token: token chat_id: id

• Bash Script for most Linux, Unix distributions and MacOS.
• Choose any source IP address to update external or internal (WAN/LAN) for ech domain.
• For multiply lan interfaces like Wifi, Docker Networks and Bridges the script will automatically detects the primary Interface by priority.
• Cloudflare's options proxy and TTL configurable via the config file for each domain.
• Optional Telegram Notifications

• curl
• Cloudflare api-token with ZONE-DNS-EDIT Permissions
• DNS Record must be pre created in web interface (WIP: Create record if no exist)

To create a CloudFlare API token for your DNS zone go to cloudflare-api-token-url and follow these steps:

1. Click Create Token
2. Select Create Custom Token
3. Provide the token a name, for example, example.com-dns-zone-readonly
4. Grant the token the following permissions:
   • Zone - DNS - Edit
5. Set the zone resources to:
   • Include - Specific Zone - example.com
6. Complete the wizard and use the generated token at the CLOUDFLARE_API_TOKEN variable for the container

You can place the script at any location manually.

MacOS: Don't use the /usr/local/bin/ for the script location. Create a separate folder under your user path /Users/${USER}

The automatic install examples below will place the script at /usr/local/bin/

wget https://raw.githubusercontent.com/jmrplens/DyDNS_Cloudflare_IPv4-6/main/cloudflare-dns.sh
sudo chmod +x cloudflare-dns.sh
sudo mv cloudflare-dns.sh /usr/local/bin/cloudflare-dns

You can use default config file cloudflare-dns.yaml or pass your own config file as parameter to script.

wget https://raw.githubusercontent.com/jmrplens/DyDNS_Cloudflare_IPv4-6/main/cloudflare-dns.yaml

Place the config file in the directory as the update-cloudflare-dns for above example at /usr/local/bin/

sudo mv cloudflare-dns.yaml /usr/local/bin/cloudflare-dns.yaml

Edit it with your favorite editor and set the necessary parameters.

domains:
  - name: example.com
    ip_type: external
    ipv4: true
    ipv6: true
    proxied: true
    ttl: auto

settings:
  cloudflare:
    - zone_id: #########
    - zone_api_token: ########
  misc:
    - create_if_no_exist: false

notifications:
  telegram:
    enabled: false
    bot_token: token
    chat_id: id

Multiple domains is supported:

domains:
  - name: example.com
    ip_type: external
    ipv4: true
    ipv6: true
    proxied: true
    ttl: auto
  - name: example2.com # Only name = using default settings
  - name: example3.com
    ip_type: external
    ipv4: true
    ipv6: true
    proxied: false
    ttl: auto
  - name: ..........
.........

When placed in /usr/local/bin/

cloudflare-dns dyndns-update

With your config file (need to be placed in same folder)

cloudflare-dns dyndns-update your_config.yaml

You can run the script via crontab

crontab -e

* * * * * /usr/local/bin/cloudflare-dns dyndns-update

* * * * * /usr/local/bin/cloudflare-dns dyndns-update myconfig.yaml

*/2 * * * * /usr/local/bin/cloudflare-dns dyndns-update

@reboot /usr/local/bin/cloudflare-dns dyndns-update

@reboot sleep 60 && /usr/local/bin/cloudflare-dns dyndns-update

This Script will create a log file with only the last run information Log file will be located at the script's location.

Example:

/usr/local/bin/cloudflare-dns.log

The bats framework is used to perform the unit tests. In addition, if you want to obtain the Code Coverage you use bashcov.

To run them locally:

1. Clone this repository and update the submodules:

   git clone https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6.git
   cd DynDNS_Cloudflare_IPv4-6
   git submodule update --init --recursive

2. Execute the tests:

   • Without code coverage:

     # Path: ../DynDNS_Cloudflare_IPv4-6/
     ./unit_test.sh

   • With code coverage:

     1. With Ruby 3 or higher, install the dependencies:

        # Path: ../DynDNS_Cloudflare_IPv4-6/
        gem install bundler
        export BUNDLE_GEMFILE=test/Gemfile
        bundle install

     2. Execute tests with code coverage:

        # Path: ../DynDNS_Cloudflare_IPv4-6/
        bashcov ./unit_test.sh

Here we describe how the Github CI workflows for unit testing and code coverage work.

%%{
  init: {
    "fontFamily": "monospace",
    "flowchart": {},
    "sequence": {}
  }
}%%

flowchart TD
subgraph WC[Workflow Caller]
    A(<b>Unit Test and Coverage</b>\n <i><small><a href='https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6/blob/main/.github/workflows/unit_tests_and_cov.yaml'>unit_tests_and_cov.yaml</a></small></i>)
end

subgraph WU[Reusable Workflow]

    E[<b>Ubuntu 22.04</b>\n<i><small><a href='https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6/blob/main/.github/workflows/codecov_ubuntu.yaml'>codecov_ubuntu.yaml</a></small></i>]

end

subgraph WD[Reusable Workflow]
    F[<b>Debian 11</b>\n<i><small><a href='https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6/blob/main/.github/workflows/codecov_debian.yaml'>codecov_debian.yaml</a></small></i>]
end

subgraph WM[Reusable Workflow]
    G[<b>macOS 13</b>\n<i><small><a href='https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6/blob/main/.github/workflows/codecov_macos.yaml'>codecov_macos.yaml</a></small></i>]
end

subgraph WRC[Reusable Workflow]
    H[<b>CentOS 9</b>\n<i><small><a href='https://github.com/jmrplens/DynDNS_Cloudflare_IPv4-6/blob/main/.github/workflows/codecov_centos.yaml'>codecov_centos.yaml</a></small></i>]
end

Co -.-> Ur[Upload report to:\n<small>- <a href='https://app.codecov.io/github/jmrplens/DynDNS_Cloudflare_IPv4-6/flags'>Codecov</a>\n- <a href='https://app.codacy.com/gh/jmrplens/DynDNS_Cloudflare_IPv4-6/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage'>Codacy</a></small> ]
WC --> WU
WC --> WD
WC --> WM
WC --> WRC

subgraph Rb[Install Ruby Version]
    Rbb{{<code>ruby-build X.Y.Z</code>}}
end
WU --> Rb
WD --> Rb
WM --> Rb
WRC --> Rb

Rb --> Sh
Rb --> Sh
Rb --> Sh
Rb --> Sh

subgraph Sh[Shell]
    Co[<code>bashcov ./unit-test.sh</code>]
end

To run the Github CI on MacOS, Debian and CentOS, self-hosted runners are used.

For Debian and CentOS operating systems it is necessary to manually install the Ruby versions that will run the tests. This is required:

1. Install self-hosted runner.

2. Install ruby-build. Follow the instructions in Install manually as a standalone program.

3. Assuming you have used the default work folder name _work , you must install the Ruby versions to be run in the runner into that folder:

   ruby-build X.Y.Z ACTION_RUNNER_PATH/_work/_tool/Ruby/X.Y.Z/x64

   Where X.Y.Z is the Ruby version you want to install (3.0.6, 3.1.4, ...).

   And mark it as completed with:

   touch /root/actions-runner/_work/_tool/Ruby/X.Y.Z/x64.complete

   Where X.Y.Z is the Ruby version you have installed (3.0.6, 3.1.4, ...).