SakuraFrp 帮助文档

我的世界(Minecraft) 局域网联机穿透指南

非官方文档

SakuraFrp 不提供 Minecraft 服务器相关帮助，本文档主要由社区用户维护
如果您有相关问题建议到 MCBBS 你问我答板块在新窗口打开 提问

常见问题

我还是进不去服务器 / 用不了 / 进服时报 XXX 错误怎么办

第一次开服能用，怎么现在就不行了 / 报错 “请检查本地服务是否可访问”

基岩版或 Geyser 联机和开服

请参阅 Minecraft 基岩版开服指南 | Geyser 互通开服指南 以开启服务器

Java 版局域网联机

Minecraft 局域网联机穿透通常需要安装 Mod 辅助，下面是装与不装的区别:

  • 不装辅助 Mod: 适用于同类型已验证账号之间的联机 (如正版和正版、外置和外置)
  • 安装辅助 Mod (推荐): 适用于离线账号或不同类型账号之间的联机，如不安装，则会出现 “无效会话” 问题

不装辅助 Mod

进入要联机的存档，按下键盘上的 ESC 键，在出现的界面里找到 对局域网开放 之类的按钮并且点击进入，对 其他玩家 进行设置，然后点击 创造一个局域网世界

在聊天框里会提示 本地游戏已在端口 xxxxx 上开启 ，这个 五位数的端口号 对应的是 创建隧道 里的 本地端口

提示

这个 五位数的端口号 并不固定，如果您想获取一个固定的端口号，就需要 安装辅助 Mod

上图中，我们获取到的端口号为 61259

成功获取到端口号后，我们就可以开始 创建隧道 了。

安装辅助 Mod

注意

通过辅助 Mod 关闭正版验证 可能 会改变玩家的 UUID 导致 背包内物品和玩家数据丢失，请关闭正版验证前 备份存档
所有辅助 Mod 都 不能 互相兼容，请勿 重复 添加联机模组

请根据您的游戏版本展开下面的选项查看，下面提到的 Mod 都必须在 联网 条件下安装:

游戏版本: Forge: 1.15.2 ~ 1.20.1, Fabric: 1.15.2 ~ 1.20.1, Quilt: 1.15.2 ~ 1.20.1

使用方法

  1. 安装 Mod 并进入游戏，打开您要联机的 存档
  2. 按下键盘上的 ESC 键，在出现的界面里找到 对局域网开放 之类的按钮并且点击进入
  3. 对 其他玩家 进行设置，同时安装此 Mod 后 设置局域网世界 界面后会增加下列选项，请按需配置:
    • 端口号: 随机五位数可以固定端口，此端口对应的就是创建隧道里的本地端口
    • 允许玩家数: 10 允许的最大在线玩家数
    • 服务器信息: A Minecraft LAN World 即为 MOTD 。对应其他人在多人游戏列表里看到的服务器介绍
    • 正版验证: 开/关 关闭可以让离线账号玩家或其他账号和您联机 此模组的其他功能请在游戏内将鼠标指针指向按钮获得详细提示。

提示

这个模组在使用的时候会在聊天栏提示 “端口映射失败，请使用内网映射软件” “获取IP成功：内网IPv4” 等其他功能的运行状态，如果您没有公网IP的话请 忽略 这些提示。
您的客机需要连接的IP会输出在启动器或frpc的日志中。

  1. 点击 创建局域网世界，在聊天栏中会提示 本地游戏已在端口 xxxxx 上开启，这个五位数的端口号就会固定为您设置的端口号。对应您在创建隧道时的本地端口选项。
游戏版本: Forge: 1.12.X ~ 1.20.1, fabric: 1.16.1 ~ 1.20.1

提示

此模组有部分版本可能会有不兼容问题，详情参考 mcmod在新窗口打开 模组页面下方的注意列表。

此 Mod 在游戏版本 1.16.5 + 高版本 Java 运行时会出现问题在新窗口打开，如果您需要 1.16.5，请使用 Java 8/11

使用方法

  1. 安装 Mod 并进入游戏，打开您要联机的 存档
  2. 按下键盘上的 ESC 键，在出现的界面里找到 对局域网开放 之类的按钮并且点击进入
  3. 对 其他玩家 进行设置，同时安装此 Mod 后 设置局域网世界 界面后会增加下列选项，请按需配置:
    • 在线模式: 开/关
      关闭可以让离线账号玩家或其他账号和您联机
    • 监听端口: 25565
      可以固定端口，监听端口对应的就是创建隧道里的本地端口
  4. 点击 创造一个局域网世界，在聊天框里会提示 本地游戏已在端口 xxxxx 上开启，这个 五位数的端口号 就会变成您设置的 监听端口

提示

在部分版本可能需要客户端也添加此模组才能加入利用此模组进行联机的主机。

游戏版本: Forge: 1.7.X ~ 1.12.X, 1.13 ~ 1.20.X
  • Mod 名称: Server.Properties for LAN
  • Mod 功能:
    1. 玩家挂机多久后踢出
    2. 服务器资源包
    3. 固定端口
    4. 最大视距
    5. 是否开启正版验证
    6. 是否生成生物，最大玩家数
    7. 玩家之间是否可以造成伤害
    8. 是否开启白名单
    9. 是否生成村民
    10. 最大建筑高度
    11. Motd设置
  • 下载链接 (1.7.X ~ 1.12.X): CurseForge在新窗口打开 | MC百科在新窗口打开
  • 下载连接 (1.13 ~ 1.20.X): Github在新窗口打开
  • 下载链接 (全版本，搬运有延迟，无法访问以上网站再考虑): MeteorMC在新窗口打开

使用方法

  1. 安装 Mod 并进入游戏，打开您要联机的 存档 (必须要先打开一次存档才会生成 server.properties 文件)

  2. 打开 存档文件夹 里的 server.properties 文件进行编辑，下面有对各个选项的翻译

    提示

    ESC - 选项 - 资源包 - 打开资源包文件夹
    返回上一级 - 打开saves文件夹 - 找到您要联机的存档的名字并双击进入
    里面有一个 server.properties 文件，请使用文本编辑器软件打开。
    建议使用 Visual Studio Code在新窗口打开 或者 Sublime Text 3在新窗口打开 等专业文字编辑器

  3. 编辑完成后重新打开地图即可刷新配置

    提示

    server.properties 文件编辑完以后下一次使用 这个存档 联机就不用再次编辑了
    如果 换了个存档 联机，就需要 重新编辑 或者复制之前的配置过来
    您也可以编辑 config 文件夹（与 save 文件夹同级）中的 serverGlobalConfig.properties 文件，里面的参数会影响 以后新建的存档

  4. 现在请参考 不装辅助 Mod 一节开启局域网联机

server.properties 配置文件翻译如下

提示

fandom Minecraft Wiki在新窗口打开 中有对配置文件更详细的解释

player-idle-timeout=<Int>
# 玩家挂机多久后踢出
# 0为禁止该功能

resource-pack=
# 服务器资源包 (没有请留空) 

port=<Int>
# 端口，对应Frp设置中的本地端口
# 0为随机

max-view-distance=<Int>
# 最大视距
# 0为不限制

online-mode=<Boolean>
# 是否开启正版验证
# "true"(真)为开启, "false"(假)为关闭
# 如果要和非正版玩家，请关闭

spawn-animals=<Boolean>
# 是否生成生物
# "true"(真)为开启, "false"(假)为关闭

pvp=<Boolean>
# 玩家之间是否可以造成伤害
# "true"(真)为开启, "false"(假)为关闭

max-players=<Int>
# 最大玩家数

white-list=<Boolean>
# 是否开启白名单
# "true"(是)为开启, "false"(否)为关闭

spawn-npcs=<Boolean>
# 是否生成村民
# "true"(是)为开启, "false"(否)为关闭

max-build-height=<Int>
# 最大建筑高度
# 不能超过游戏限制 (低版本为256)

resource-pack-sha1=
# 资源包哈希 (没有请留空) 

motd=
# Motd设置
# 默认会生成一个，可以自己设置

创建隧道

当您获取到了 本地端口 后，您就可以开始 创建隧道 了

隧道配置如下：

  • 隧道名称：填上您对此隧道的命名
  • 隧道类型：TCP 隧道
  • 本地 IP：127.0.0.1
  • 本地端口：您在以上章节获取的本地端口号

如非必要，其他设置保持默认。

提示

设置完后开启隧道，日志中会出现一行 “使用 [frp-xxx.top:xxxxx] 来连接到你的隧道” 的提示，客机使用这个连接 (frp-xxx.top:xxxxx) 来加入游戏。

设置 SRV 解析

提示

设置 SRV 解析 只是为了美观，并非必须。设置后，在游戏中添加服务器时，无需填写端口号
配置 SRV 记录后使用 ping 命令是 无法测试 连通性的，但是在游戏中填上就可以正常使用
需要留意的是，只有 Minecraft Java 版支持解析 SRV 记录，基岩版并不支持此特性

这一节文档会教您如何在部分域名注册商的面板中为 Minecraft Java 版 配置 SRV 解析。

要进行 SRV 解析，您就必须要有一个域名，本文档不会推荐您使用哪个注册商的域名，请自己选择。

如果您正在使用文档未覆盖到的注册商，并且会在对应面板中进行 SRV 解析，欢迎点击页面底部的编辑按钮帮助我们完善该文档。

点击 这里在新窗口打开 进入 阿里云 的 域名列表，如果您 没有登录，请登录

找到您想要进行 SRV 解析的域名，点击 最后一栏 操作中的解析

点击 添加记录

按下表进行填写，然后点击 确认 即可

字段填写内容说明
主机记录_minecraft._tcp.xxxx 可以自定义，亦可去除 .xx。
记录类型SRV
记录值0 5 远程端口 节点域名例: 0 5 12345 idea-leaper-1.natfrp.cloud

保存完毕后需要 等待 10 分钟来让解析生效 (按照您设置的 TTL 来决定，一般为 10 分钟) 。

  • 假设 您的域名为: example.com，您的 .xx 设置为 .sub，那么在游戏中添加服务器时，使用 sub.example.com 地址即可连接。
  • 假设 您的域名为: example.com，您把 .xx 去掉了，那么在游戏中添加服务器时，使用 example.com 即可连接。