本文翻译自英文 Minecraft Wiki,最后更新日期为 2026.10.27,以 CC-BY-NC-SA 3.0 协议进行转载。
原文链接:
NetherNet 是 Minecraft 的点对点网络传输层,构建于 WebRTC 之上。客户端使用 WebRTC 数据通道与服务器交换游戏数据。通过 HTTP 信令,连接先经由 HTTP 请求进行协商,随后在客户端与服务器之间直接建立。
HTTP 信令
客户端使用两个 HTTP 端点。一次成功的能力检查会告知客户端该服务器支持 NetherNet,并提供服务器详情。随后,客户端使用 SDP 交换端点来协商 WebRTC 连接。
能力检查
客户端发送 GET /v1/join。成功响应应具有 2xx 状态码、application/json 内容类型,以及一个包含服务器信息的 JSON 对象。非 2xx 响应表示 NetherNet 不可用,客户端不会继续连接设置。
SDP 交换
客户端每次连接尝试发送一个 HTTP 请求:
{networkId} 路径值用于向信令服务标识客户端。其值被视为不透明字符串。非 2xx 响应会终止本次尝试;客户端不会自动重试。
NetherNet 的 HTTP 信令在发送 offer 或 answer 之前会收集所有 ICE 候选。信令服务将 offer 路由到主机,并返回其 answer。在连接建立之后,信令服务不参与游戏数据连接。
连接序列
客户端通过
GET /v1/join检查支持情况。客户端创建一个 WebRTC 对等连接以及下文所述的两个数据通道。
客户端收集 ICE 候选,并将其 SDP offer 发送到
POST /v1/join/{networkId}。信令服务将 offer 转发给主机。
主机创建 SDP answer,收集其 ICE 候选,并通过信令服务返回 answer。
客户端应用 answer。客户端与主机执行 ICE 连通性检查,建立 DTLS 与 SCTP,并打开数据通道。
游戏数据通过 WebRTC 连接在客户端与主机之间流动。
客户端的 HTTP 信令配置使用 UDP ICE 候选,禁用 trickle ICE,并将数据通道捆绑在同一个传输上。offer 和 answer 各自携带所有已收集的 ICE 候选。
客户端未配置 STUN 或 TURN 服务器,仅收集本地候选。主机的 answer 必须包含一个客户端可到达的候选;位于 NAT 之后的主机可能需要一个可公开到达的候选。
身份与信任
客户端的 a=identity 断言用于标识已认证的玩家,并由服务器验证。没有断言的 offer 可能根据服务器的认证策略被接受或拒绝。服务器的 answer 必须包含其运营者身份的断言;客户端在接受连接之前会进行检查。
该属性包含一个 base64 编码的 JSON 对象,带有身份提供者(idp)和一个断言字符串。断言携带一个签名令牌以及针对 WebRTC 证书指纹的签名。客户端令牌由 Minecraft 认证服务签发;服务器令牌则使用其运营者密钥自签名。
使用 HTTPS 信令时,客户端依赖 TLS 来认证服务器。使用明文 HTTP 信令时,客户端使用 TOFU(首次使用信任):它在首次看到某个运营者密钥时提示玩家,随后记住该密钥用于后续连接。无论哪种情况,answer 中都必须包含 a=identity 属性。
数据通道
客户端打开两个 SCTP 数据通道。主机会接受这两个通道,并可在其上发送和接收数据。
不可靠通道将 maxRetransmits 设置为 0。
消息帧格式
每个数据通道消息以一个单字节头部开始。接收方在处理有效载荷之前会移除此字节。
未分片消息的头部值为 0。未分片有效载荷的最大值为协商的 SCTP 消息大小限制减去一个字节(用于头部)。在 ReliableDataChannel 上,超大消息会被拆分为分片,其头部值递减至零,接收方按顺序重组有效载荷。在 UnreliableDataChannel 上,头部始终为零;超大消息会被丢弃,而不是分片。
游戏数据
NetherNet 在其数据通道消息中承载基岩版游戏数据。游戏数据包格式记录于“基岩版协议/数据包”页面。
在基岩版中的使用
NetherNet 在 26.50 版本中成为基岩版专用服务器的默认传输方式。对 RakNet 连接的支持计划在 26.60 版本中终止。