WHOIS 是互联网中用来查找网域名称和 IP 的服务,可以让我们在链接到对方的服务器前,先行确认对方究竟是谁(没错,就是 Who is ...?),避免连接到不安全的服务器。在开发 Rust 程序的时候,也可以利用 WHOIS 来做对外连接的检查。

WHOIS Rust

「WHOIS Rust」是笔者开发的套件,受到 whois 这个 Node.JS 套件的启发,采用了 servers.json 作为 WHOIS 的服务器查找清单,可以针对 IP 或是不同的网域名称自动或是手动选择要查找的 WHOIS 服务器,并且也支持 WHOIS 服务器的转介(referral)。

Crates.io

Cargo.toml

whois-rust = "*"

使用方法

创建 servers.json

以下是一个简单的 servers.json 范例:

{
    "magiclen.org": "whois.magiclen.org",
    "org": "whois.pir.org",
    "": "whois.ripe.net",
    "_": {
        "ip": {
            "host": "whois.arin.net",
            "query": "n + $addr\r\n"
        }
    }
}

当查找的字符串是 IP 的时候,套件会自动选择 whois.arin.net 这个 WHOIS 服务器来查找。当查找的字符串结尾是 magiclen.org 时,套件会自动选择 whois.magiclen.org 这个 WHOIS 服务器来查找。当查找的字符串结尾是 org 时,套件会自动选择 whois.pir.org 这个 WHOIS 服务器来查找。当查找的字符串结尾没有明确地被列在 servers.json 中时,就会用 whois.ripe.net 这个 WHOIS 服务器来查找。

完整标准的 servers.json WHOIS 服务器清单,可以从「whois」这个 Node.JS 套件的 GitHub Repository 中取得:

servers.json 中,WHOIS 服务器的值可以是一个字符串,也可以是一个 JSON 对象。如果是字符串的话,预设的查找字符串为 $addr\r\n,$addr 为查找时目标地址会被代入的变量。如果是 JSON 对象的话,就可以利用 query 字段来修改查找字符串的格式。WHOIS 服务器预设的连接端口为 43,如果要修改的话,直接在 WHOIS 服务器的 Host 字符串中使用 域名或IP:连接端口 的格式即可。

读取 servers.json

创建好 servers.json,可以利用 whois_rust 这个 crate 所提供的 WhoIs 结构体的 from_path 或是 from_string 关联函数来读取,并创建出 WhoIs 结构实体。

from_path 可以从文件读取 servers.json 的数据,例如:

use whois_rust::WhoIs;

let whois = WhoIs::from_path("/path/to/servers.json").unwrap();

from_string 可以从内存读取 servers.json 的数据,建议搭配 include_str 宏一同使用,例如:

use whois_rust::WhoIs;

let whois = WhoIs::from_string(include_str!("/path/to/servers.json")).unwrap();
查找

whois_rust 这个 crate 中有一个 WhoIsLookupOptions 结构体,要进行 WHOIS 查找前,必须要创建出 WhoIsLookupOptions 的结构实体。WhoIsLookupOptions 结构体提供了 from_domain、from_ipv4、from_ipv6、from_string 关联函数,可以快速创建出已包含查找目标的 WhoIsLookupOptions 结构实体。

一般来说,WhoIsLookupOptions 结构实体一旦创建出来就可以被使用了,但是如果您有特殊需求,想要手动指定查找时使用的 WHOIS 服务器的话,可以修改其 server 字段。如果要修改(预设是 2)WHOIS 服务器的转介次数,可以修改其 follow 字段。如果要修改(预设是 60000 毫秒,也就是一分钟)WHOIS 服务器的逾时时间,可以修改其 timeout 字段。

使用 WhoIs 结构实体提供的 lookup 方法,搭配创建好的 WhoIsLookupOptions 结构实体,即可进行查找,举例来说:

use whois_rust::{WhoIs, WhoIsLookupOptions};

let whois = WhoIs::from_path("/path/to/servers.json").unwrap();

let result: String = whois.lookup(WhoIsLookupOptions::from_string("magiclen.org").unwrap()).unwrap();

因为 WHOIS 是直接给人类使用,进行查找与查看结果的服务,因此查找结果并没有规范太多的格式,以致于没有一个通用的方法将结果转成特定的数据结构来保存。因此 WhoIs 结构实体提供的 lookup 方法,会原封不动地拿到 WHOIS 服务器的回传结果。