DDNS

该介绍目前仅提供英文版本。

DDNS

DDNS 是一个自动更新域名解析到本机 IP 的工具，支持多种 DNS 服务商，包括 DNSPod、阿里 DNS、CloudFlare、华为云、DNSCOM 等。

核心功能

• 多 DNS 服务商支持：支持主流 DNS 服务商
• IPv4/IPv6 双栈支持：同时支持 IPv4 和 IPv6 地址更新
• 智能 IP 获取：支持多种 IP 获取方式
• 定时任务：自动定期检查并更新 IP
• 配置灵活：支持自定义配置和回调
• 跨平台：支持 Windows、Linux、Docker
• 简单易用：开箱即用，配置简单
• 安全可靠：支持 HTTPS 和代理
• 调试友好：提供详细的调试信息
• 开源免费：MIT 许可证

快速开始

1. 安装：

   # 克隆仓库
   git clone https://github.com/NewFuture/DDNS.git
   cd DDNS

2. 配置：

   # 首次运行会自动生成配置文件模板
   python run.py

3. 运行：

   # 使用默认配置文件
   python run.py
   # 或指定配置文件
   python run.py -c /path/to/config.json

配置说明

基本配置

{
  "id": "API_ID",
  "token": "API_TOKEN",
  "dns": "dnspod",
  "ipv4": ["example.com"],
  "ipv6": ["example.com"],
  "index4": "public",
  "index6": "public"
}

支持的 DNS 服务商

• DNSPOD (dnspod)
• DNSPOD 国际版 (dnspod_com)
• 阿里 DNS (alidns)
• CloudFlare (cloudflare)
• DNS.COM (dnscom)
• HE.net (he)
• 华为 DNS (huaweidns)
• 自定义回调 (callback)

IP 获取方式

• 网卡索引：数字 (0,1,2,3…)
• 默认 IP：“default”
• 公网 IP：“public”
• URL 获取：“url:http://ip.sb”
• 正则匹配：“regex:192.*”
• 命令执行：“cmd:ipconfig”
• Shell 命令：“shell:ifconfig”

定时任务

Windows

• 管理员运行 task.bat
• 或双击运行（当前用户）

Linux

# 使用 init.d 和 crontab
sudo ./task.sh

# 使用 systemd
sudo ./systemd.sh install

Docker

docker run -d \
  -v /path/to/config.json:/config.json \
  newfuture/ddns

常见问题

1. SSL 证书验证失败

   • Windows Server 需要手动添加证书信任
   • 使用 IE 浏览器访问对应 API 域名

2. 问题排查

   • 开启 debug 模式
   • 检查系统/网络环境
   • 查看 issues 是否有类似问题

技术支持

• 文档：ddns.newfuture.cc
• 问题反馈：GitHub Issues
• 讨论：GitHub Discussions

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

Made with ❤️ by NewFuture