dougflynndev/namecheap-ddns

Namecheap DDNS

镜像概述和主要用途

该镜像利用Namecheap的DDNS服务，实现在家庭环境中运行Web服务器等应用。通过自动更新域名解析记录，将动态变化的公网IP与域名关联，确保外部可通过域名稳定访问家庭网络中的服务。

核心功能和特性

• 多架构支持：提供arm64（如树莓派4）和amd64架构的镜像，适配不同硬件环境
• 简单配置：通过环境变量即可完成参数设置，无需复杂配置文件
• 轻量部署：基于Docker容器化设计，部署流程简单，资源占用低

使用场景和适用范围

适用于需要将动态公网IP与域名绑定的家庭网络场景，例如：

• 运行家庭Web服务器或个人博客
• 搭建家庭NAS（网络附加存储）服务
• 远程访问家庭监控设备或其他网络服务

使用方法和配置说明

快速启动

直接使用Docker Hub上的镜像（支持arm64和amd64）：

shell
docker run \
    -e PASSWORD=添加你的DDNS密码 \
    -e DOMAIN=你的主域名.com \
    -e SUB_DOMAINS=www,api \  # 多个子域名用逗号分隔
    -it dougflynn/namecheap-ddns

手动运行源代码

步骤1：克隆仓库

shell
git clone https://github.com/dougflynndev/namecheap-ddns.git
cd namecheap-ddns

步骤2：配置环境变量

复制示例环境变量文件并填充配置信息：

shell
cp .env.example .env

编辑.env文件，设置以下必要参数：

• PASSWORD：Namecheap域名管理界面中的DDNS密码
• DOMAIN：主域名（如example.com）
• SUB_DOMAINS：需更新的子域名列表（如www,blog，多个用逗号分隔）

步骤3：选择运行方式

Docker（推荐）

构建本地镜像：

shell
docker build -t namecheap-ddns .

运行容器：

shell
docker run \
    -e PASSWORD=添加你的DDNS密码 \
    -e DOMAIN=你的主域名.com \
    -e SUB_DOMAINS=www,api \
    -it namecheap-ddns

直接运行Python

创建并激活虚拟环境：

shell
python -m venv venv
source ./venv/bin/activate  # Windows系统使用：venv\Scripts\activate

安装依赖包：

shell
pip install -r requirements.txt

启动程序：

shell
python -u main.py