shawngmc/route53-dyndns

Amazon Route53动态DNS工具

这是针对Amazon Route53的简单动态DNS服务，支持Docker Swarm部署，能自动将Route53 A记录更新为当前外部IP，解决动态IP场景下的域名访问问题。

镜像概述

该工具通过OpenDNS解析器快速获取外部IP（比HTTP服务更可靠），定期更新Route53记录。支持Docker Secret存储AWS密钥（优先于环境变量），增强敏感信息安全性，兼容Compose和Swarm两种部署模式。

核心功能

• 自动IP获取：通过OpenDNS DNS查询获取当前外部IP
• Route53记录更新：定期同步指定A记录到当前IP
• 安全密钥管理：Docker Secret优先存储AWS密钥
• 多部署模式：支持Compose单机部署与Swarm集群部署
• 灵活配置：可自定义IP检查频率和AWS区域

使用场景

• 家庭服务器：动态IP环境下保持域名稳定访问
• 远程设备：确保远程办公设备通过固定域名连接
• 小型服务：无需静态IP即可提供域名访问能力

配置说明

必需Secrets/环境变量

• route53_access_key：AWS访问密钥（Swarm模式用Secret，非Swarm用AWS_ACCESS_KEY_ID环境变量）
• route53_secret_key：AWS秘密密钥（Swarm模式用Secret，非Swarm用AWS_SECRET_ACCESS_KEY环境变量）

必需环境变量

• AWS_CONNECTION_REGION：AWS连接区域（如us-east-1）
• ROUTE53_DOMAIN_A_RECORD：需更新的A记录（如myhome.example.com）
• ROUTE53_UPDATE_FREQUENCY：IP检查频率（秒，建议设较大值）

Docker Compose/Swarm部署示例

yaml
version: "3.5"
services:
    route53-dyndns:
        container_name: route53-dyndns
        deploy:
            restart_policy:
                condition: on-failure
                delay: 5s
                max_attempts: 3
                window: 120s
        environment:
            - 'AWS_CONNECTION_REGION=us-east-1'
            - 'ROUTE53_DOMAIN_A_RECORD=insert.your.domain.here'
            - 'ROUTE53_UPDATE_FREQUENCY=900'
        image: docker.xuanyuan.run/shawngmc/route53-dyndns
        secrets:
            - route53_access_key
            - route53_secret_key
secrets:
  route53_access_key:
    external:
      name: route53_access_key
  route53_secret_key:
    external:
      name: route53_secret_key

CLI部署示例

bash
docker run -d \
    --name route53 \
    -e AWS_ACCESS_KEY_ID=your_access_key \
    -e AWS_SECRET_ACCESS_KEY=your_secret_key \
    -e AWS_CONNECTION_REGION=us-east-1 \
    -e ROUTE53_DOMAIN_A_RECORD=your.domain.com \
    -e ROUTE53_UPDATE_FREQUENCY=10800 \
    docker.xuanyuan.run/shawngmc/route53-dyndns

参考来源

本镜像基于以下项目修改：

• https://github.com/bshaw/route53-dyndns 主要参考：
• https://github.com/JacobSanford/docker-route53-dyndns
• https://github.com/JacobSanford/route-53-dyndns