cf-ddns

cf-ddns 是「按运营商线路优选 Cloudflare 节点 + 智能 DNS 更新」工具：纯 Go 标准库实现，零依赖，编译后是单文件二进制，开箱即用。

背景：Cloudflare anycast IP 在国内不同运营商下的质量差异很大——对移动最快的 IP，对电信可能很慢。常见做法是定期测速、更换 IP，但一条 DNS 记录只能有一个值，无法同时满足三家运营商。

做法：cf-ddns 为每条运营商线路（默认 / 移动 / 联通 / 电信）分别优选节点，再借助 DNSPod 的线路解析能力，把同一个域名写成不同线路的解析记录。移动 / 联通 / 电信用户访问同一个域名，各自解析到自己线路最快的节点。

每轮循环对所有线路执行以下 6 步；所有线路处理完毕后休眠 interval（默认 10 分钟）再开始下一轮。单条线路失败不影响其它线路。

每种策略下，本机测速都只是「存活过滤」；区别在于从存活的候选中按什么顺序取第一名。

配置文件为 JSON，必须使用 UTF-8 编码（线路名是中文）。下面按「通用字段 / lines 元素 / 服务商专属」三组说明。

通用字段

lines 元素

服务商专属

JSON 示例（dnspod 分线路模式）

{
  "provider": "dnspod",
  "record": "cf.example.com",
  "ttl": 600,
  "interval": "10m",
  "task": 50,
  "colo": "HKG,NRT",
  "ipv6": true,
  "dry_run": false,
  "secret_id": "AKID…",
  "secret_key": "…",
  "domain": "example.com",
  "lines": [
    { "line": "默认", "ips_url": "https://github.com/DustinWin/BestCF/releases/download/bestcf/bestcf-ip.txt", "pick": "order" },
    { "line": "移动", "ips_url": "https://github.com/DustinWin/BestCF/releases/download/bestcf/cmcc-ip.txt", "pick": "order", "colo": "HKG,NRT" },
    { "line": "联通", "ips_url": "https://github.com/DustinWin/BestCF/releases/download/bestcf/cucc-ip.txt", "pick": "latency" },
    { "line": "电信", "ips_url": "https://github.com/DustinWin/BestCF/releases/download/bestcf/ctcc-ip.txt", "pick": "order" }
  ]
}

候选列表地址表

1. 1

   准备域名：托管到 DNSPod

   Cloudflare DNS 没有运营商线路维度，承载优选记录的域名需托管到 DNSPod（免费套餐即可）。两种方案任选其一：

   • 方案 A · 整域托管：把域名的 NS 记录改为 DNSPod 提供的 f1g1ns1.dnspod.net，整域迁入 DNSPod。
   • 方案 B · 子域名委派：域名保留在 Cloudflare，为承载优选记录的子域名（如 cf.example.com）添加 NS 记录，指向 DNSPod。

   验证：nslookup -type=NS 你的域名，确认返回 DNSPod 的 NS 记录。

2. 2

   获取腾讯云密钥

   腾讯云控制台 → 访问管理 → API 密钥管理，创建密钥。建议使用子账号并仅授权 QcloudDNSPodFullAccess，避免主账号密钥泄露造成过大影响。

3. 3

   写配置

   复制示例配置并按需修改。配置文件必须为 UTF-8 编码——线路名是中文，切勿用 GBK / ANSI 保存。

   bash初始化配置

   cp config.example.json config.json
   # 编辑 config.json，填入 record / secret_id / secret_key / domain / lines

4. 4

   构建并试运行

   先编译，再用 -dry-run 观察输出；确认无误后正式运行。

   bash构建与试运行

   go build -o cf-ddns .
   ./cf-ddns -config config.json -dry-run   # 仅测速，不写 DNS
   ./cf-ddns -config config.json            # 正式运行

5. 5

   命令行参数

   参数	说明
   -config	配置文件路径
   -cf-token	Cloudflare API Token
   -zone-id	Cloudflare Zone ID
   -record	完整记录名
   -proxied	是否开启代理（小黄云）
   -ttl	TTL
   -interval	循环间隔（Go duration，如 "10m"）
   -ips-url	候选列表地址
   -colo	数据中心过滤（逗号分隔）
   -task	并发测速协程数
   -ipv6	启用 IPv6 优选
   -dry-run	仅测速，不写 DNS

   其中 -dry-run 与 -ipv6 在显式传入时会覆盖配置文件中的对应值。

1. 1

   交叉编译

   在本机交叉编译出 Linux amd64 二进制（也可直接换成目标机器的架构）。

   bash交叉编译

   GOOS=linux GOARCH=amd64 go build -o cf-ddns .

2. 2

   传输与安装

   配置里包含密钥，务必通过 scp / sftp 等加密通道传输。二进制放 /usr/local/bin，配置放 /etc/cf-ddns/config.json 并设为 600。

   bash传输与安装

   scp cf-ddns config.json user@server:/tmp/
   sudo install -m 0755 /tmp/cf-ddns /usr/local/bin/cf-ddns
   sudo mkdir -p /etc/cf-ddns
   sudo install -m 600 /tmp/config.json /etc/cf-ddns/config.json

3. 3

   创建 systemd unit

   ini/etc/systemd/system/cf-ddns.service

   [Unit]
   Description=cf-ddns Cloudflare 优选 IP 动态 DNS
   After=network-online.target
   Wants=network-online.target
   
   [Service]
   Type=simple
   ExecStart=/usr/local/bin/cf-ddns -config /etc/cf-ddns/config.json
   Restart=always
   RestartSec=10
   ProtectSystem=strict
   ProtectHome=read-only
   NoNewPrivileges=true
   PrivateTmp=true
   
   [Install]
   WantedBy=multi-user.target

4. 4

   注册并启动

   bash启用与查看日志

   sudo cp cf-ddns.service /etc/systemd/system/
   sudo systemctl daemon-reload
   sudo systemctl enable --now cf-ddns
   journalctl -u cf-ddns -f

1. 1

   在线多点测试

   在 itdog.cn/dns 输入域名做多点 DNS 解析，三网（移动 / 联通 / 电信）的差异一目了然。

2. 2

   本机解析

   在服务器或本机执行 nslookup cf.example.com，应返回当前宽带运营商线路的解析结果。

provider=cloudflare 是「单记录模式」：不需要分线路时的旧版行为，旧配置无需任何修改即可继续使用。要点：

• 仅允许 默认 线路，不维护运营商多线路。
• TTL 默认 60。
• Token 需 Zone→DNS→Edit 权限；Zone ID 在域名 Overview 页右下角。
• 直连优选场景下 proxied 应为 false。

{
  "provider": "cloudflare",
  "record": "cf.example.com",
  "ttl": 60,
  "cf_token": "…",
  "zone_id": "…",
  "proxied": false
}