parkerhemphill/godaddy-dns-updater

parkerhemphill/godaddy-dns-updater

镜像概述和主要用途

这是一个简单的Docker镜像，通过curl工具和shell脚本监控子域名或域名，当检测到主机外部IP变化时自动更新GoDaddy DNS记录。适用于动态IP环境下需要保持域名解析准确性的场景。

https://img.shields.io/docker/stars/parkerhemphill/godaddy-dns-updater](https://store.docker.com/community/images/parkerhemphill/godaddy-dns-updater) https://img.shields.io/docker/pulls/parkerhemphill/godaddy-dns-updater](https://store.docker.com/community/images/parkerhemphill/godaddy-dns-updater)

核心功能和特性

• 自动IP检测：通过https://api.ipify.org获取主机当前外部IP
• 定时检查：可配置检查间隔（默认15分钟），避免频繁API请求
• 智能更新：仅当检测到IP变化时才调用GoDaddy API更新DNS记录
• 日志记录：容器启动和DNS更新记录保存在/tmp/<DOMAIN_NAME>-log文件中
• 多架构支持：包含arm和arm64架构支持，Docker会自动拉取匹配架构的镜像
• 权限控制：支持通过PUID和PGID环境变量设置日志文件所有者

操作流程

1. 容器启动后，根据DNS_CHECK变量指定的秒数休眠（默认900秒/15分钟，未提供时使用默认值）
2. 休眠结束后，随机等待1-15秒（防止多容器同时运行导致API超时）
   • 通过curl调用https://api.ipify.org获取主机当前外部IP
   • 通过curl调用GoDaddy DNS API获取当前域名/子域名的DNS记录
   • 若获取的IP与当前外部IP不匹配，则通过curl POST请求更新DNS记录
3. 容器启动信息及所有DNS更新操作记录到容器内/tmp/<DOMAIN_NAME>-log文件，可通过卷映射使日志外部可访问

使用场景和适用范围

• 家庭网络或小型办公环境中使用动态IP的服务器
• 需要保持域名解析与动态IP同步的个人或小型企业服务
• 希望自动化维护GoDaddy域名DNS记录的场景

使用方法和配置说明

环境变量配置

Docker Compose示例

以下示例监控并更新cool-site.example.com，每600秒（10分钟）检查一次DNS变化：

• volumes可省略或映射到本地目录（左侧路径可修改为日志保存位置）
• TIME_ZONE需设置为有效的时区名称，可参考时区数据库列表中的"TZ database name"列

yaml
# docker-compose.yaml
version: "3"
services:
  godaddy-ddns:
    image: docker.xuanyuan.run/parkerhemphill/godaddy-dns-updater
    container_name: godaddy-ddns
    restart: unless-stopped
    environment:
      DOMAIN: 'example.com'
      SUB_DOMAIN: 'cool-site'
      API_KEY: 'GO_DADDY_DNS_API_KEY'  # 替换为实际的GoDaddy API密钥
      DNS_CHECK: 600
      TIME_ZONE: Asia/Shanghai  # 设置为所需时区
    volumes:
      - /path/to/local/logs:/tmp  # 本地日志目录映射

Docker Run示例

bash
docker run -d \
  --name=godaddy-dns-updater \
  -e TIME_ZONE=Asia/Shanghai \
  -e DOMAIN=example.com \
  -e SUB_DOMAIN=cool-site \
  -e API_KEY='GO_DADDY_DNS_API_KEY' \  # 替换为实际的GoDaddy API密钥
  -e DNS_CHECK=600 \
  -v /path/to/local/logs:/tmp \  # 本地日志目录映射
  --restart unless-stopped \
  parkerhemphill/godaddy-dns-updater:latest

支持与故障排除

容器操作

• 运行中容器Shell访问：

  bash
  docker exec -it godaddy-dns-updater /bin/bash
  

• 查看DNS更新日志：

  bash
  docker exec -it godaddy-dns-updater cat /tmp/*-log
  

• 查看容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' godaddy-dns-updater
  

• 查看镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' parkerhemphill/godaddy-dns-updater
  

故障排除提示

• 若容器启动后立即退出，检查是否正确设置了DOMAIN和API_KEY环境变量
• 日志文件是排查问题的主要依据，建议映射/tmp目录到本地以便查看
• 确认GoDaddy API密钥具有DNS记录管理权限