StealthPipe
StealthPipe 是一款可靠的 Minecraft 模组,允许其他人通过互联网加入你的局域网世界。即使在限制严格的网络环境下也能使用 Secure WebSockets 正常工作,保持连接稳定,并且易于自行设置和托管。在网络条件有利的情况下,其速度可能比其他类似模组快多达 50%,从而提供更流畅、响应更快的多人游戏体验。
StealthPipe 仍处于 Beta 阶段。可能会出现边缘情况。
快速开始
快速开始游玩的步骤:
- 主机: 点击“向局域网开放”,然后分享生成的链接或代码。
- 加入: 访客输入链接(
XXXXXX.stealth.link)以在多人游戏菜单的“直接连接”中加入。
双方客户端都需要安装该模组。否则,将会显示“未知主机”(这是有意为之)。
默认中继仅适用于最新版本(主版本)的模组!
如果需要解决某些问题,可以在模组的配置中禁用在线模式。这原本仅用于开发目的。
如果无法工作,请尝试重新创建会话并加入。否则,你可以在问题跟踪器上提交问题。
⚠️ 地理位置 根据你的地理位置,如果模组回退到 WebSockets,你可能会遇到高延迟。中继服务器托管在美国弗吉尼亚州(美国东部集群)。请自行托管中继服务器或参见下文部分。
与 WebRTC 的平台兼容性 不幸的是,由于库的限制,iOS 和 Android 目前不支持 WebRTC。此问题将在未来得到解决。
更多信息
更多信息和重要注意事项
注意事项
与 E4MC 不同,StealthPipe 要求双方客户端都安装该模组,因为它完全重写了 Minecraft 的网络系统以配合 WebSockets 使用,从而实现上述优势。
3.0.0 版本引入了并行连接架构,使中继能够利用多核处理来显著加快数据包转发并提高水平扩展能力。
5.0.0 版本引入了数据包批处理系统(默认启用,可禁用),将大约同时发送的数据包(相差 1ms)进行批处理。这一措施将每秒数据包数量减少了约 10 倍(从平均每秒 500 个数据包降至每秒 50 个数据包)。较低的数据包速率使得连接具有更高的可靠性,并减少来自防火墙的随机丢弃。然而,这会带来额外的 8ms 至 30ms 延迟。此功能可在模组配置中禁用。截至 5.0.1 版本,额外延迟几乎消失,但在某些情况下仍可能存在 8-30ms 的额外延迟(可以通过重新加入来减少)。
6.0.0 版本在可能的情况下引入了点对点连接(WebRTC),将延迟降低多达 50%!
后端源代码可以在这里找到:
更多重要注意事项
-
2.1 MB 数据包大小限制:公共中继强制执行 2.1 MB 的数据包大小限制以确保稳定性。由于原版 Minecraft 默认限制为 2 MB,因此在安装少量模组时游玩通常没有问题。然而,这意味着像 Packet Fixer 或 XXL Packets 这样的模组在公共中继上将无法工作;中继会在模组绕过限制之前断开客户端连接。
如果你的整合包需要更大的数据包,则必须自行托管中继并在源代码中调整限制。
-
带宽消耗过多时的节流:为了保护服务器的带宽使用量,如果你发送了过多数据,你的连接可能会被节流或断开。阈值取决于持续高带宽使用的持续时间以及连接到当前世界的客户端数量。正常的原版游戏玩法永远不会触发此机制。你可以通过自行托管中继来解决此问题,参见上面的自托管部分。
-
工作量证明:为了防止自动化僵尸网络 spam 并导致免费公共中继崩溃(DDoS 保护),服务器需要一个“握手票据”。客户端通过解决一个小数学难题(SHA-256 哈希)生成此票据,也称为工作量证明。这确保了每个房间的创建都由真实计算机的努力支持,使得脚本极难每秒创建 10,000 个房间。
如果此模组变得过于流行,公共中继可能会进行升级。
为什么?
在许多网络环境中,点对点连接被阻止,除了 443 端口之外的大多数端口受到限制,例如在机场和酒店。由于 Minecraft 的“向局域网开放”依赖于直接连接和非 443 端口,因此在这种条件下根本无法工作。
此外,在这些地方中的许多地方,QUIC(流行模组 e4mc 背后使用的技术)也被阻止,但 e4mc 从根本上依赖于它。
StealthPipe 通过在 443 端口上的安全 WebSockets 隧道传输局域网多人流量来解决这个问题,允许玩家在传统局域网托管(和 e4mc)通常会失败的地方连接。
StealthPipe 是一个特定于协议的 relay;它只处理 Minecraft 游戏数据包,不能用作通用 VPN 或代理。它也无法连接到 Hypixel 等公共服务器。
如何?
它通过将 Minecraft 流量发送到 WebSockets 来实现这一点,使其看起来像正常的浏览器流量。此模组类似于 e4mc,但它通过 WebSockets 路由流量,而不是使用 QUIC。
技术概述可以在这里找到:
用法
- 主机: 点击“向局域网开放”,然后分享生成的链接或代码。
- 加入: 访客输入代码以加入。
- 要求: 所有玩家都必须安装该模组。
你可以在模组设置中配置要使用的中继。根据需要,可以使用第三方中继或自行托管。中继后端是开源的,采用 MIT 许可证。此模组中的默认中继完全免费使用。
自建中继
强烈建议自行托管您的中继以实现更好的控制与稳定性。该中继设计为易于移植,可通过 Docker 容器在任何环境中运行。整个中继仅由三个文件组成。 StealthPipe 中继采用多线程、轻量级且可移植的设计,内存占用低于 32 MB。
指南见此处:
替代中继
托管在 Render.com 上的默认中继有时可能因外部因素而缓慢或不可靠。默认中继作为概念验证部署于 Render 的免费套餐中;用户被鼓励自行托管以达到生产级别的稳定性。 如果默认中继出现问题,请尝试以下替代中继:
- 默认(有时离线):
- HF Space 中继(备用中继,可能较慢且延迟较高,可能离线):
模组兼容性
Krypton 可能会与 StealthPipe 产生一些问题。 尽管如果您能接受偶尔的连接断开,它仍然大部分可用。
此模组无法安装在专用服务器上。除此之外,它应与大多数内容模组兼容。
替代中继
如果默认中继离线,您可以使用其他中继。 查看列表,请前往“更多信息”下的“替代中继”部分。
自建中继
本模组强烈建议自建中继以确保稳定性和性能。
要托管:docker run -p 7860:7860 --name stealth-relay 0999847695359/stealthpipe-relay:latest
更多信息请参阅“更多信息”部分。
Forge/NeoForge 的后向移植与端口版本
请在 Issues 标签页中提交建议。
Bug 与问题
欢迎在 GitHub 仓库的 Issues 标签页中报告任何 Bug 或问题。
许可证
StealthPipe 遵循 MIT 许可证。
StealthPipe
StealthPipe is a reliable mod for Minecraft that lets others join your LAN worlds over the internet. It works even on restrictive networks using Secure WebSockets, keeps connections stable, and is easy to set up and host yourself. When network conditions are favorable, it can be up to 50% faster than other similar mods, giving you smoother, more responsive multiplayer.
StealthPipe is still in Beta. Edge cases are possible.
Quick Start
Steps to quickly start playing:
- Host: Press "Open to LAN" and share the generated link or code.
- Join: Guests enter the link (
XXXXXX.stealth.link) to join in the Direct Connection (in Multiplayer menu).
Both clients need to have the mod installed. Otherwise, it will say "Unknown Host" (this is intentional).
Default relays only work on the latest (major) mod version!
There's an option to disable Online Mode in the mod's config if needed to resolve issues. This was originally meant for development only.
If it doesn't work, try recreating the session and joining it. Otherwise, you may create an issue on the issue tracker.
⚠️ Geographical Location Depending on your geographical location, you may experience high ping if the mod is falling back to WebSockets. The relay is hosted in Virgina, US (US-East cluster). Host your own relay or see the section below.
Platform Compatibility with WebRTC Unfortunately, iOS and Android currently do not support WebRTC because of library limitations. This issue will be addressed in the future.
More Information
More information and important notes
Notes
Unlike E4MC, StealthPipe requires both clients to have the mod installed, since it completely rewrites Minecraft's networking to work with WebSockets in order to achieve the benefits listed above.
Version 3.0.0 introduces a parallel connection architecture, enabling the relay to utilize multi-core processing for significantly faster packet forwarding and improved horizontal scalability.
Version 5.0.0 introduces a packet batching system (enabled by default, can be disabled) that batches packets that are sent at around the same time (1ms difference). This measure reduces the packets per second count by around 10x (500 packets per second to 50 packets per second on average). The lower packets per second count allows the connections to have a higher reliability and less random drops from firewalls. However, this brings an additional 8ms to 30ms of ping. This feature can be disabled in the mod config. As of version 5.0.1, the additional latency is almost gone, but an 8-30ms added ping can sometimes still be present in some cases (can be reduced by rejoining).
Version 6.0.0 introduces peer-to-peer connections when possible (WebRTC), reducing ping by up to 50%!
Backend source code can be found here:
More Important Notes
-
2.1 MB packet size limit: The public relay enforces a 2.1 MB packet size limit for stability. Since Vanilla Minecraft defaults to a 2 MB limit, this limit is normally fine when playing with a minimal amount of mods. However, this means that mods like Packet Fixer or XXL Packets will not work on the public relay; the relay will disconnect the client before the mod can bypass the limit.
If your modpack requires larger packets, you must host your own relay and adjust the limit in the source code.
-
Throttling if consuming too much bandwidth: To protect the server's bandwidth usage, your connection may be throttled or disconnected if you are sending too much data. The threshold depends on the duration of sustained high bandwidth usage and the number of clients connected to the current world. Normal vanilla gameplay should never trigger this. You may resolve this by hosting your own relay, see the self-hosting section above.
-
Proof of Work: To prevent automated Botnets from spamming and crashing the free public relay (DDoS protection), the server requires a 'Handshake Ticket.' The client generates this ticket by solving a small mathematical puzzle (SHA-256 hashing), also called Proof of Work. This ensures that every room creation is backed by a real computer's effort, making it extremely difficult for a script to create 10,000 rooms per second.
The public relay may get upgraded if this mod starts becoming too popular.
Why?
In many network environments, peer-to-peer connections are blocked and most ports other than 443 are restricted, like in airports and hotels. Since Minecraft’s Open to LAN relies on direct connections and non-443 ports, it simply doesn’t work in these conditions.
Also, in many of these places, QUIC (technology used behind the popular e4mc mod) is also blocked, but e4mc fundamentally relies on it.
StealthPipe solves this by tunneling LAN multiplayer traffic through secure WebSockets over port 443, allowing players to connect where traditional LAN hosting (and e4mc) would normally fail.
StealthPipe is a protocol-specific relay; it only handles Minecraft game packets and cannot be used as a general-purpose VPN or proxy. It also cannot connect to public servers such as Hypixel.
How?
It achieves this by sending Minecraft traffic over WebSockets, making it appear as normal browser traffic. This mod is similar to e4mc, but it routes traffic through WebSockets instead of using QUIC.
Technical overview can be found here:
Usage
- Host: Press "Open to LAN" and share the generated link or code.
- Join: Guests enter the code to join.
- Requirement: All players must have the mod installed.
You can configure which relay to use in the mod settings. Use a third-party relay or host your own if needed. The relay backend is open-source and MIT-licensed. The default relay in this mod is completely free to use.
Self-Hosting a Relay
It is highly recommended to host your own relay for control and stability. The relay is designed to be easily portable and can run everywhere, regardless of the environment by using Docker containers. The entire relay consists of three files. StealthPipe relay is multithreaded, lightweight, and portable. It uses less than 32 MB of memory.
The guide is available here:
Alternative relays
The default relay hosted on Render.com can sometimes be slow and unreliable depending on external factors. The default relay is hosted on Render's free tier as a proof-of-concept; users are encouraged to self-host for production-level stability. Explore these alternative relays if you have issues with the default one:
- Default (sometimes offline):
- HF Space Relay (backup relay, probably slower and higher ping, may be offline):
Mod Compatibility
Krypton may cause some issues with StealthPipe. Although it remains mostly usable if you accept the occasional disconnects.
This mod cannot be installed on a dedicated server. Otherwise, it should be compatible with most content mods.
Alternative Relays
If the default one is offline, you can use another one. To see the list, go to the 'Alternative Relays' section under 'More Information'.
Self-Hosting
This mod strongly recommends self-hosting a relay for stability and performance.
To host: docker run -p 7860:7860 --name stealth-relay 0999847695359/stealthpipe-relay:latest
See 'More Information' section for more information.
Backporting and Ports for Forge/NeoForge
Please create a suggestion in the Issues tab.
Bugs and Issues
Feel free to report any bugs or issues in the Issues tab on the GitHub repository.
License
StealthPipe is licensed under the MIT License.
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
下载 StealthPipe
StealthPipe 6.2.3 for Minecraft 1.21.11
修复:
- 修复了由于状态管理不当,导致使用 WebRTC 连接的新玩家断开之前已使用 WebRTC 连接的旧玩家的问题。
- 修复了 F3 菜单中显示的模组版本与实际模组版本不一致的问题。
改进:
- 改进了配置项的描述说明。翻译可能滞后于新的描述内容。
- 改进了内部性能计数器的追踪机制。
- 大幅降低了数据包批处理循环中的 CPU 占用率,但会略微降低计时精度。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧