edchamberlain/namecheap_ddns

Namecheap DDNS

镜像概述

Namecheap DDNS是一个轻量级容器，用于通过GET请求自动更新Namecheap动态DNS域名记录。该容器每3秒检查一次公网IP，当检测到IP变化时自动发送更新请求。此容器可在unRAID社区应用中获取。

核心功能与特性

• 自动IP检查：每3秒检查一次公网IP地址
• 动态更新触发：仅在IP地址变化时发送DNS更新请求
• 多域名/主机支持：通过分号分隔的列表支持多个主机、域名和密码的配置
• 环境变量配置：通过环境变量灵活配置必要参数

使用场景

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

• 家庭服务器（如NAS、媒体服务器）
• 个人网站或应用部署在动态IP环境中
• 任何需要将动态公网IP与固定域名关联的场景

使用方法与配置说明

前置要求

1. 在Namecheap域名管理页面为目标主机创建"A + Dynamic DNS"记录
2. 在域名管理页面启用Dynamic DNS功能
3. 获取Dynamic DNS密码（注意：此密码不同于Namecheap账户密码）

环境变量

必填环境变量

可选环境变量

部署示例

基本用法

bash
docker run \
-e APP_HOST='your host' \
-e APP_DOMAIN='your domain' \
-e APP_PASSWORD='your ddns password' \
edchamberlain/namecheap_ddns:latest

带可选参数的用法

bash
docker run \
-e APP_HOST='your host' \
-e APP_DOMAIN='your domain' \
-e APP_PASSWORD='your ddns password' \
-e APP_UPDATE_TIME='60' \  # 设置检查间隔为60秒
-e APP_LOG_LEVEL='INFO' \   # 设置日志级别为INFO
edchamberlain/namecheap_ddns:latest

多域名/主机配置

要同时更新多个主机或域名，使用分号分隔各参数值（需确保各参数值数量相同）：

bash
docker run \
-e APP_HOST='host1;host2' \  # 主机1和主机2
-e APP_DOMAIN='example.com;example.com' \  # 两个主机对应的域名（可相同或不同）
-e APP_PASSWORD='password1;password2' \  # 两个主机对应的Dynamic DNS密码（可相同或不同）
edchamberlain/namecheap_ddns:latest

注意事项

• 各环境变量（APP_HOST、APP_DOMAIN、APP_PASSWORD）的分号分隔列表长度必须相同
• APP_PASSWORD必须是Namecheap提供的Dynamic DNS密码，而非账户登录密码
• 如需了解更多信息，请参考Namecheap帮助页面