自部署 whois api 实现域名信息的自动化查询

之前写过一个 域名到期监控 的 CF worker 脚本，域名到期时间需要手动编辑 json 文件，再通过 worker 远程读取和解析，比较麻烦。这次做了升级，对一级域名可以自部署一个 whois api 实现域名信息的自动查询。二级域名就没办法了，只能通过手动编辑 json 文件的方式实现，因为二级域实际上是一级域的子域名，其到期时间是由注册者二次设置的，whois api 无法查询。

一、先部署一个 whois api

✅ 访问 我的仓库，点个 ⭐ 再 FORK 它，以便及时同步更新到我最新的代码

✅ 打开 whois-api.js 文件，复制所有内容，部署到 cf worker，设置以下变量

• API_KEY：自行设置，调用 API 需要用到，如：123abc
• CACHE_HOURS：缓存时间（单位：小时），默认为 24 小时，如：24

✅ 给这个 worker 项目绑定一个自定义域名，例如 https://whois.3344.com，在后面加上 /api/ 就是 api 接口地址（末尾必须要带 /），即：

1
2

# 末尾必须带 / 
https://whois.3344.com/api/

✅ 记录上面的 api 接口地址 和 api key 备用

二、部署新版域名监控

✅ 打开 domain-auto.js 文件，复制所有内容，部署到 cf worker，设置以下变量：

✅ DOMAINS变量json格式示例

1
2
3
4
5
6
7

[
  { "domain": "cfcdn.best" },
  { "domain": "811520.xyz" },
  { "domain": "cfedt.site" },
  { "domain": "aaa.dpdns.org", "registrationDate": "2024-05-31", "expirationDate": "2026-05-31", "system": "DigitalPlat", "systemURL": "https://dash.domain.digitalplat.org" },
  { "domain": "bbb.dpdns.org", "registrationDate": "2024-05-31", "expirationDate": "2026-05-31", "system": "DigitalPlat", "systemURL": "https://dash.domain.digitalplat.org" }
]

关于如何获取 gist 直链，看 这篇文章

✅ 给你的域名监控项目绑定自定义域名，假设为 https://domain.3344.com（注意：是域名监控项目绑定的域名，不是 API 接口绑定的域名），访问该域名，输入设定的密码，即可在网页上显示设定的域名信息

Whois api 接口简明文档

API 调用方式

• 请求 URL 格式：

1
2

https://<worker项目地址>/api/<要查询的域名>
# 示例：https://whois.example.com/api/github.com

• 请求头：X-API-KEY: 你的API密钥
• 请求方法：GET
• 调用示例

1
2
3

curl -X GET \
  -H "X-API-KEY: 你的API密钥" \
  https://whois.example.com/api/github.com

• 返回示例

1
2
3
4
5
6
7
8
9
10
11
12

{
  "domain": "example.com",
  "creationDate": "1995-08-14T04:00:00Z",
  "updatedDate": "2022-08-13T07:01:38Z",
  "expiryDate": "2023-08-13T04:00:00Z",
  "registrar": "RESERVED-INTERNET",
  "registrarUrl": "http://www.reserved.com",
  "nameServers": [
    "a.iana-servers.net",
    "b.iana-servers.net"
  ]
}

API 字段说明

错误响应

#API #cloudflare #域名 #监控 #面板