Sign inSign up

deepbluethought/cloudflarespeedtestddns

By deepbluethought

ā€¢Updated 5 months ago

Intelligent DDNS updater that finds the fastest Cloudflare IP and updates DNS records automatically

Image
Networking
Security
1

945

deepbluethought/cloudflarespeedtestddns repository overview

ā Cloudflare SpeedTest DDNS

šŸš€ An intelligent DDNS update tool that automatically finds the fastest Cloudflare IP and updates your DNS records.

ā āœØ Key Features

  • šŸ§  Intelligent IP Pool Management - Tests all existing DNS records and selects the best N IPs
  • šŸ“Š Dynamic Threshold Calculation - Adapts search criteria based on current network conditions
  • šŸ”’ Safe DNS Updates - Zero-downtime updates with rollback protection
  • šŸ³ Full Docker Support - Works with both docker-compose and docker run
  • šŸ”¢ Multi-IP Load Balancing - Configure multiple A records for fault tolerance
  • ā° Flexible Scheduling - Customizable cron jobs for automated testing

ā šŸš€ Quick Start

ā Using Docker Compose (Recommended)
git clone https://github.com/DeepBlueThought/Cloudflare-SpeedTest-DDNS.git
cd Cloudflare-SpeedTest-DDNS
cp .env.example .env
# Edit .env with your Cloudflare credentials
docker compose up -d
ā Using Docker Run
docker run -d \
  --name cloudflare-ddns \
  --restart unless-stopped \
  -e zone_id="your_cloudflare_zone_id" \
  -e api_token="your_cloudflare_api_token" \
  -e host_name="testip.yourdomain.com" \
  -e host_ip_max=2 \
  -e speedtest_para="-n 1000 -dn 2 -sl 5 -tl 100" \
  -e cron="0 * * * *" \
  deepbluethought/cloudflarespeedtestddns:latest

ā šŸ“‹ Environment Variables

VariableRequiredDefaultDescription
zone_idYes-Cloudflare Zone ID
api_tokenYes-Cloudflare API Token (needs Zone.DNS edit permission)
host_nameYes-Domain to update (e.g., testip.example.com)
host_ip_maxNo2Number of IPs to maintain in DNS records
speedtest_paraYes-CloudflareSpeedTest parameters
cronYes-Cron expression for scheduling (e.g., "0 * * * *" for hourly)

ā šŸ”§ Configuration Example

.env file:

zone_id=your_zone_id_here
api_token=your_api_token_here
host_name=testip.yourdomain.com
host_ip_max=2
speedtest_para="-n 1000 -dn 2 -sl 5 -tl 100 -url https://download.example.com/largefile.bin"
cron=0 * * * *
ā Getting Cloudflare Credentials
  1. Zone ID: Login to Cloudflare ā†’ Select your domain ā†’ Zone ID in the right sidebar
  2. API Token: Cloudflare ā†’ My Profile ā†’ API Tokens ā†’ Create Token
    • Template: Edit zone DNS
    • Permissions: Zone.DNS (Edit)

ā šŸ“Š How It Works

  1. Baseline Testing - Tests all existing DNS record IPs
  2. Dynamic Thresholds - Uses worst-case performance as search criteria
  3. IP Discovery - Scans Cloudflare IP ranges for better performance
  4. Intelligent Selection - Chooses best N IPs from both old and new
  5. Safe Updates - Adds new records before removing old ones

ā šŸ“ Example Logs

[2026-02-09 12:00:00] [INFO] Testing 2 existing DNS record(s)...
[2026-02-09 12:00:10] [INFO] Existing IP 1.0.0.1: 45.23ms / 35.67MB/s
[2026-02-09 12:00:10] [INFO] Existing IP 1.0.0.2: 48.10ms / 32.10MB/s
[2026-02-09 12:00:10] [INFO] Search thresholds: Latency < 48ms, Speed > 32MB/s
[2026-02-09 12:00:10] [INFO] Searching for better IPs...
[2026-02-09 12:05:30] [INFO] New candidate IP: 1.0.0.3 (42.10ms / 38.21MB/s)
[2026-02-09 12:05:30] [SUCCESS] Selected top 2 IP(s) for DNS:
[2026-02-09 12:05:30] [INFO]   #1: 1.0.0.3 (42.10ms / 38.21MB/s) [NEW]
[2026-02-09 12:05:30] [INFO]   #2: 1.0.0.1 (45.23ms / 35.67MB/s) [KEEP]
[2026-02-09 12:05:31] [SUCCESS] DNS update completed

ā šŸ”— Links

ā šŸ“„ License

MIT License - See LICENSEā  for details

Powered by CloudflareSpeedTestā 

Tag summary

Content type

Image

Digest

sha256:2b0f16b0fā€¦

Size

13.5 MB

Last updated

5 months ago

docker pull deepbluethought/cloudflarespeedtestddns