annangela/dnspod-ddns

dnspod-ddns镜像说明

镜像概述

dnspod-ddns是针对DNSPod平台的动态域名解析（DDNS）工具镜像，能够自动检测主机IP变化并更新域名解析记录，解决动态IP场景下的域名访问问题。

核心功能

• 自动获取主机当前IP地址
• 定时更新DNSPod域名解析记录
• 支持自定义网卡、线路限制及任务执行频率
• 通过环境变量灵活配置关键参数

使用场景

• 家庭网络/小型服务器动态IP绑定域名
• Synology NAS等设备的动态域名需求
• 个人网站/服务在IP变化时保持稳定访问

配置说明

环境变量参数

必填项

• DNSPOD_ID: DNSPod API密钥ID（从https://console.dnspod.cn/account/token/token%E8%8E%B7%E5%8F%96%EF%BC%89
• DNSPOD_TOKEN: DNSPod API密钥Token（同上）
• DNSPOD_DOMAIN: 一级域名（如example.com，从https://console.dnspod.cn/dns/list%E8%8E%B7%E5%8F%96%EF%BC%89

可选项

• DNSPOD_SUB_DOMAIN: 主机记录名（默认@，如www、mail）
• DNSPOD_RECORD_LINE_NAMES: 线路限制（用|分隔，例默认|华南）
• NETWORK_INTERFACE_NAME: 网卡名称（默认eth0，Synology NAS建议ovs_eth0）
• CRON: 定时表达式（六列，默认0 */5 * * * *即每5分钟执行）

部署示例

Docker Run命令

bash
docker run -d \
  --net=host \
  -e DNSPOD_ID="你的ID" \
  -e DNSPOD_TOKEN="你的Token" \
  -e DNSPOD_DOMAIN="你的域名" \
  -e DNSPOD_SUB_DOMAIN="www" \
  --name dnspod-ddns \
  annangela/dnspod-ddns

Docker Compose配置

yaml
version: '3'
services:
  dnspod-ddns:
    image: annangela/dnspod-ddns
    network_mode: host
    environment:
      - DNSPOD_ID=你的ID
      - DNSPOD_TOKEN=你的Token
      - DNSPOD_DOMAIN=你的域名
      - DNSPOD_SUB_DOMAIN=www
      - CRON=0 */10 * * * *
    restart: always

注意：必须使用宿主网络模式（--net=host）以确保正确获取主机IP。