ebrianne/duckdns-go

duckdns-go 镜像说明

镜像概述

duckdns-go是基于Go语言开发的DuckDNS客户端镜像，用于与DuckDNS免费动态域名解析服务交互，实现IP地址更新、TXT记录管理等功能。镜像支持环境变量和命令行参数配置，部署便捷，适用于需要动态解析公网IP的场景。

核心功能

• 更新DuckDNS域名的IPv4/IPv6地址
• 管理TXT记录（更新、清除、查询）
• 自动获取公网IP（通过whatismyipaddress.com）
• 定时IP更新（最小间隔10分钟，默认1小时）
• 支持环境变量与CLI参数双重配置方式

使用场景

• 家庭服务器：动态解析公网IP到域名，方便远程访问
• 个人项目：小型应用或设备的动态DNS需求
• 开发测试：快速搭建动态域名解析环境

配置说明

环境变量配置

所有功能均可通过环境变量设置：

• DUCKDNS_TOKEN：DuckDNS令牌（必填）
• DUCKDNS_DOMAINS：域名列表（逗号/空格分隔，必填）
• DUCKDNS_IPV4：指定IPv4地址（可选）
• DUCKDNS_IPV6：指定IPv6地址（可选）
• DUCKDNS_RECORD：TXT记录内容（更新/清除记录时必填）
• DUCKDNS_UPDATE_INTERVAL：IP更新间隔（默认1h，最小10m）

CLI参数配置

常用参数示例：

• -duckdns_token：设置DuckDNS令牌
• -duckdns_domains：指定域名列表
• -update-ip：执行IP更新操作
• -update-record：更新TXT记录
• -clear-record：清除TXT记录
• -auto-ip：自动获取公网IP

Docker部署示例

基本IP更新

bash
docker run \
-e 'DUCKDNS_TOKEN=your_token' \
-e 'DUCKDNS_DOMAINS=example.duckdns.org' \
ebrianne/duckdns-go

更新TXT记录

bash
docker run \
-e 'DUCKDNS_TOKEN=your_token' \
-e 'DUCKDNS_DOMAINS=example.duckdns.org' \
-e 'DUCKDNS_RECORD=test_record' \
ebrianne/duckdns-go ./duckdns-go -update-record

定时30分钟更新IP

bash
docker run \
-e 'DUCKDNS_TOKEN=your_token' \
-e 'DUCKDNS_DOMAINS=example.duckdns.org' \
-e 'DUCKDNS_UPDATE_INTERVAL=30m' \
ebrianne/duckdns-go