joebiellik/ddclient

ddclient容器

镜像概述和主要用途

本镜像基于Debian系统运行http://ddclient.sourceforge.net/，ddclient是一款轻量级动态DNS客户端工具，主要用于自动检测并更新动态IP地址到DNS服务提供商的域名解析记录，确保域名始终指向当前有效的IP地址。

核心功能和特性

• 动态IP更新：自动检测本地IP地址变化，并同步更新至指定DNS服务提供商
• 多平台支持：兼容主流DNS服务提供商（如Cloudflare、DynDNS、No-IP等）
• 轻量级设计：基于Debian系统，镜像体积小，资源占用低
• 配置灵活：通过配置文件自定义更新频率、服务提供商、域名等参数
• 日志捕获：支持日志输出，便于监控和排查更新状态

使用场景和适用范围

• 家庭网络或小型办公环境中使用动态IP地址的服务器
• 需要通过域名远程访问的个人设备（如NAS、摄像头、家庭服务器）
• 无法获取静态IP地址但需保持域名解析有效的场景
• 希望自动化管理DNS记录，避免手动更新的用户

详细使用方法和配置说明

配置文件准备

需提前准备ddclient配置文件（ddclient.conf），可参考https://github.com/jcbiellikltd/docker-ddclient/tree/master/example获取配置模板。配置文件需包含DNS服务提供商信息、认证凭据、域名及更新参数等。

Docker Compose部署示例

yml
ddclient:
  image: docker.xuanyuan.run/joebiellik/ddclient
  tty: true  # 必须启用，用于捕获日志输出
  volumes:
    # 将本地配置文件挂载到容器内指定路径
    - ./ddclient.conf:/config/ddclient.conf

Docker Run命令部署

bash
docker run -d \
  --name ddclient \
  --tty \
  -v ./ddclient.conf:/config/ddclient.conf \
  docker.xuanyuan.run/joebiellik/ddclient

关键配置说明

• tty设置：必须启用（tty: true或--tty参数），否则无法正常捕获和输出日志
• 配置文件挂载：通过-v参数将本地ddclient.conf挂载至容器内/config/ddclient.conf路径，此为必须配置
• 配置文件内容：需根据DNS服务提供商要求填写正确的服务器地址、用户名、密码、域名等信息，具体格式参考官方文档或示例配置

注意事项

• 确保宿主机时间同步，避免因时间偏差导致的认证失败
• 配置文件权限需确保容器内进程可读取（建议权限设置为644）
• 首次运行前建议测试配置文件有效性，可通过容器日志查看更新状态