DNS Stamps
服务器 stamp 将连接到安全 DNS 服务器所需的所有参数编码为单个字符串。可以把 stamp 理解为 QR 码,但用于 DNS。
在线 DNS stamp 计算器
使用这个 VueJS 组件可以快速查看/修改/创建 stamp。
在线演示可在此访问:https://stamps.dnscrypt.info
一个包含 DNS stamp 的公共安全 DNS 解析器示例列表。
通用定义
- a || b 是 a 与 b 的拼接
- a | b 是 a 与 b 之间逻辑或运算的结果。
- len(x) 是 x 长度的单字节表示,单位为字节。字符串不必以零结尾,也不要求单独编码。
- vlen(x) 等于 len(x)(如果 x 是集合的最后一个元素),否则为 0x80 | len(x)(如果集合中还有更多元素)。
- LP(x) 是 len(x) || x,即以长度作为前缀的 x。
- VLP(x1, x2, ...xn) 编码一个集合,形式为 vlen(x1) || x1 || vlen(x2) || x2 ... || vlen(xn) || xn。由于 vlen(xn) == len(xn)(最后一个元素的长度不设置高位),对于只有一个元素的集合,有 VLP(x) == LP(x)。
- [ Q ] 表示 Q 是可选的。
- base64url(s) 是 s 的 URL 安全 base64 编码。没有任何参数被单独 base64 编码。Base64 编码仅应用一次,作用于所有带长度前缀参数拼接后的整体。
编码示例:
- LP("10.0.0.1") 为 [ 0x08, 0x31, 0x30, 0x2e, 0x30, 0x2e, 0x30, 0x2e, 0x31 ]
- VLP("10.0.0.1", "10.0.0.2") 结果为 [ 0x88, 0x31, 0x30, 0x2e, 0x30, 0x2e, 0x30, 0x2e, 0x31, 0x08, 0x31, 0x30, 0x2e, 0x30, 0x2e, 0x30, 0x2e, 0x32 ]
- base64url(VLP("10.0.0.1", "10.0.0.2")) 为 iDEwLjAuMC4xCDEwLjAuMC4y
DNSCrypt stamps
"sdns://" || base64url(0x01 || props || LP(addr [:port]) || LP(pk) || LP(providerName))
0x01 是 DNSCrypt 的协议标识符。
props 是一个小端序 64 位值,表示解析器的非正式属性。它是以下值的逻辑或组合:
- 1:服务器支持 DNSSEC
- 2:服务器不保留日志
- 4:服务器不故意屏蔽域名
例如,一个支持 DNSSEC、保留日志、但自身不屏蔽任何内容的服务器,应将 props 设置为以下 8 字节序列:[ 0x05, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 ]。
addr 是 IP 地址(字符串形式),如果服务器无法通过协议的标准端口(443)访问,则附带端口号。IPv6 字符串必须包含在方括号中:[fe80::6d6d:f72c:3ad:60b8]。允许使用作用域。
pk 是 DNSCrypt 提供商的 Ed25519 公钥,为 32 个原始字节。
providerName 是 DNSCrypt 提供商名称。
DNS-over-HTTPS stamps
"sdns://" || base64url(0x02 || props || LP(addr) || VLP(hash1, hash2, ...hashn) ||
LP(hostname [:port]) || LP(path)
[ || VLP(bootstrap_ip1, bootstrap_ip2, ...bootstrap_ipn) ])
addr 是服务器的 IP 地址。它可以是空字符串。在这种情况下,主机名将通过另一个解析器解析为 IP 地址。
hashi 是验证链中找到的某个 TBS 证书的 SHA256 摘要,通常是用于签署解析器证书的证书。可以提供多个哈希以实现无缝轮换。
hostname 是服务器主机名,也将用作 SNI 名称。如果主机名包含 URL 允许范围之外的字符,这些字符应按原样发送,不做任何额外编码(既不进行 URL 编码,也不使用 punycode)。端口号是可选的,缺失时假定为 443。
path 是绝对 URI 路径,例如 /dns-query。
bootstrap_ipi 是推荐解析器的 IP 地址,可通过标准 DNS 访问,用于解析 hostname。这是可选的,客户端可以忽略此信息。
DNS-over-TLS stamps
"sdns://" || base64url(0x03 || props || LP(addr) || VLP(hash1, hash2, ...hashn) ||
LP(hostname [:port]) ||
[ || VLP(bootstrap_ip1, bootstrap_ip2, ...bootstrap_ipn) ])
addr 是服务器的 IP 地址。它可以是空字符串。在这种情况下,将使用另一个解析器把主机名解析为 IP 地址。
IPv6 字符串必须放在方括号中:[fe80::6d6d:f72c:3ad:60b8]。允许使用作用域。
hashi 是验证链中找到的某个 TBS 证书的 SHA256 摘要,通常是用于签署解析器证书的证书。可以提供多个哈希以实现无缝轮换。
hostname 是服务器主机名,也将用作 SNI 名称。端口号是可选的,如果缺失则假定为 443。
bootstrap_ipi 是推荐解析器的 IP 地址,这些解析器可通过标准 DNS 访问,以便解析 hostname。这是可选的,客户端可以忽略此信息。
DNS-over-QUIC stamps
"sdns://" || base64url(0x04 || props || LP(addr) || VLP(hash1, hash2, ...hashn) ||
LP(hostname [:port]) ||
[ || VLP(bootstrap_ip1, bootstrap_ip2, ...bootstrap_ipn) ])
addr 是服务器的 IP 地址。它可以是空字符串。在这种情况下,将使用另一个解析器把主机名解析为 IP 地址。
IPv6 字符串必须放在方括号中:[fe80::6d6d:f72c:3ad:60b8]。允许使用作用域。
hashi 是验证链中找到的某个 TBS 证书的 SHA256 摘要,通常是用于签署解析器证书的证书。可以提供多个哈希以实现无缝轮换。
hostname 是服务器主机名,也将用作 SNI 名称。端口号是可选的,如果缺失则假定为 443。
bootstrap_ipi 是推荐解析器的 IP 地址,这些解析器可通过标准 DNS 访问,以便解析 hostname。这是可选的,客户端可以忽略此信息。
Oblivious DoH 目标 stamps
"sdns://" || base64url(0x05 || props || LP(hostname [:port]) || LP(path))
hostname 是服务器主机名;对于中继,它也将用作 SNI 名称。如果主机名包含 URL 允许范围之外的字符,这些字符应原样发送,不做任何额外编码(既不做 URL 编码,也不做 punycode)。端口号是可选的,如果缺失则假定为 443。
path 是绝对 URI 路径,例如 /dns-query。
Anonymized DNSCrypt 中继 stamps
"sdns://" || base64url(0x81 || LP(addr))
0x81 是 DNSCrypt 中继的协议标识符。
addr 是 IP 地址和端口,以字符串表示。IPv6 字符串必须放在方括号中:[fe80::6d6d:f72c:3ad:60b8]:443。
Oblivious DoH 中继 stamps
"sdns://" || base64url(0x85 || props || LP(addr) || VLP(hash1, hash2, ...hashn) ||
LP(hostname [:port]) || LP(path)
[ || VLP(bootstrap_ip1, bootstrap_ip2, ...bootstrap_ipn) ])
0x85 是 oDoH 中继的协议标识符。
addr 是服务器的 IP 地址。它可以是空字符串。在这种情况下,将使用另一个解析器把主机名解析为 IP 地址。
hashi 是验证链中找到的某个 TBS 证书的 SHA256 摘要,通常是用于签署解析器证书的证书。可以提供多个哈希以实现无缝轮换。
hostname 是服务器主机名;对于中继,它也将用作 SNI 名称。如果主机名包含 URL 允许范围之外的字符,这些字符应原样发送,不做任何额外编码(既不做 URL 编码,也不做 punycode)。端口号是可选的,如果缺失则假定为 443。
path 是绝对 URI 路径,例如 /dns-query。
bootstrap_ipi 是推荐解析器的 IP 地址,可通过标准 DNS 访问,以便解析主机名并获取 oDoH 目标公钥。这是可选的,客户端可以忽略此信息。
普通 DNS stamps
"sdns://" || base64url(0x00 || props || LP(addr [:port]))
addr 是服务器的 IP 地址。IPv6 字符串必须包含在方括号中:[fe80::6d6d:f72c:3ad:60b8]。允许使用作用域。
实现
库
- DNS stamps 的 Go 实现
- 另一个 DNS stamps 的 Go 实现
- DNS stamps 的 .NET 实现,作者 @bitbeans
- DNS stamps 的 Rust 实现
- 另一个 Rust 实现
- DNS stamps 的 Python 实现
- DNS stamps 的 Javascript 实现
- DNS stamps 的 Swift 实现
应用
DNS stamps 已知用于以下应用:
- dnscrypt-proxy
- dnscrypt-wrapper
- encrypted-dns-server
- simple dnscrypt
- yourfriendlydns
- Texnomic SecureDNS
作为 DNS stamps 的服务器列表
- Quad9 解析器列表
- CleanBrowsing DNSCrypt 和 DoH 服务器
- 公共解析器列表
- OpenNIC 解析器列表
- 家长控制解析器列表
- 匿名 DNS 中继列表
- Oblivious DoH 目标服务器列表
- Oblivious DoH 代理列表