自动更新 DNS 解析工具：DDNS

如果你需要自动将域名解析到本机的 IP 地址，支持 IPv4 和 IPv6，并且希望能够在内网和公网 IP 之间切换，那么你可以考虑使用 DDNS 这个工具。DDNS 具有许多强大的功能，包括代理模式和自动创建域名记录，同时支持多个域名和多级域名解析。

项目概述

DDNS 是一个自动更新 DNS 解析的工具，它可以帮助你将域名解析到你的本机 IP 地址。无论是内网 IP 还是公网 IP，IPv4 还是 IPv6，DDNS 都能轻松应对。此外，DDNS 还支持代理模式，多个域名的管理，自动创建新记录等多种功能。

主要特性

DDNS 具有以下主要特性：

1. 兼容和跨平台

可以以可执行文件的形式使用，无需安装 Python 环境。
跨平台支持，可以在 Windows、Linux 和 macOS 上运行。
支持 Python 2 和 Python 3。
可以通过 pip 安装。
提供 Docker 镜像支持。

2. 域名支持

支持多个域名解析。
支持多级域名解析。
可以自动创建新的域名记录。

3. IP 类型

支持内网 IPv4 和 IPv6。
支持公网 IPv4 和 IPv6，并且支持自定义 API。
支持自定义命令和正则表达式选取。

4. 网络代理

支持 HTTP 代理。
可以配置多个代理并自动切换。

5. 服务商支持

支持多个 DNS 服务提供商，包括 DNSPOD、阿里 DNS、DNS.COM、CloudFlare、HE.net 和华为云。

6. 其他功能

可以设置定时任务，定期更新 DNS 解析。
支持 TTL 配置。
可以使用本地文件缓存，减少 API 请求次数。
当 IP 地址发生变化时，可以触发自定义回调 API。

如何使用

安装

你可以根据需要选择以下一种方式来安装 DDNS：

使用 pip 安装（需要 pip 或 easy_install）：

pip install ddns

使用二进制版（单文件，无需 Python 环境），根据你的操作系统选择下载：
- Windows ddns.exe
- Linux ddns（仅经过 Ubuntu 测试）
- macOS ddns-osx
使用源码运行（需要 Python 环境）：
1. 克隆或下载此仓库并解压。
2. 运行 ./run.py（在 Windows 上双击 run.bat 或运行 python run.py）。

使用 Docker（需要安装 Docker）：

使用环境变量或配置文件启动 Docker 容器。以下是两种方式的示例：

使用环境变量：

docker run -d \
  -e DDNS_DNS=dnspod \
  -e DDNS_ID=12345 \
  -e DDNS_TOKEN=mytokenkey \
  -e DDNS_IPV4=ddns.newfuture.cc \
  -e DDNS_IPV6=ddns.newfuture.cc \
  --network host \
  newfuture/ddns

使用配置文件：

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

快速配置

申请 API Token 并将其填写到对应的 id 和 token 字段中。具体的申请步骤取决于你选择的 DNS 服务提供商。以下是一些常见的 DNS 服务商的申请链接：
- DNSPOD 国内版创建 Token
- 阿里云 AccessKey
- DNS.COM API Key/Secret
- DNSPOD 国际版
- CloudFlare API Key（可以使用邮箱 + API KEY 或 Token）
- HE.net DDNS 文档（只需将设置的密码填入 token 字段，id 字段可留空）
- 华为云 APIKEY 申请（选择左侧的访问密钥，然后点击新增访问密钥）
修改配置文件，设置 ipv4 和 ipv6 字段，将待更新的域名添加到列表中。具体的配置方式可以参考配置说明。

详细配置

DDNS 支持多种配置方式，包括命令行参数、JSON 配置文件和环境变量。以下是配置参数的详细说明：

id（必须）：API 访问 ID，根据你的 DNS 服务提供商申请获得。
token（必须）：API 授权 token，根据你的 DNS 服务提供商申请获得。注意：不要将此字段泄露。
dns：DNS 服务商的名称，可选值包括 "dnspod"、`

"dnspod_com"、"alidns"、"dnscom"、"cloudflare"、"he"、"huaweidns" 和 "callback"`。

ipv4：IPv4 域名列表，可以添加多个域名。
ipv6：IPv6 域名列表，可以添加多个域名。
index4：IPv4 获取方式，可选值包括 "0"、"1"、"2"、"3"、"default"、"public"、"url:xxx"、"regex:xxx"、"cmd:xxx" 和 "shell:xxx"。
index6：IPv6 获取方式，可选值包括 "0"、"1"、"2"、"3"、"default"、"public"、"url:xxx"、"regex:xxx"、"cmd:xxx" 和 "shell:xxx"。
ttl：DNS 解析 TTL 时间，可以设置为一个数字，不设置则采用 DNS 默认策略。
proxy：HTTP 代理地址，可以配置多个代理，使用分号 ; 分隔。例如，"127.0.0.1:1080;DIRECT"。
debug：是否开启调试模式，可以设置为 true 或 false。
cache：是否启用本地文件缓存，可以设置为 true 或 false，默认为 true。你也可以指定一个具体的缓存文件位置。

index4 和 index6 参数说明

数字（0、1、2、3 等）：表示第 i 个网卡的 IP 地址。
字符串 "default"（或者无此项）：表示系统访问外网的默认 IP。
字符串 "public"：表示使用公网 IP（使用公网 API 查询，URL 的简化模式）。
字符串 "url:xxx"：打开 URL xxx（例如，"url:http://ip.sb"），从返回的数据中提取 IP 地址。
字符串 "regex:xxx"：使用正则表达式提取 IP 地址（例如，"regex:192.*"）。
字符串 "cmd:xxx"：执行命令 xxx 并将其标准输出作为目标 IP。
字符串 "shell:xxx"：在系统 shell 中运行命令 xxx 并将其标准输出作为目标 IP。
false：强制禁止更新 IPv4 或 IPv6 的 DNS 解析。
列表：按顺序执行列表中的 index 规则，并将首次获得的结果作为目标 IP。

自定义回调配置说明

如果你需要在 IP 地址发生变化时触发自定义回调 API，可以配置以下参数：

id 字段填写回调地址，以 HTTP 或 HTTPS 开头。推荐使用 HTTPS 方式的回调 API。当 token 字段非空并且 URL 参数包含常量字符串时，这些常量会被替换为实际值。
token 字段为 POST 参数，如果为空或不存在，则使用 GET 方式发起回调。回调参数采用 JSON 格式编码。当 JSON 的首层参数值包含常量字符串时，这些常量会被程序替换为实际值。

以下是常量名称及其对应的常量内容：

__DOMAIN__：DDNS 域名。
__RECORDTYPE__：DDNS 记录类型。
__TTL__：DDNS TTL 时间。
__TIMESTAMP__：请求发起时间戳（包含小数部分）。
__IP__：获取的对应类型的 IP 地址。

配置示例

{
  "$schema": "https://ddns.newfuture.cc/schema/v2.8.json",
  "id": "12345",
  "token": "mytokenkey",
  "dns": "dnspod",
  "ipv4": ["ddns.newfuture.cc", "ipv4.ddns.newfuture.cc"],
  "ipv6": ["ddns.newfuture.cc", "ipv6.ddns.newfuture.cc"],
  "index4": 0,
  "index6": "public",
  "ttl": 600,
  "proxy": "127.0.0.1:1080;DIRECT",
  "debug": false
}

定时任务

你可以通过脚本设置定时任务，使 DDNS 定期检查 IP 并自动更新。默认情况下，DDNS 每隔 5 分钟执行一次定时任务。以下是不同操作系统下的设置方式：

Windows

推荐以系统管理员身份运行 task.bat（右键点击并选择“以管理员身份运行”）。
以当前用户身份运行定时任务，双击或运行 task.bat（请注意，运行时可能会弹出黑色命令行窗口）。

Linux

使用 init.d 和 crontab：
```
sudo ./task.sh
```
使用 systemd：
- 安装服务：
```
sudo ./systemd.sh install
```
- 卸载服务：
```
sudo ./systemd.sh uninstall
```
该脚本安装的文件符合 Filesystem Hierarchy Standard (FHS) 标准，可执行文件位于 /usr/share/DDNS 目录下，配置文件位于 /etc/DDNS 目录下。

Docker

Docker 镜像已默认启用每 5 分钟执行一次的定时任务，无需额外参数。

常见问题

Windows Server [SSL: CERTIFICATE_VERIFY_FAILED]

如果在 Windows Server 上遇到此错误，请注意 Windows Server 默认的安全策略会禁止信任未添加的 SSL 证书。你可以使用系统自带的 Internet Explorer 浏览器访问一次对应的 API 地址以解决此问题：

阿里云 DNS：打开 https://alidns.aliyuncs.com
Cloudflare：打开 https://api.cloudflare.com
DNS.COM：打开 https://www.dns.com
DNSPOD（国内版）：打开 https://dnsapi.cn
DNSPOD 国际版：打开 https://api.dnspod.com
华为 DNS：打开 https://dns.myhuaweicloud.com

问题排查和反馈

如果遇到问题，可以按照以下步骤进行排查和反馈：

首先，确认问题是否由系统或网络环境引起。
在 GitHub Issues 中搜索是否有类似的问题。
如果无法解决或者确定是 bug，请新建一个 Issue 并提供以下信息：
- 版本和运行方式。
- 操作系统环境。
- 出错日志（去掉 id 和 token 的配置文件内容）。
- 如果是源码运行，请提供使用的 Python 环境信息。

以上就是 DDNS 的详细配置和使用说明，希望能够帮助你顺利使用该工具管理 DNS 解析。如果你有更多问题或需要进一步的帮助，请随时联系开发者或在 GitHub 上提出问题。祝你使用愉快！

本文由作者王大神原创发布于大神网的AI博客。

转载请注明作者：王大神

原文出处：自动更新 DNS 解析工具：DDNS