maelgangloff/domain-watchdog

domain-watchdog Docker镜像文档

镜像概述和主要用途

domain-watchdog Docker镜像是基于https://github.com/maelgangloff/domain-watchdog%E6%9E%84%E5%BB%BA%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E5%BA%94%E7%94%A8%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%B8%AE%E5%8A%A9%E7%94%A8%E6%88%B7%E8%87%AA%E5%8A%A8%E5%8C%96%E6%94%B6%E9%9B%86%E5%9F%9F%E5%90%8D%E5%85%AC%E5%BC%80%E4%BF%A1%E6%81%AF%E3%80%81%E8%B7%9F%E8%B8%AA%E5%9F%9F%E5%90%8D%E5%8E%86%E5%8F%B2%E5%8F%98%E6%9B%B4%E8%AE%B0%E5%BD%95%EF%BC%8C%E5%B9%B6%E8%BE%85%E5%8A%A9%E5%9F%9F%E5%90%8D%E8%B4%AD%E4%B9%B0%E5%86%B3%E7%AD%96%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E5%9F%9F%E5%90%8D%E7%9B%91%E6%8E%A7%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E9%AB%98%E6%95%88%E7%AE%A1%E7%90%86%E5%92%8C%E8%8E%B7%E5%8F%96%E5%9F%9F%E5%90%8D%E7%9B%B8%E5%85%B3%E6%95%B0%E6%8D%AE%E7%9A%84%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 公开信息收集：自动获取域名的公开数据，包括WHOIS信息、DNS记录、注册商信息及过期时间等
• 历史记录跟踪：记录域名关键信息的历史变更，如注册商变更、DNS记录修改、状态变更（如从已注册到即将过期）等
• 域名状态监控：实时监控域名可用性状态，包括是否可注册、即将过期、已被注册等状态
• 购买辅助：提供域名可购买状态提醒，部分场景下支持集成域名购买流程（具体取决于配置）

使用场景和适用范围

• 域名*者**：监控目标域名的状态变化，把握最佳购买时机
• 企业IT/品牌保护：跟踪与企业品牌相关的域名，防止品牌域名被抢注或滥用
• 个人用户：寻找理想域名时，监控特定关键词域名的可用性和价格变动

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name domain-watchdog \
  -e DOMAINS="example.com,example.org" \
  -e CHECK_INTERVAL="3600" \  # 检查间隔（秒），默认3600秒（1小时）
  -v ./config:/app/config \    # 挂载配置文件目录（可选，用于高级配置）
  maelgangloff/domain-watchdog

Docker Compose配置

yaml
version: '3'
services:
  domain-watchdog:
    image: docker.xuanyuan.run/maelgangloff/domain-watchdog
    container_name: domain-watchdog
    restart: always
    environment:
      - DOMAINS=example.com,example.org,mybrand.io  # 目标监控域名，逗号分隔
      - CHECK_INTERVAL=1800                         # 检查间隔，单位秒
      - NOTIFICATION_EMAIL=alert@example.com        # 通知接收邮箱（若支持）
      - WHOIS_API_KEY=your_api_key                  # WHOIS API密钥（如需第三方服务）
    volumes:
      - ./domain-data:/app/data                     # 持久化存储域名历史数据
      - ./config:/app/config                        # 自定义配置文件目录

配置参数说明

环境变量

数据持久化

建议通过挂载卷（如示例中的./domain-data:/app/data）持久化存储域名历史数据，避免容器重启后数据丢失。

注意事项

• 部分功能（如WHOIS信息获取）可能受限于第三方API速率限制或地区访问限制，建议配置合法的API密钥
• 域名购买功能需根据实际集成情况配置，具体请参考https://github.com/maelgangloff/domain-watchdog
• 持续监控可能产生网络请求，请注意遵守目标域名注册商的使用条款和API规则

更多详细配置及高级功能，请访问项目官方GitHub仓库：https://github.com/maelgangloff/domain-watchdog