Lazy loaded image
分享
自部署 whois api 实现域名信息的自动化查询
Words 1306Read Time≈ 4 min
2025-9-23
2025-9-23
type
status
date
slug
summary
tags
category
icon
password

自部署 whois api 实现域名信息的自动化查询（原作者:yutian81）

针对一级域名可通过自部署 whois api 实现域名信息的自动查询；而二级域名（作为一级域的子域名，其到期时间由注册者二次设置）仍需手动编辑 JSON 文件配置，whois api 无法查询二级域名的到期信息。

一、先部署一个 whois api

✅ 访问「我的仓库」
domain-check
Github
domain-check
Owner
lijboys
Updated
Sep 23, 2025
，点个 ⭐ 后再 FORK 仓库，以便及时同步最新代码。
domain-check
lijboys • Updated Sep 23, 2025
✅ 打开 whois-api.js 文件，复制全部内容并部署到 Cloudflare Worker，同时设置以下核心变量：
  • API_KEY：自行定义，调用 API 时需用到（示例：123abc）
  • CACHE_HOURS：缓存时间（单位：小时），默认 24 小时（示例：24）
✅ 为该 Worker 项目绑定自定义域名（示例：https://whois.3344.com），API 接口地址为域名后拼接 /api/（末尾必须带 /），格式如下：
✅ 记录上述 API 接口地址 和 API_KEY，后续部署域名监控时需用到。

二、部署新版域名监控

✅ 打开 domain-auto.js 文件，复制全部内容并部署到 Cloudflare Worker，按以下要求配置变量（表格含必填/非必填说明）： 密码不修改默认为：123123
变量名
默认值
示例说明
是否必须
DOMAINS
无
JSON 文件直链：https://gist.githubusercontent.com/用户名/gistID/raw/domains.json
是
TGID
无
Telegram 机器人 ID：5868334288
是
TGTOKEN
无
Telegram 机器人 Token：9194882369:xxxxxxfwCD8vdtt0jyESsgL2-xxxxxx
是
DAYS
7
到期前提醒天数（示例：7 表示到期前 7 天开始提醒）
否
API_URL
无
自部署 whois api 接口：https://whois.example.com/api/github.com
是
API_KEY
无
自部署 whois api 的 TOKEN（即第一步记录的 API_KEY）
是
PASSWORD
123123
访问域名监控主页的密码
是
SITENAME
域名到期监控
自定义站点名称（示例：我的域名监控面板）
否
ICON
https://pan.811520.xyz/icon/domain.png
自定义站点 LOGO 图片链接
否
BGIMG
https://pan.811520.xyz/icon/back.webp
自定义站点背景图链接
否
GITHUB_URL
https://github.com/lijboys/domain-check
页脚自定义 GitHub 仓库地址
否
BLOG_URL
https://blog.009223.xyz/
页脚自定义博客地址
否
BLOG_NAME
NOOMI Blog
页脚自定义博客名称
否

1. DOMAINS 变量 JSON 格式示例

JSON 文件需包含待监控的域名信息，其中一级域名无需手动填时间（api 自动查询），二级域名需手动填写注册/到期时间，示例如下(两种格式选择一个就行了)：

2. 访问域名监控面板

✅ 为域名监控项目绑定自定义域名（示例：https://domain.3344.com，注意：与 whois api 的域名不同）。
✅ 访问该域名，输入上述配置的 PASSWORD，即可在网页上查看所有待监控域名的信息。

Whois api 接口简明文档

1. API 调用方式

  • 请求 URL 格式：
    • 请求头：X-API-KEY: 你的API密钥（即第一步配置的 API_KEY）
    • 请求方法：GET

    2. 调用示例（curl 命令）

    3. 返回示例（JSON 格式）

    4. API 字段说明

    字段
    类型
    说明
    domain
    string
    查询的域名（小写，无需加 http/https）
    creationDate
    string/null
    域名创建时间（ISO 格式，查询失败为 null）
    updatedDate
    string/null
    域名最后更新时间（查询失败为 null）
    expiryDate
    string/null
    域名到期时间（查询失败为 null）
    registrar
    string/null
    注册商名称（查询失败为 null）
    registrarUrl
    string/null
    注册商网址（查询失败为 null）
    nameServers
    array
    域名服务器列表（已去重，无数据为空数组）

    5. 错误响应

    状态码
    含义
    示例响应
    400
    请求格式错误
    {"error": "路径格式应为 /api/<域名>"}
    401
    未提供 API Key
    {"error": "需要提供有效的 API Key"}
    403
    API Key 无效
    {"error": "无效的 API Key"}
    500
    服务器错误（查询超时）
    {"error": "WHOIS 查询超时"}
    502
    WHOIS 服务不可用
    {"error": "WHOIS 服务返回 502"}
    上一篇
    CloudFlare中国大陆地区优选方案汇总
    下一篇
    机场推荐
    Catalog