定时获取优选 IP，自动更新 Cloudflare 或 DNSPod 的域名解析。通过网页管理 DNS 目标、同步周期和执行记录，无需 GitHub Actions。
本项目不测速，只读取第三方 IP 接口。仅更新已有的 IPv4（A）记录，不创建或删除解析记录。
- 多目标同步：支持 Cloudflare、腾讯云 DNSPod，可配置多个域名和账户。
- 切换 IP 来源：支持
ip.164746.xyz和ip.v2too.top。 - 先预览再启用：查看计划修改的记录，确认后开启定时同步。
- 查看执行结果：记录每轮同步结果，更新后重新查询 DNS 服务商核对。
- 独立周期：分别设置 IP 获取和 DNS 同步间隔，互不绑定。
- 网页管理：维护凭据、修改管理员密码。
需要安装 Git、Docker 和 Docker Compose v2 或以上版本。以下命令在部署机器上执行；首次构建需要联网下载镜像和依赖，不必另装 Python 或 Node.js。
git clone https://github.com/hicocos/cfspeed.git
cd cfspeed
cp config.docker.example.toml config.docker.toml
cp .env.example .env
chmod 600 .env
docker compose up -d --build --wait --wait-timeout 120首次部署无需填写 DNS 凭据，稍后在网页中添加。IP 获取和 DNS 同步默认各每 6 小时运行，启动先获取再同步；初始为预览模式，不修改 DNS。旧配置未设置 source_interval_seconds 时继承原 interval_seconds。
如果启动失败，运行 docker compose logs --tail=100 cfspeed 查看原因。上面的复制命令仅用于首次安装，不要覆盖已有配置。
默认端口为 8788（仅本机访问），管理入口为 /admin/login。
在部署机器的 cfspeed 目录执行：
docker compose exec -T cfspeed python -c "from pathlib import Path; print(Path('/data/initial-admin-password.txt').read_text().strip())"用户名为 admin，密码为命令输出。登录后进入「账户安全」修改密码。初始密码不会出现在日志中，改密后初始密码文件会被删除。
先在 DNS 服务商控制台创建需要同步的 A 记录，再进入「DNS 目标 → 添加目标」。
Cloudflare
- 区域 ID：域名对应的 Zone ID。
- 解析名称：完整域名，例如
cf.example.com。 - API Token：仅授权目标域名的 DNS 编辑权限；不支持 Global API Key。
DNSPod（腾讯云）
- 所属域名：例如
example.com。 - 解析名称：例如
cf；根域名填写@。 - 线路 ID：默认线路为
0，其他线路填写对应 ID。 - 凭据：腾讯云
SecretId和SecretKey，需具备查询和修改目标域名记录的权限。
凭据可直接在网页填写，无需修改 .env。多账户使用不同的凭据变量名，避免覆盖其他目标的凭据。
- 在「服务设置」选择 IP 来源，分别设置 IP 获取间隔和 DNS 同步间隔，保持预览模式并保存。
- 在「总览与统计」点击「立即预览」。
- 在「同步记录」查看详情，确认域名、现有 IP 和目标 IP 正确。
- 回到「服务设置」，将运行模式改为「正式同步」，保存并按提示输入
启用同步确认。
启用后将按周期更新 DNS；正式模式下重启服务也会执行同步。修改 DNS 目标或切换 IP 来源会回到预览模式，需要重新确认启用。请先停用操作相同记录的其他定时任务，避免重复修改。
在项目目录执行。更新前备份数据；不要重新复制示例配置。
# 更新源码并重新构建
git pull --ff-only
docker compose up -d --build --wait --wait-timeout 120
# 查看状态
docker compose ps
# 停止服务，保留数据
docker compose down配置、凭据和历史记录保存在 Docker 数据卷中，默认卷名为 cfspeed_cfspeed-data。不要使用 docker compose down -v，它会删除数据。 备份时需保留加密密钥，详见 安全与备份。
项目源自 ZhiXuanWang/cf-speed-dns，前端复用信息见 来源说明。
本仓库尚未声明开源许可证；公开可见不代表授予任意复用或再分发许可。