域名到期监控系统

对原有的 worker版 进行模块化重构，kv作为数据储存，前端界面大升级，采用现代化卡片式布局

基于 Cloudflare Worker 和 Worker KV 构建的域名到期监控仪表盘，支持自动 WHOIS 查询、分组管理、到期提醒等功能。

功能特性

• ✅ 域名管理：支持一级和二级域名的添加、编辑、删除
• 🔍 WHOIS 自动查询：一级域名自动获取注册和到期信息
• 📊 可视化仪表盘：域名状态概览、进度条、分组展示
• 🔐 密码保护：简单的访问控制机制
• 💾 KV 存储：使用 Cloudflare Workers KV 持久化数据
• 💾 数据备份：支持数据的导出和导入
• 📱 Telegram 通知：定时检查并推送即将到期提醒
• 🎨 响应式设计：支持移动端和桌面端访问

部署平台：Cloudflare Workers

前置条件

• 先 Fork 本项目，点击直达
• 在 Cloudflare 创建一个 KV 空间，名称随意，例如：DOMAIN_KV
• 修改 wrangler.toml 文件，绑定KV空间和设置定时通知

name = "domain-check"
main = "src/index.js"
compatibility_date = "2025-11-17"
keep_vars = true

# KV 命名空间绑定 (必须)
[[kv_namespaces]]
binding = "DOMAIN_KV" 
id = "ae781b4223338853ab094beb9ade" # 替换成你实际的 KV ID

# Cron Triggers 定时任务
[triggers]
crons = ["0 1,13 * * *"] # 北京时间 9:00 和 21:00

部署方法

• 打开 Cloudflare 的 Woerks and Pages
• 创建应用程序 —— 选择 workers —— 选择 导入存储库
• 链接 Github 账户，选择刚刚 fork 的项目，点击 开始设置
• 填写项目名称，其他保持默认，点击 创建和部署
• 添加变量 PASSWORD，设置自己的访问密码，默认密码为 123123
• 访问你的 workers 默认地址，输入登录密码，进入管理页面
• 界面预览

环境变量

变量名	说明	默认值/示例值	必填
PASSWORD	访问密码	123123	✔️
WHOIS_API_URL	WHOIS API 地址	https://your-whois-api.example.com/api/	❌
WHOIS_API_KEY	WHOIS API 密钥	abc123	❌
TGID	Telegram Chat ID	-	❌
TGTOKEN	Telegram Bot Token	-	❌
DAYS	到期提醒天数	30	❌
SITENAME	网站名称	域名到期监控	❌
ICON	网站图标	https://example.com/icon.png	❌
BGIMG	背景图片	https://example.com/bg.png	❌
GITHUB_URL	GitHub 链接	https://github.com/yutian81	❌
BLOG_URL	博客链接	https://blog.notett.com	❌
BLOG_NAME	博客名称	QingYun Blog	❌

Whois API 部署方法

此步骤为可选，仅支持一级域名的信息查询

WHOIS_API_URL 和 WHOIS_API_KEY 可通过部署 whois.js 代码获得（worker 部署）

• 部署平台：CF workers
• 环境变量 WHOIS_API_KEY：自行设置，调用 API 需要用到，如：abcabc
• 环境变量 CACHE_HOURS：缓存时间（单位：小时），默认为24小时，不用修改
• 绑定域名（因为worker被墙，建议绑定域名）
• 得到API接口地址：WHOIS_API_URL = https://<worker项目地址>/api/ （末尾的/必须保留）

本项目 API 接口

https://github.com/yutian81/domain-check/blob/main/API.md

安全建议

⚠️ 重要提示：

1. 使用强密码并定期更换
2. 定期备份 KV 数据
3. 限制 API 访问频率

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

相关链接

• Cloudflare Pages 文档
• Workers KV 文档
• Wrangler 文档