jobscale/value-domain

Value-Domain 动态DNS镜像

镜像概述

该Docker镜像提供了Value-Domain动态DNS客户端功能，用于自动检测并更新Value-Domain域名解析记录。适用于动态IP环境下，确保域名始终指向正确的IP地址，支持多主机记录配置与定时更新。

核心功能与特性

• 动态DNS更新：自动检测IP变化并更新Value-Domain域名解析记录
• 多主机支持：可同时配置多个主机记录（如@、*等）
• 配置驱动：通过JavaScript配置文件管理域名、令牌和主机列表
• 容器化部署：支持Docker容器化运行，便于集成到各类环境
• 定时任务集成：可通过Kubernetes CronJob等方式实现定期更新

使用场景

• 家庭服务器或NAS设备的动态IP解析
• 动态宽带环境下的域名解析维护
• 需要保持域名与动态IP绑定的各类网络服务
• 开发/测试环境中的动态DNS需求

使用方法

1. 获取源码

bash
git clone https://github.com/jobscale/value-domain.git
cd value-domain

2. 环境配置

创建配置文件app/.env.js，设置域名、API令牌和主机记录：

bash
echo "module.exports = {
  domain: 'example.com',  // Value-Domain域名
  token: 'secret',        // Value-Domain API令牌
  hosts: ['@', '*'],      // 需更新的主机记录列表
};" > app/.env.js

3. 本地测试

安装依赖并测试功能：

bash
npm i          # 安装依赖
npm run lint   # 代码检查
npm start      # 运行更新程序

4. 构建Docker镜像

bash
docker build . -t local/value-domain:0.0.1

5. 运行Docker容器

bash
docker run --rm -it local/value-domain:0.0.1

6. 创建定时任务

通过Kubernetes创建定期执行的CronJob：

bash
# 创建CronJob（每7分钟执行一次）
kubectl create cronjob value-domain --image local/value-domain:0.0.1 --schedule '0/7 * * * *'

# 手动触发一次执行
kubectl create job --from=cronjob/value-domain value-domain-manual-$(date +'%Y%m%d-%H%M')

配置参数说明

配置文件app/.env.js支持以下参数：

• domain (必填): Value-Domain注册的域名（如example.com）
• token (必填): Value-Domain API访问令牌
• hosts (必填): 主机记录数组，支持@(根域名)、*(通配符)、子域名等（如['@', 'www', 'ftp']）