tobvor/ddns-servercow

Servercow动态DNS更新器

该容器是Servercow的动态DNS客户端，设计用于Docker环境，可将servercow.de托管域名的DNS记录更新为当前公网IP地址。

前提条件

运行前请确保满足以下条件：

• 系统已安装Docker
• 拥有servercow.de托管的域名
• 具有DNS API访问权限的Servercow.de凭据（用户名和密码）

核心功能和特性

• 自动检测当前公网IP地址
• 支持IPv4和IPv6地址更新（可分别启用/禁用）
• 可配置更新间隔时间
• 支持主域名和子域名更新
• 可自定义IP地址获取服务提供商

使用场景和适用范围

适用于需要动态更新DNS记录的场景，如：

• 家庭网络或小型办公网络中使用动态公网IP
• 需要通过域名访问动态IP设备的场景
• 希望自动化维护DNS记录的Servercow用户

使用方法和配置说明

环境变量

运行Docker容器

基本运行命令

bash
docker run -d \
  --name ddns-servercow \
  -e DOMAIN="yourdomain.com" \
  -e USER="your_api_username" \
  -e PASSWORD="your_api_password" \
  -e IPv4="true" \
  -e IPv6="false" \
  tobvor/ddns-servercow

Docker Compose配置示例

yaml
version: '3'

services:
  ddns-servercow:
    image: tobvor/ddns-servercow
    container_name: ddns-servercow
    environment:
      - DOMAIN=yourdomain.com
      - USER=your_api_username
      - PASSWORD=your_api_password
      - IPv4=true
      - IPv6=false
      - INTERVAL=300  # 每5分钟检查一次
      - SUBDOMAIN=home  # 更新home.yourdomain.com
    restart: always

注意事项

• 请将"yourdomain.com"、"your_api_username"和"your_api_password"替换为实际的域名、Servercow.de API用户名和密码。
• 如需指定子域名，可设置SUBDOMAIN环境变量。
• 通过设置IPv4和IPv6环境变量可分别启用/禁用IPv4和IPv6更新。
• 可通过PROVIDER_IPv4和PROVIDER_IPv6环境变量自定义IP地址获取服务。
• ⚠️ 若IPv6设置为true，需确保Docker已启用IPv6支持（参见启用IPv6支持），或容器使用主机网络模式（network_mode: host）。

运行行为

脚本会按指定间隔持续检查容器的公网IP地址，当IP地址发生变化时，会相应更新Servercow.de上指定域名/子域名的DNS记录。

许可证

本脚本采用https://github.com/tobvor/ddns-servercow/blob/main/LICENSE%E3%80%82%E6%AC%A2%E8%BF%8E%E6%A0%B9%E6%8D%AE%E9%9C%80%E8%A6%81%E4%BF%AE%E6%94%B9%E5%92%8C%E5%88%86%E5%8F%91%E3%80%82