
alcapone1933/ddns-ddnss该Docker容器是一个针对ddnss.de的DDNS(动态DNS)更新器,仅支持IPv4。其核心功能是监控本地IPv4地址变化,当检测到地址变更时,自动将新的IPv4地址发送到ddnss.de更新域名解析记录。用户需在启动容器前配置必要的环境变量以确保正常运行。
适用于使用ddnss.de动态DNS服务的用户,尤其是需要将动态IPv4地址与固定域名关联的场景,如家庭服务器、远程访问设备等。支持个人用户和小型网络环境,提供稳定的动态DNS更新服务。
域名(DOMAIN_DDNSS)
在ddnss.de创建的域名(vHostname),可在ddnss.de域名列表查看。
单域名示例:-e "DOMAIN_DDNSS=deine-domain.ddnss.de"
多域名示例(逗号分隔):-e "DOMAIN_DDNSS=deine-domain.ddnss.de,deine-domain.ddnss.org"
域名密钥(DOMAIN_KEY)
ddnss.de的DynDNS更新密钥,可在ddnss.de账户页面获取。
示例:-e "DOMAIN_KEY=***abcdefghijklmnopqrstuv"
| 名称(描述) | 环境变量名 | 默认值 | 示例 |
|---|---|---|---|
| 时区 | TZ | Europe/Berlin | Europe/Berlin |
| IPv4地址检查频率(Cron表达式) | CRON_TIME | */15 * * * * | */15 * * * *(每15分钟检查一次) |
| 域名解析记录检查频率(Cron表达式) | CRON_TIME_DIG | */30 * * * * | */30 * * * *(每30分钟检查一次) |
| 域名IP检查开关 | IP_CHECK | yes | yes/no(是否检查域名当前解析IP) |
| Shoutrrr通知URL(支持Gotify、***等) | SHOUTRRR_URL | - | gotify://domain.de/***abc/?title=DDNS更新 |
| 跳过Shoutrrr启动测试通知 | SHOUTRRR_SKIP_TEST | no | yes/no(启动时是否发送测试通知) |
| 域名解析检查的DNS服务器 | NAME_SERVER | ns1.ddnss.de | ns3.ddnss.de |
| 网络连接检查开关 | NETWORK_CHECK | yes | yes/no(是否检查与ddnss.de的连接) |
| 数据目录用户ID | PUID | 0 | 1000(容器内/data目录的用户ID) |
| 数据目录组ID | PGID | 0 | 1000(容器内/data目录的组ID) |
bashdocker run -d \ --restart always \ --name ddns-ddnss \ -e "TZ=Asia/Shanghai" \ -e "CRON_TIME=*/15 * * * *" \ -e "CRON_TIME_DIG=*/30 * * * *" \ -e "DOMAIN_KEY=***abcdefghijklmnopqrstuv" \ -e "DOMAIN_DDNSS=deine-domain.ddnss.de,deine-domain.ddnss.org" \ -e "IP_CHECK=yes" \ -e "SHOUTRRR_URL=gotify://domain.de/***abc/?title=DDNS+DDNSS.DE+IP+UPDATE" \ -v ddns-ddnss_data:/data \ alcapone1933/ddns-ddnss:latest
yamlservices: ddns-ddnss: image: alcapone1933/ddns-ddnss:latest container_name: ddns-ddnss restart: always environment: - "TZ=Asia/Shanghai" - "CRON_TIME=*/15 * * * *" - "CRON_TIME_DIG=*/30 * * * *" - "DOMAIN_KEY=***abcdefghijklmnopqrstuv" - "DOMAIN_DDNSS=deine-domain.ddnss.de,deine-domain.ddnss.org" - "IP_CHECK=yes" - "SHOUTRRR_URL=***://***abc@555555555555555?title=DDNS+DDNSS.DE+IP+UPDATE" - "PUID=1000" - "PGID=1000" volumes: - ddns-ddnss_data:/data volumes: ddns-ddnss_data:
| 名称(描述) | 类型 | 默认值 | 自定义路径示例 |
|---|---|---|---|
| 日志存储目录 | volume | ddns-ddnss_data:/data | /本地路径:/data |
支持通过Shoutrrr发送IP更新通知,支持多种服务(Gotify、、、邮件等)。以下是常用服务的URL示例:
| 服务名称 | URL示例 |
|---|---|
| Gotify | gotify://domain.de/***abc/?title=DDNS+DDNSS.DE+IP+UPDATE&priority=5 |
| *** | ***://***abc@555555555555555?title=DDNS+DDNSS.DE+IP+UPDATE |
| *** | ***://***:***abc@***/?chats=5555555555&title=DDNS+DDNSS.DE+IP+UPDATE |
| SMTP(邮件) | smtp://***:***:587/?from=***&to=***&subject=DDNS+DDNSS.DE+IP+UPDATE |
可通过以下命令生成Shoutrrr URL:
bashdocker run --rm -it alcapone1933/shoutrrr generate
测试通知发送:
bashdocker run --rm -it alcapone1933/shoutrrr send --verbose --url "<Shoutrrr URL>" --message "DDNS更新测试通知"






manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务