Skip to content

About

动态IP地址的域名服务器分配服务

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DynamicDNS

动态 IPv6 地址的域名服务器自动分配脚本

项目结构

文件 说明
src/ddns-v6.conf 配置:密钥、请求模板、缓存/日志路径、IPv6 来源
src/ddns-v6-simp.sh 推荐使用。配合 cron 的极简脚本。
src/ddns-v6-autoupdate.sh 备用。流程相同,额外带并发锁等开关

快速开始

  1. 编辑 src/ddns-v6.conf
    • API_KEY:供应商访问密钥
    • REQUEST_PROMPT:更新 AAAA 记录的请求模板,{{NEW_IP}} 是占位符
    • IP_SOURCE / INTERFACE / EXTERNAL_SERVICES:从哪儿取本机公网 IPv6
    • CACHE_FILE / LOG_FILE:缓存与日志路径
  2. 测试运行
    chmod +x src/ddns-v6-simp.sh
    src/ddns-v6-simp.sh --dry-run --verbose   # 只打印,不改 DNS / 不写缓存
    src/ddns-v6-simp.sh --force -v            # 真正更新一次
  3. 使用 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 作为门控时间戳。
  • 日志里的密钥会打成 ****。

About

动态IP地址的域名服务器分配服务

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages