ddns-route53 Docker镜像文档

镜像概述和主要用途

ddns-route53是一个基于时间调度的Amazon Route 53动态DNS（Dynamic DNS）工具，通过Docker容器化部署，可定时检测公网IP地址变化，并自动更新Amazon Route 53 DNS记录，确保域名始终指向当前有效的公网IP。

核心功能和特性

• 动态IP检测：支持通过公网IP检测服务（如icanhazip.com、ifconfig.me等）自动获取当前公网IP。
• Route 53自动更新：当检测到IP变化时，自动调用Amazon Route 53 API更新指定DNS记录。
• 时间调度机制：支持自定义检测间隔（如每5分钟、每小时），基于时间规则触发IP检测和更新流程。
• 多记录支持：可同时管理多个Route 53 DNS记录（如A记录、AAAA记录）。
• AWS认证集成：支持通过AWS访问密钥（Access Key）和密钥（Secret Key）或IAM角色进行Route 53 API认证。
• 配置灵活性：支持通过环境变量或配置文件定义DNS记录参数（如TTL、记录类型、区域ID等）。
• 日志与监控：提供详细操作日志，便于排查更新失败原因。

使用场景和适用范围

适用场景

• 家庭网络或小型服务器：公网IP频繁变化时（如宽带拨号、动态IP分配），自动同步DNS记录，避免手动更新。
• 边缘计算节点：分布在不同网络环境的边缘设备，需通过域名访问，确保IP变化后域名解析有效。
• 临时部署环境：短期使用的服务器，无需手动维护DNS记录。

适用范围

• 个人用户、小型企业或需要动态DNS管理的组织。
• 已使用Amazon Route 53作为DNS服务提供商的用户。
• 需要自动化DNS记录维护，减少人工干预的场景。

详细使用方法和配置说明

前提条件

1. 已注册Amazon AWS账号，并创建Route 53托管区域（Hosted Zone），获取目标DNS记录的区域ID（Zone ID）。
2. 已创建具备Route 53记录修改权限的AWS IAM用户，获取Access Key ID和Secret Access Key（或配置IAM角色，容器需运行在AWS环境中）。

安装镜像

从Docker Hub或GitHub Container Registry拉取最新镜像：

docker pull crazymax/ddns-route53:latest

配置参数说明

ddns-route53支持通过环境变量或配置文件（如config.yml）定义参数，推荐使用环境变量简化部署。

核心环境变量

Docker运行示例

1. 使用docker run命令

docker run -d \
  --name ddns-route53 \
  --restart always \
  -e "AWS_ACCESS_KEY_ID=AKIAXXXXXXXXXXXX" \
  -e "AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -e "ROUTE53_ZONE_ID=ZXXXXXXXXXXXXXXXXXX" \
  -e "ROUTE53_RECORD_NAME=home.example.com" \
  -e "ROUTE53_RECORD_TYPE=A" \
  -e "CHECK_INTERVAL=5m" \
  crazymax/ddns-route53:latest

2. 使用docker-compose配置

创建docker-compose.yml文件：

version: '3.8'

services:
  ddns-route53:
    image: crazymax/ddns-route53:latest
    container_name: ddns-route53
    restart: always
    environment:
      - AWS_ACCESS_KEY_ID=AKIAXXXXXXXXXXXX
      - AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - AWS_REGION=us-east-1
      - ROUTE53_ZONE_ID=ZXXXXXXXXXXXXXXXXXX
      - ROUTE53_RECORD_NAME=home.example.com
      - ROUTE53_RECORD_TYPE=A
      - ROUTE53_TTL=300
      - CHECK_INTERVAL=5m
      - IP_DETECT_METHOD=icanhazip
      - LOG_LEVEL=info
    # 如需持久化日志，可挂载日志目录（可选）
    volumes:
      - ./logs:/var/log/ddns-route53

启动服务：

docker-compose up -d

验证部署

查看容器日志，确认服务正常运行：

docker logs -f ddns-route53

若配置正确，日志将显示“IP未变化，无需更新”或“IP已更新，同步Route 53记录成功”等信息。

注意事项

1. AWS凭证安全：避免将AWS密钥硬编码到配置文件中，推荐通过环境变量注入或使用AWS IAM角色（仅适用于AWS环境中运行的容器）。
2. 权限最小化：IAM用户仅需授予route53:ChangeResourceRecordSets权限，避免过度授权。
3. 网络连通性：容器需具备访问公网（用于IP检测）和AWS Route 53 API（route53.amazonaws.com）的网络权限。
4. 配置文件支持：如需管理多记录或复杂配置，可通过挂载配置文件实现（具体格式参考GitHub仓库）。

参考链接

• 官方GitHub仓库：[***]
• Amazon Route 53文档：[***]