README
¶
介绍
基于 Golang 实现的域名 Whois 查询工具，支持所有允许公开查询的 TLD 后缀的域名、IPv4/v6、ASN 的 Whois 信息查询。
根据 ICANN 《通用顶级域名注册数据临时政策细则（Temporary Specification for gTLD Registration Data）》和欧盟《通用数据保护条例》合规要求，在查询域名信息时，程序只返回了部分必要的信息（详见下方返回结果示例），不会返回所有者的联系方式、地址、电话、邮箱等字段。
使用方法
下载
使用二进制文件
您可从 Release 页面下载对应平台的二进制文件。
从源码编译
git clone https://github.com/KincaidYang/whois.git
cd whois
go build
安装依赖
本程序需要 Redis 服务支持，您可参照 https://redis.io/docs/install/install-redis/install-redis-on-linux/ 进行安装。
编辑配置文件
vim config.json
{
"redis": {
"addr": "localhost:6379",
"password": "",
"db": 0
},
"cacheExpiration": 3600,
"port": 8043,
"rateLimit": 50
}
根据需要修改 Redis 地址、端口、密码、数据库、缓存时间、监听端口、限频等参数。
⚠️ Warning: 限频针对的是程序向 whois 服务器发起的请求，而非用户向本程序发起的请求。例如，您将限频设置为 50，那么程序向 whois 服务器发起的请求将不会超过 50 次/秒，但是用户向本程序发起的请求不受限制。请您通过 Nginx 等工具对本程序进行限流，以防止恶意请求。
运行
./whois
注意： 本程序默认监听 8043 端口。
进程守护（可选）
您可以使用 systemd 等工具将本程序设置为守护进程，以便在系统重启后自动运行。
vim /etc/systemd/system/whois.service
[Unit]
[Unit]
Description=whois
After=network.target
[Service]
Type=simple
User=www
Group=www
ExecStart=/path/to/whois/whois
WorkingDirectory=/path/to/whois
Restart=on-failure
[Install]
WantedBy=multi-user.target
使用
GET 请求
查询域名 Whois 信息
curl http://localhost:8043/example.com
返回结果
{
"Domain Name": "EXAMPLE.COM",
"Registrar": "RESERVED-Internet Assigned Numbers Authority",
"Registrar IANA ID": "376",
"Domain Status": [
"client delete prohibited",
"client transfer prohibited",
"client update prohibited"
],
"Creation Date": "1995-08-14T04:00:00Z",
"Registry Expiry Date": "2024-08-13T04:00:00Z",
"Updated Date": "2023-08-14T07:01:38Z",
"Name Server": [
"A.IANA-SERVERS.NET",
"B.IANA-SERVERS.NET"
],
"DNSSEC": "signedDelegation",
"DNSSEC DS Data": "370 13 2 BE74359954660069D5C63D200C39F5603827D7DD02B56F120EE9F3A86764247C",
"Last Update of Database": "2024-01-16T10:26:40Z"
}
查询 IPv4 Whois 信息
curl http://localhost:8043/1.1.1.1
返回结果
{
"IP Network": "1.1.1.0 - 1.1.1.255",
"Address Range": "1.1.1.0 - 1.1.1.255",
"Network Name": "APNIC-LABS",
"CIDR": "1.1.1.0/24",
"Network Type": "ASSIGNED PORTABLE",
"Country": "AU",
"Status": [
"active"
],
"Creation Date": "2011-08-10T23:12:35Z",
"Updated Date": "2023-04-26T22:57:58Z"
}
查询 IPv6 Whois 信息
curl http://localhost:8043/2a0f:9400:7700::2
返回结果
{
"IP Network": "2a0f:9400:7700::/48",
"Address Range": "2a0f:9400:7700:: - 2a0f:9400:7700:ffff:ffff:ffff:ffff:ffff",
"Network Name": "RTTW",
"CIDR": "2a0f:9400:7700::/48",
"Network Type": "ALLOCATED-BY-LIR",
"Country": "CN",
"Status": [
"active"
],
"Creation Date": "2022-04-08T12:07:49Z",
"Updated Date": "2022-12-20T02:19:43Z"
}
查询 ASN Whois 信息
curl http://localhost:8043/ASN205794
curl http://localhost:8043/AS205794
curl http://localhost:8043/205794
⚠ 不区分大小写
返回结果
{
"AS Number": "AS205794",
"Network Name": "RTTW-AS",
"Status": [
"active"
],
"Creation Date": "2022-04-14T12:24:55Z",
"Updated Date": "2024-02-15T07:18:46Z"
}
已知问题
程序向注册局查询 Whois 信息主要依靠 RDAP 协议查询，但由于大部分 ccTLD 不支持 RDAP 协议，程序会对其原始的 Whois 信息格式化后返回 JSON 数据，但由于本人精力有限，未对所有的 ccTLD 后缀进行适配，程序可能会直接返回 text 数据，如您常用的后缀没用被覆盖，可以提交 Issue 或者贡献匹配规则至 whois_parsers.go 文件中，在此表示感谢！
您可根据content-type来判断返回数据格式。
项目依赖
本项目使用了以下Go标准库：
bytes：操作字节切片的函数。context：定义了Context类型，用于在API边界和进程之间传递截止日期、取消信号和其他请求范围的值。encoding/json：编码和解码JSON对象的函数。errors：创建错误和操作错误的函数。fmt：格式化I/O函数。io：I/O原语函数。log：简单的日志服务。net：网络I/O原语的函数。net/http：HTTP客户端和服务器实现。os：操作系统功能的函数。os/signal：接收操作系统信号的函数。regexp：正则表达式搜索。strconv：将字符串转换为基本类型的函数。strings：操作字符串的函数。sync：基本的同步原语。syscall：访问操作系统底层调用的函数。time：测量和显示时间的函数。
本项目还使用了以下第三方库：
github.com/redis/go-redis/v9：Go语言Redis客户端。golang.org/x/net/idna：实现了IDNA（国际化域名在应用程序）规范。golang.org/x/net/publicsuffix：实现了公共后缀列表规范。
WHOIS/RDAP 服务器列表来自于：
Documentation
¶
There is no documentation for this package.
Source Files
Directories