customelements/schlund-ddns

schlund-ddns

Docker化版本的https://github.com/wosc/schlund-ddns/

此镜像运行Python Flask服务器，通过SchlundTech官方XML-Gateway（HTTP/HTTPS）更新其管理的DNS记录，同时提供命令行工具（CLI）。感谢https://github.com/wosc/%E5%92%8Chttps://github.com/martinlowinski/php-dyndns%E7%9A%84%E5%BC%80%E6%BA%90%E8%B4%A1%E7%8C%AE%E3%80%82

镜像概述

本镜像将开源项目schlund-ddns容器化，简化部署流程，支持通过HTTP接口或CLI工具动态更新SchlundTech管理的DNS记录，适用于需要动态DNS服务的场景。

核心功能

1. 通过SchlundTech XML网关更新A记录类型的子域名（如sub.domain.tld）
2. 提供Flask HTTP服务，支持通过URL请求更新DNS
3. 提供CLI工具，可直接从命令行执行更新操作
4. 支持Docker Compose部署，方便集成到现有环境
5. 可结合Traefik代理和基本认证，增强服务安全性

使用场景

• 家庭服务器动态IP更新：当家庭网络IP变化时，自动更新DNS记录以保持远程访问
• 小型企业服务器：无需手动维护DNS记录，实现IP变化后的自动更新
• 开发测试环境：快速调整DNS记录以适配临时IP变更

配置说明

1. 获取XML网关访问权限

在SchlundTech官网免费申请XML网关访问权限。

2. 创建凭据文件

在Docker部署目录下创建配置文件，填入账号信息：

bash
# 复制模板文件（若不存在可手动创建）
cp .schlund-ddns.dist .schlund-ddns
# 编辑配置文件，替换为你的账号密码
[default]
username = 你的账户ID
password = 你的账户密码

3. Docker Compose部署

基础配置示例（docker-compose.yaml）：

yaml
version: '3'
services:
  schlundddns:
    image: customelements/schlund-ddns
    container_name: schlund-ddns
    ports:
      - "5000:5000"
    volumes:
      - ./.schlund-ddns:/schlund-ddns/.schlund-ddns
    environment:
      - DDNS_CONFIG=/schlund-ddns/.schlund-ddns

启动服务：

bash
docker-compose up -d

4. HTTP接口更新DNS

通过URL请求更新子域名DNS记录：

bash
# 替换your.subdomain.tld为目标子域名，0.0.0.0为当前IP
curl "http://localhost:5000/?hostname=your.subdomain.tld&myip=0.0.0.0"

注意：仅支持更新A记录类型的一级子域名（如sub.domain.tld），不支持主域名（domain.tld）或多级子域名（my.sub.sub.domain.tld）。

5. CLI工具更新DNS

使用容器内的CLI工具更新DNS（推荐通过环境变量传递密码避免敏感信息暴露）：

bash
# 设置密码环境变量
read -p "输入密码: " -s PASS
# 执行更新命令
docker run --rm -it --entrypoint schlund-ddns \
  customelements/schlund-ddns \
  --username 你的账户ID \
  --password $PASS \
  your.host.tld \
  0.0.0.0

6. Traefik代理与基本认证配置

若需通过Traefik代理服务并添加基本认证，参考以下步骤：

创建基本认证凭据

使用htpasswd生成加密凭据（需安装apache2-utils或使用Docker镜像）：

bash
# 方法1：本地安装htpasswd
read -p "密码: " -s PASS
echo $(htpasswd -nbB 用户名 "$PASS") | sed -e s/\\$/\\$\\$/g
# 方法2：使用Docker镜像
docker run --rm -it xmartlabs/htpasswd 用户名 $PASS | sed -e s/\\$/\\$\\$/g

将输出的凭据字符串保存备用。

Traefik配置示例（docker-compose.traefik.yaml）

yaml
version: '3'
services:
  schlundddns:
    image: customelements/schlund-ddns
    container_name: schlund-ddns
    networks:
      - traefik
    volumes:
      - ./.schlund-ddns:/schlund-ddns/.schlund-ddns
    environment:
      - DDNS_CONFIG=/schlund-ddns/.schlund-ddns
    labels:
      - "traefik.docker.network=traefik"
      - "traefik.enable=true"
      - "traefik.basic.frontend.rule=Host:你的域名"
      - "traefik.port=5000"
      - "traefik.protocol=http"
      - "traefik.frontend.headers.SSLRedirect=false"
      - "traefik.frontend.auth.basic=你的基本认证凭据"

networks:
  traefik:
    external: true

启动服务：

bash
docker-compose -f docker-compose.traefik.yaml up -d