ddns-ddnss

镜像概述和主要用途

该Docker容器是一个针对ddnss.de的DDNS（动态DNS）更新器，仅支持IPv4。其核心功能是监控本地IPv4地址变化，当检测到地址变更时，自动将新的IPv4地址发送到ddnss.de更新域名解析记录。用户需在启动容器前配置必要的环境变量以确保正常运行。

核心功能和特性

• IPv4地址监控：自动检测本地IPv4地址变化
• 多域名支持：可同时配置多个ddnss.de域名，用逗号分隔
• 定时检查：可自定义IPv4地址检查频率和域名解析记录检查频率
• 通知集成：支持通过Shoutrrr发送更新通知（如Gotify、、、邮件等）
• 网络检查：验证与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"

可选参数

Docker部署示例

Docker CLI

bash
docker 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

Docker Compose

yaml
services:
  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:

卷参数说明

Shoutrrr通知配置

支持通过Shoutrrr发送IP更新通知，支持多种服务（Gotify、、、邮件等）。以下是常用服务的URL示例：

生成Shoutrrr URL

可通过以下命令生成Shoutrrr URL：

bash
docker run --rm -it alcapone1933/shoutrrr generate

测试通知发送：

bash
docker run --rm -it alcapone1933/shoutrrr send --verbose --url "<Shoutrrr URL>" --message "DDNS更新测试通知"