DDNS@Home 动态更改DNS解析记录（原aliyun-ddns）

GitHub

新版本亮点

1.2.0

优化代码
接入 Cloudflare 服务，但不支持直接添加 Zone

1.1.0

代码重构，更易阅读
将阿里云服务从单页代码中独立，方便 接入其他服务
配置文件规则优化（版本为2），可以配置 多服务、多域名、多记录
不再提供 crontab 配置，请使用 PM2 守护进程配置或自行配置 systemd 等系统工具。

已移除V1版本支持

本项目利用各大 DNS 服务提供商（例如：阿里云云解析 DNS）的 API，在具有公网 IP 的前提下，实现动态修改域名解析的功能，脱离花生壳的昂贵服务，将自己的域名解析为自家的 IP 地址。

代码请求

由于作者还未使用过其他提供商的 DNS，所以本项目暂时仅支持阿里云的 DNS 服务。欢迎提供其他提供商的兼容代码。

本项目同时支持IPv4与IPv6。

服务征集

由于 test-ipv6.com 等服务的 IP 探测服务存在一定的不稳定性，欢迎大家提供同时包含IPv4和IPv6的免费探测服务。未来将会增加配置 IP 探测链接。

本项目使用 TypeScript 编写，确保稳定运行。

本工具可以使用三种模式部署：

PM2：推荐，适用于非 Windows 系统，配置简洁
~~Crontab~~：不再支持
Systemd：适用于 Linux 大部分发行版，项目内未实现相关配置，欢迎贡献代码。
Service：适用于 Windows 系统，使用 node-windows 模块设置相关服务，项目内未实现相关配置，欢迎贡献代码。
Docker：适用于所有能够运行 Docker 的操作系统，项目内未实现相关配置，欢迎贡献代码。

注意事项

本服务需要域名已设置好需要使用的服务商托管，并且准备好使用账号的 API Key 与 API Secret / API Token 等相关内容。
如果 DNS 列表不存在配置中的域名，工具可能将会使用 API 进行添加，具体行为视服务有所区别：
- 在阿里云服务下，请确保域名属于对应账号所有。
- 在 Cloudflare 服务下，将不会自动添加域名，请自行对 Zone 进行添加。
IPv4网络下，如果您家中有路由器，请将您的路由器设置 DMZ主机 到使用本工具的设备（比如路由器 IP 为 192.168.31.1，设备 IP 为 192.168.31.10，那就把路由器中的 DMZ主机 设置为 192.168.31.10），以确保设置DNS后能够正常使用公网 IPv4 访问该设备。
如果要将 IP 地址设置为客户端所在的公网 IP 地址, 要确保客户端被当地运营商分配的不是内网 IP（即使用万网查询 IP 地址时会出现两个 IP 地址，其中一个是 NAT 的 IP 地址，此时您自身的 IP 不是公网 IP）。如果是内网的 IPv4 地址, 可以给客服打电话要求更换为公网 IPv4 地址（长城宽带等二次转售宽带就别想了）。
大多数设备在国内环境都是可以获取公网 IPv6 地址的。如果您家中网络结构是“光猫（路由模式，大多数运营商默认）-路由器-设备”，请将路由器（以小米路由器为例）设置为有线中继模式，由路由模式的光猫进行 DHCPv6 分配；或者联系运营商服务支持，将光猫由路由模式改为桥接模式，使用路由器进行拨号及 DHCPv6 分配，此方法已经在北京联通、北京电信成功验证。

如果获取不到公网 IPv4 地址，禁用 IPv4 配置只使用 IPv6 同样可行。

使用方法

不再支持V1配置

使用前请务必阅读注意事项

请确保您已经安装了 Node.js 16.x（较早版本并未测试不过理论上 Node.js 8.x 及以上版本均支持）并且能够运行 npm。您可以通过以下代码在命令行测试：

$ node -v # v16.13.0
$ npm -v # 8.1.3

（建议）全局安装 TypeScript：

# 推荐
$ yarn global add typescript
# 或
$ npm install -g typescript

将项目 git clone 到目录：

$ git clone https://github.com/pboymt/ddns-at-home.git
# 国内用户请配置好代理/Hosts/可靠性高的DNS服务，或者直接使用码云Gitee的镜像
$ git clone https://gitee.com/pboymt/ddns-at-home.git

切换到目录：

$ cd ddns-at-home

安装依赖：

# 本项目不再推荐使用yarn，因为没测试过
$ npm install

编译代码：

$ npx tsc # 如果没有报错就是编译成功

复制配置样板，修改设置，配置模式文件请查看 settings.schema.json ：

强烈使用 VSCode 等编辑器支持 JSON Schema 验证的编辑器编辑配置文件。

$ cp settings.sample.json settings.json
$ nano settings.json # 请完全遵照schema设定的规则进行配置

如果配置无效会在运行的第一时间抛出错误。

安装完毕后可以运行一次进行测试：

$ npm start

如果您使用了计划任务，建议等待第一次计划任务执行成功后结束测试。

版本更新

您只需要重新拉取后再次执行安装依赖和编译代码流程即可，如果您配置了守护进程，请重启它们（PM2会默认监控编译生成的lib目录变化自动重启）。

守护进程配置

版本 1.1.0 后，由于内置定时执行 DDNS 功能，Crontab 配置暂被删去，您可以自行配置，但请务必注意配置文件需要移除 schedule 字段以禁用定时执行功能！

如果您在 V2 配置文件中配置了计划任务，那么可以使用提供的 PM2 配置文件，甚至自行设置 Systemd 将本工具设置为服务或者。

PM2

PM2 对 Windows 的支持存在一些问题，具体请参考，建议在非 Windows 系统上使用。

本工具提供了 ecosystem.config.js 作为PM2的环境配置。

您可以全局安装pm2：

$ npm install -g pm2

配置文件需要配置 schedule 字段：

由于诸多服务的 API 存在防滥用机制，因此本工具的计划任务只支持到分钟级，如果您愿意作死可以直接修改源代码添加秒级甚至微秒级计划任务。

{
    ...
    "schedule": {
        "immediate": true, // 是否立即执行一次任务
        "hour": "*", // 每小时均可执行
        "minute": "/5" // 每封五的背书分钟执行一次任务（默认配置）
    }
}

hour 和 minute 字段语法规则类似于 Cron，详细语法可在 Timexe 文档查看：

当为 * 时，每小小时/分钟执行一次

当为 n 时，每逢 n 时/分时可执行，最终决定权在 minute 字段

当为 /n 时，每逢 n 的倍数时/分执行一次

然后使用 pm2 运行本工具：

# 输出更多日志
$ pm2 start ecosystem.config.js # 可不写 ecosystem.config.js，pm2 会默认搜寻目录中的配置。
# 或（输出更少日志）
$ pm2 start ecosystem.config.js --env production

可使用命令查看监控：

$ pm2 monit

停止守护进程：

$ pm2 stop

保存守护进程（防止 pm2 重启丢失配置）：

$ pm2 save

配置 PM2 自启动：

注意： 可能需要管理员权限或root权限，在Linux下，root权限执行的pm2和普通用户权限执行的pm2配置不在同一目录，如果您使用的是 sudo pm2 startup ，那么请使用 sudo pm2 start 运行守护进程，并且把普通权限运行的守护进程删除，防止重复多次运行。

$ pm2 startup

Systemd

探寻中 WIP

Docker

探寻中 WIP

本项目使用的模块

依赖

包名	用途	使用版本
@alicloud/pop-core	用于请求阿里云OpenAPI
cloudflare	用于请求Cloudflare API
@kocal/logger	格式化日志输出
ajv	用于验证JSON Schema
axios	探测IP地址
date-fns	格式化日志时间
timexe	执行定时任务