oneaccordllc/custom-domain-commiter

镜像概述

该Docker镜像提供一个基于Cron的定时任务服务，主要功能是定期检查自定义域名信息，并将更新后的域名数据自动提交到指定GitHub仓库的特定位置，实现域名信息的自动化同步与版本控制。

核心功能和特性

• 定时任务执行：基于Cron机制配置任务执行频率，支持灵活的时间调度
• 自定义域名检查：支持配置多个自定义域名，执行指定的域名信息检查
• GitHub自动提交：检查结果自动提交到GitHub仓库，无需手动操作
• 目标路径指定：可配置GitHub仓库中存储域名数据的具体路径
• 配置灵活性：通过环境变量和配置文件自定义检查规则与提交参数

使用场景和适用范围

• 个人或团队需要定期同步自定义域名列表到GitHub仓库进行版本管理
• 域名管理系统中需自动备份或更新域名配置信息
• 需对域名状态（如DNS记录）进行定期监控并记录变更历史
• 多环境部署中需要保持域名配置文件在GitHub仓库的同步更新

使用方法和配置说明

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name domain-cronjob \
  -e GITHUB_REPO="https://github.com/user/domain-repo.git" \
  -e GITHUB_TOKEN="ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -e CRON_SCHEDULE="0 * * * *" \
  -e TARGET_PATH="data/domains.json" \
  -v /local/path/to/domains.config:/app/domains.config \
  your-image-name:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  domain-cronjob:
    image: your-image-name:latest
    container_name: domain-cronjob
    environment:
      - GITHUB_REPO=https://github.com/user/domain-repo.git
      - GITHUB_TOKEN=ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      - CRON_SCHEDULE=0 * * * *
      - TARGET_PATH=data/domains.json
    volumes:
      - ./domains.config:/app/domains.config  # 挂载本地配置文件
    restart: unless-stopped  # 容器退出时自动重启

配置文件格式说明

domains.config 配置文件示例（JSON格式）：

json
{
  "domains": [
    "example.com",
    "api.example.com",
    "www.test.org"
  ],
  "check_options": {
    "dns_records": ["A", "AAAA", "CNAME"],
    "timeout": 10  # DNS查询超时时间（秒）
  }
}

• domains: 需要检查的自定义域名列表
• check_options.dns_records: 需要检查的DNS记录类型
• check_options.timeout: DNS查询超时时间设置