动态 IPv6 地址的域名服务器自动分配脚本
| 文件 | 说明 |
|---|---|
src/ddns-v6.conf |
配置:密钥、请求模板、缓存/日志路径、IPv6 来源 |
src/ddns-v6-simp.sh |
推荐使用。配合 cron 的极简脚本。 |
src/ddns-v6-autoupdate.sh |
备用。流程相同,额外带并发锁等开关 |
- 编辑
src/ddns-v6.confAPI_KEY:供应商访问密钥REQUEST_PROMPT:更新 AAAA 记录的请求模板,{{NEW_IP}}是占位符IP_SOURCE/INTERFACE/EXTERNAL_SERVICES:从哪儿取本机公网 IPv6CACHE_FILE/LOG_FILE:缓存与日志路径
- 测试运行
chmod +x src/ddns-v6-simp.sh src/ddns-v6-simp.sh --dry-run --verbose # 只打印,不改 DNS / 不写缓存 src/ddns-v6-simp.sh --force -v # 真正更新一次
- 使用 cron 每 5 分钟唤醒一次。脚本内部有控制,未到检查时间立刻退出
*/5 * * * * /path/to/src/ddns-v6-simp.sh
我们注意到 ip -a addr 命令返回的 ipv6 地址会包含 preferred_lft 和 valid_lft 两个字段,分别表示当前地址的建议更换时间和有效时间。于是通过这一点,我们可以减少不必的轮询,降低消耗。
于是,通过脚本内的“门控”逻辑,不到设定的时间,则不实际执行业务逻辑。
门控判断 -(时间到)→ 采集本机公网 IPv6 → 与缓存比对 -(有变化)→ 按 REQUEST_PROMPT 更新 AAAA 记录 → 写缓存并按 preferred_lft 排下一次检查时间
| 变量 | 默认 | 说明 |
|---|---|---|
CURL_TIMEOUT |
30 | 单次 API 请求超时(秒) |
MIN_INTERVAL |
300 | 两次检查的最小间隔(秒) |
MAX_INTERVAL |
43200 | 稳定期最长静默间隔(秒),同时是地址变化的发现延迟上限 |
SAFETY_MARGIN |
60 | 在 preferred_lft 归零前提前多少秒唤醒 |
UNKNOWN_INTERVAL |
600 | 读不到 preferred_lft(如 external 模式)时的间隔(秒) |
-f/--force 忽略门控与缓存比对强制更新 · -n/--dry-run 只打印请求不调用 API · -v/--verbose 输出细节日志 · -h/--help 帮助
- 脚本只取
scope global地址,不采用末尾为/128的地址、ULA(fc00::/7)、temporary、deprecated地址;若机器只有/128的地址,会一直提示“获取到有效 IPv6 地址”。 - 更新失败时不写缓存,cron 下次唤醒后自动重试;成功后写入
${CACHE_FILE}.state作为门控时间戳。 - 日志里的密钥会打成
****。