Loading...

文章背景图

【MCBE】基岩版 NetherNet 网络协议

2026-10-27
73
- 字
- 分钟
|

本文翻译自英文 Minecraft Wiki,最后更新日期为 2026.10.27,以 CC-BY-NC-SA 3.0 协议进行转载。

原文链接:

https://minecraft.wiki/w/NetherNet

NetherNet 是 Minecraft 的点对点网络传输层,构建于 WebRTC 之上。客户端使用 WebRTC 数据通道与服务器交换游戏数据。通过 HTTP 信令,连接先经由 HTTP 请求进行协商,随后在客户端与服务器之间直接建立。

HTTP 信令

客户端使用两个 HTTP 端点。一次成功的能力检查会告知客户端该服务器支持 NetherNet,并提供服务器详情。随后,客户端使用 SDP 交换端点来协商 WebRTC 连接。

能力检查

客户端发送 GET /v1/join。成功响应应具有 2xx 状态码、application/json 内容类型,以及一个包含服务器信息的 JSON 对象。非 2xx 响应表示 NetherNet 不可用,客户端不会继续连接设置。

字段

类型

描述

name

String

服务器名称。

protocol

Number

服务器支持的基岩版协议版本。

version

String

基岩版游戏版本。

level

String

已加载世界的名称。

players

Number

当前玩家数量。

maxPlayers

Number

最大玩家数量。

gameType

Number

默认游戏模式:0 为生存,1 为创造,2 为冒险。

SDP 交换

客户端每次连接尝试发送一个 HTTP 请求:

方向

方法与路径

内容类型

正文

客户端 → 服务器

POST /v1/join/{networkId}

application/sdp

完整的 SDP offer,包含 ICE 候选。

服务器 → 客户端

HTTP 2xx 响应

application/sdp

完整的 SDP answer,包含 ICE 候选。

{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 数据通道。主机会接受这两个通道,并可在其上发送和接收数据。

通道

传递保证

用途

ReliableDataChannel

可靠且有序

必须按顺序到达的数据。支持分片。

UnreliableDataChannel

不可靠且无序

对延迟敏感、可容忍丢失的数据。不支持分片。

不可靠通道将 maxRetransmits 设置为 0。

消息帧格式

每个数据通道消息以一个单字节头部开始。接收方在处理有效载荷之前会移除此字节。

头部值

含义

0

完整消息,或分片消息的最后一个分片。

N(N > 0)

分片,且其后还有 N 个分片。

未分片消息的头部值为 0。未分片有效载荷的最大值为协商的 SCTP 消息大小限制减去一个字节(用于头部)。在 ReliableDataChannel 上,超大消息会被拆分为分片,其头部值递减至零,接收方按顺序重组有效载荷。在 UnreliableDataChannel 上,头部始终为零;超大消息会被丢弃,而不是分片。

游戏数据

NetherNet 在其数据通道消息中承载基岩版游戏数据。游戏数据包格式记录于“基岩版协议/数据包”页面。

在基岩版中的使用

NetherNet 在 26.50 版本中成为基岩版专用服务器的默认传输方式。对 RakNet 连接的支持计划在 26.60 版本中终止。

原创

【MCBE】基岩版 NetherNet 网络协议

本文链接: 【MCBE】基岩版 NetherNet 网络协议

本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

评论交流

文章目录