域名过期监控工具 (Domain Check) 使用教程

简介

Domain Check 是一个轻量级的域名过期监控工具，旨在帮助个人站长和企业管理员轻松管理大量域名。它提供直观的仪表盘，实时显示域名状态，支持自动 WHOIS 查询、过期提醒、WebDAV 数据备份以及 Telegram 通知，确保您不会因为忘记续费而丢失宝贵的域名资产。

主要功能

可视化仪表盘：直观展示域名总数、正常、即将过期和已过期数量。
自动 WHOIS 查询：后台定期查询域名 WHOIS 信息，自动更新过期时间。
智能状态标记：
- 🟢 正常：有效期大于 30 天
- 🟠 将到期：有效期少于 30 天（阈值可配置）
- 🔴 已到期：域名已过期
多维度管理：支持按域名分组、关键词搜索、状态筛选和多重排序。
数据安全：
- 支持 WebDAV 自动/手动备份数据。
- 本地 JSON 文件存储，无需复杂数据库。
消息通知：支持 Telegram Bot 消息推送，每天定时发送过期提醒。
个性化设置：支持深色模式、自定义背景图、自定义站点名称和图标。
Docker 部署：一键部署，开箱即用。

快速部署 (Docker)

本项目推荐使用 Docker Compose 进行部署，简单快捷。

1. 准备环境

确保您的服务器已安装 Docker 和 Docker Compose。

2. 创建配置文件

在服务器上创建一个目录（例如 domain-check），并在其中创建 docker-compose.yml 文件：

3. 启动服务

Bash

version: '3.8'

services:
  domain-check:
    image: ghcr.io/debbide/domain-check:latest
    container_name: domain-check
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - PASSWORD=123123              # 访问密码

在目录下运行以下命令启动容器：

docker-compose up -d

启动后，访问 http://服务器IP:3000 即可进入系统。

使用指南

1. 登录系统

首次访问需要输入在 docker-compose.yml 中设置的 PASSWORD。

2. 添加域名

点击右上角的 "添加域名" 按钮：

批量添加：可以直接粘贴多个域名，用空格、逗号或换行分隔。
自动查询：系统会自动尝试查询域名的注册时间和过期时间。
手动修正：如果 WHOIS 查询失败，您可以手动输入日期。
分组：可以为域名设置分组（如：公司、个人、客户A），方便筛选。

3. 域名管理

查看详情：点击域名卡片上的链接可以直接访问网站。
编辑/删除：鼠标悬停在卡片上，点击编辑图标修改信息，或点击删除图标移除域名。
置顶：最近操作的域名会自动排在前面。
筛选与搜索：
- 使用顶部的搜索框查找域名。
- 点击状态卡片（如“将到期”）筛选特定状态的域名。
- 点击分组标签查看特定分组的域名。

4. 系统设置

点击右上角的 齿轮图标 进入设置面板：

基础设置：修改网站标题、图标、背景图片等。
过期阈值：设置提前多少天标记为“将到期”。
Telegram 通知：
- 输入 Chat ID 和 Bot Token。
- 点击“测试”按钮发送测试消息。
- 系统会根据 Cron 表达式定时发送过期提醒。
WebDAV 备份 (强烈推荐)：
- 配置 WebDAV 地址、用户名和密码。
- 开启 "定时自动备份"，防止数据丢失。
- 支持手动“立即备份”和查看“备份列表”。
- 支持从备份列表一键恢复数据。

5. WebDAV 备份说明

配置 WebDAV 后，系统会在 WebDAV 服务器上自动创建 domain-check-backups 文件夹，所有备份文件将存储于此。

自动备份：跟随定时任务自动执行。
保留策略：可以设置保留最近几天的备份（默认 7 天），过期备份会自动清理。

常见问题

Q: WHOIS 查询失败怎么办？ A: 部分域名后缀可能不支持自动查询，或者受到查询频率限制。您可以稍后重试，或者手动在编辑框中输入过期时间。

Q: 如何获取 Telegram Chat ID？ A: 添加 @userinfobot 为好友，发送任意消息，它会返回您的 ID。如果是群组，请将 Bot 拉入群组并设为管理员，ID 通常以 -100 开头。

Q: 数据存储在哪里？ A: 所有数据存储在挂载的 ./data 目录下的 domains.json 和 settings.json 文件中。只要保留这个目录，数据就不会丢失。

Q: 忘记密码怎么办？ A: 修改 docker-compose.yml 中的 PASSWORD 环境变量，然后运行 docker-compose up -d 重启容器即可生效。

结语

Domain Check 致力于做一个简单好用的域名管理工具。如果您觉得好用，欢迎在 GitHub 上点个 Star！

GitHub 项目地址: https://github.com/debbide/domain-check

简介