chrodriguez/aws-route53-dynamic-update

AWS Route53 DNS记录集动态更新镜像

镜像概述

本镜像用于动态更新AWS Route53服务中的DNS记录集，适用于NAT防火墙后的局域网机器，可自动获取公网IP并更新指定的DNS记录，确保域名解析到最新的公网IP地址。

核心功能

1. 自动获取当前公网IP（默认通过[***]
2. 更新AWS Route53中指定Zone的DNS记录集
3. 支持自定义IP地址、DNS服务器、TTL值和记录类型

使用场景

• 局域网机器位于NAT防火墙后，公网IP动态变化，需要保持域名解析到最新IP
• 定期更新DNS记录以确保服务可访问性

配置说明

通过环境变量配置镜像参数：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID（必填）
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥（必填）
• ZONEID: Route53区域ID（必填）
• RECORDSET: 要更新的DNS记录集名称（如some-name.example.com，必填）
• IP: 自定义IP地址（可选，默认自动获取）
• DNS_SERVER: 用于查询当前DNS记录的服务器（可选，默认8.8.8.8）
• TTL: 记录的TTL值（可选，默认60秒）
• TYPE: DNS记录类型（可选，默认A记录）

Docker部署示例

运行以下命令更新DNS记录：

bash
docker run \
  -e AWS_ACCESS_KEY_ID=XXXX \
  -e AWS_SECRET_ACCESS_KEY=YYYY \
  -e ZONEID=ZZZZZ \
  -e RECORDSET=some-name.example.com \
  --rm -it docker.xuanyuan.run/chrodriguez/aws-route53-dynamic-update

Kubernetes CronJob示例

通过Kubernetes CronJob定时执行更新任务（使用Secret存储凭证）：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: route53-credentials
  namespace: kube-system
stringData:
  secret-access-key: YYYY
  access-key-id: XXXX
  zone-id: ZZZZZ
---
apiVersion: batch/v1beta1
kind: CronJob
metadata:
  labels:
    application: dns-update
  name: dns-update
spec:
  schedule: "@every 5m"
  concurrencyPolicy: Forbid
  jobTemplate:
    spec:
      backoffLimit: 4
      template:
        metadata:
          labels:
            application: dns-update
        spec:
          restartPolicy: Never # 便于检查Pod错误
          containers:
          - name: dns-update
            image: chrodriguez/aws-route53-dynamic-update
            imagePullPolicy: Always
            env:
            - name: AWS_ACCESS_KEY_ID
              valueFrom:
                secretKeyRef:
                  name: route53-credentials
                  key: access-key-id
            - name: AWS_SECRET_ACCESS_KEY
              valueFrom:
                secretKeyRef:
                  name: route53-credentials
                  key: secret-access-key
            - name: ZONEID
              valueFrom:
                secretKeyRef:
                  name: route53-credentials
                  key: zone-id
            - name: RECORDSET
              value: some-name.example.com