Newshot

DNS Stamps 规范

Translation(model translation, not the source's own text)

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 代理列表

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Lobsters
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗