Skip to content

同时支持IPv4与IPv6!利用各DNS提供商的API(现已支持阿里云的OpenAPI),在具有公网IP的前提下,实现动态修改域名解析的功能,脱离花生壳的昂贵服务,将自己的域名解析为自家的IP地址。

License

Notifications You must be signed in to change notification settings

pboymt/ddns-at-home

Repository files navigation

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" // 每封五的背书分钟执行一次任务(默认配置)
    }
}

hourminute 字段语法规则类似于 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 @alicloud/pop-core
cloudflare 用于请求Cloudflare API cloudflare
@kocal/logger 格式化日志输出 @kocal/logger
ajv 用于验证JSON Schema ajv
axios 探测IP地址 axios
date-fns 格式化日志时间 date-fns
timexe 执行定时任务 timexe

开发依赖

包名 使用版本
@types/node @types/node
@types/cloudflare @types/cloudflare
@typescript-eslint/eslint-plugin @typescript-eslint/eslint-plugin
@typescript-eslint/parser @typescript-eslint/parser
cross-env cross-env
eslint eslint
markdown-table markdown-table
typescript typescript

开源协议

本项目随便就用了 LGPLv3 协议。

About

同时支持IPv4与IPv6!利用各DNS提供商的API(现已支持阿里云的OpenAPI),在具有公网IP的前提下,实现动态修改域名解析的功能,脱离花生壳的昂贵服务,将自己的域名解析为自家的IP地址。

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published