nwesterhausen/domain-monitor Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

domain-monitor

镜像概述和主要用途

domain-monitor是一个自托管服务器，用于监控指定域名的WHOIS记录，帮助提醒域名即将到期，并在域名发生意外变更时发出警报。需遵守各TLD WHOIS服务器的服务条款，避免高频率查询、营销用途及超出合理注册需求的自动化查询。

核心功能和特性

• 智能WHOIS查询机制：仅在特定条件下更新WHOIS参考数据，包括：
  • 参考文件已存在9个月
  • 距离域名到期日3个月、2个月、1个月或2周
  • 手动触发（如域名续期、转移或更改名称服务器后）
• DNS与WHOIS一致性检查：定期通过DNS检查名称服务器是否与WHOIS参考文件匹配，不匹配时触发警报
• 缓存机制：将WHOIS数据缓存为YAML文件，减少对WHOIS服务器的查询压力

使用场景和适用范围

• 域名持有者监控多个域名的到期时间，避免因过期导致服务中断
• 网站管理员跟踪域名注册信息变更，及时发现未授权的修改（如名称服务器变更）
• 需要集中管理多个域名状态的个人或组织

安装与使用方法

Docker安装

镜像使用两个卷挂载，用于配置文件和缓存数据：

暴露端口：4201/tcp（用于Web GUI访问）

从Github Packages拉取

主镜像为server镜像，可从Github Packages获取。

从Docker Hub拉取

镜像名称：nwesterhausen/domain-monitor，可使用latest标签获取最新版本或指定版本标签。

Docker运行示例

bash
docker run -d \
  -p 4201:4201 \
  -v ./domain-monitor-config:/app/config \
  -v ./domain-monitor-whois:/app/whois-data \
  --name domain-monitor \
  nwesterhausen/domain-monitor:latest

Node.js安装

支持Node.js >= 12，跨平台运行：

bash
git clone [***]
cd domain-monitor
yarn
node ./index.js

通过Web GUI（默认地址：http://localhost:4201）进行配置。

配置说明

config.yaml

首次运行时，若不存在config.yaml，系统会自动从sample.config.yaml复制生成。Web GUI的配置更改会自动保存到该文件。

应用设置（App Settings）

设置HTTP服务器（含WebSocket）端口：

yaml
app:
  port: 4201  # 默认端口

警报设置（Alerts）

• admin：接收警报的***地址
• sendalerts：布尔值，设为false时禁用所有警报

yaml
alerts:
  admin: ***  # 警报接收***
  sendalerts: yes  # 是否发送警报

SMTP设置

配置发送邮件警报的SMTP参数（基于Nodemailer）：

yaml
smtp:
  host: localhost  # SMTP服务器地址
  port: 25         # SMTP端口
  secure: false    # 是否启用TLS
  auth:
    user: ***  # SMTP认证用户名
    pass: SECRET-PASS               # SMTP认证密码

domain.yaml

包含domains列表，定义需监控的域名，每个域名属性如下：

示例：

yaml
domains:
  - name: "My Main Domain"
    fqdn: "example.com"
    alerts: true
    enabled: true
  - name: "Secondary Domain"
    fqdn: "example.org"
    alerts: false
    enabled: true