常见问题与排障

说明本地游戏的联机通道没起来，按顺序检查：

1. 房主必须先在 MC 里进入世界并点击「对局域网开放」，客户端才有端口可转发。
2. 看客户端状态是不是「已连接」。显示「连接中」说明中继或 P2P 还没打通，等 10~20 秒。
3. 加入端在 MC 里添加的服务器地址必须是 127.0.0.1，端口用客户端显示的那个端口（不是 25565 就是对的，以客户端为准）。
4. 加入端电脑上装了别的联机软件（某些加速器、某些 VPN）可能占用回环地址，先关掉再试。

通常是双方 MC 版本或加载的模组不一致。

• 房主和加入者的 MC 主版本必须一致（例如都是 1.20.1）。Forge/Fabric 整合包要同一套模组、同一版本。
• 纯净版进带模组的世界会卡住或直接断开，反过来也一样。
• 确认一下谁在世界里：单人存档对局域网开放时，房主不能退出世界。

先看客户端「设置 → 联机模式」：

• P2P 直连：延迟最低，两边 NAT 类型不好时可能打不通。
• 中继：一定能连，但绕服务器一圈，延迟略高。
• 双路（默认）：先试 P2P，失败自动走中继。

跨运营商（电信 ↔ 移动）互连容易抖，VIP 精品线路就是为这个场景准备的。

能。双路模式下房主会同时拿到一个中继地址，不装客户端的朋友在 MC 多人游戏里直接填这个地址就能进；装了客户端的朋友走 P2P，延迟更低。

• 房间码 4 位，区分大小写，让朋友直接复制粘贴，别手打。
• 房间只在房主客户端运行且心跳正常时有效，房主关掉客户端房间就销毁了，需要重新建房拿新码。
• 房主长时间无操作（约 2 分钟没有心跳）房间会自动过期，重新建房即可。

加入端每 15 秒探活一次，房主关房后十几秒内会收到「房主已退出」的提示。看到提示直接退到主界面，等新房主的房间码。

建房后点客户端里的「玩家」按钮，会列出当前房间的成员，房主前面带 ★。加入端同样能看。

• 用户名和邮箱是两个不同的登录方式，确认没混用。
• 密码区分大小写，输入法别停在中文状态。
• 确实忘了密码 → 用注册邮箱自助重置。

• 先翻垃圾邮件 / 推广邮件文件夹，发件人不是常见域名，容易被拦。
• 同一邮箱有发送间隔限制，60 秒内重复点会失败，等一会儿再点。
• 换个邮箱注册也行，账号和 VIP 是绑在账号上的，邮箱只用于找回。

登录状态只存在本机，换电脑/重装客户端需要重新登录一次。VIP 天数跟着账号走，不会丢。

客户端没有购买代码签名证书，Windows 会对所有未知发布者的 exe 弹这个窗。不是病毒。

1. 点提示框里的「更多信息」。
2. 点「仍要运行」。

最常见的原因是只拿了 exe，没拿整个文件夹。客户端由三部分组成，缺一不可：

• StarryNet.exe — 启动器
• app\ — 程序本体
• runtime\ — 内置运行环境（不用自己装 Java）

正确做法：下载整个 zip，解压出完整文件夹，再双击里面的 exe。别单独把 exe 拖到桌面。

新版客户端启动时自动检查更新，检测到新版本会提示，确认后自动下载并替换、重启，不用手动解压。

也可以去 GitHub Releases 手动下最新版覆盖。

能连，但服务端可以设置最低版本。低于限制时客户端会锁住建房/加入并提示更新，界面还能打开。遇到这种情况直接更新即可。

• 客户端：设置 → 卡密兑换
• 网页：用户中心 → 充值 VIP

兑换成功后 VIP 天数立即到账，客户端重启后生效。

• 卡密是 16 位，注意不要带上前后空格，复制时容易带。
• 一张卡只能用一次，重复兑换会提示已被使用。
• 确认没输错还报错，进 QQ 群 275390546 私信管理员，带上购买时间和卡密截图。

免费线路永久可用，功能不缺。VIP 只影响线路质量：精品节点、跨网更稳、高峰期排队优先级更高。

tar xzf StarryNet-*-linux64.tar.gz
cd StarryNet
./bin/StarryNet

需要图形桌面环境（X11 / Wayland），纯命令行的服务器跑不了界面。

解压后执行位丢了，补一下：

chmod +x bin/StarryNet app/frpc/frpc app/easytier/easytier-core