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

非官方文档

SakuraFrp 不提供 Minecraft 服务器相关帮助，本文档主要由社区用户维护

常见问题

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

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

基岩版或 Geyser 联机和开服

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

Java 版局域网联机

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

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

不装辅助 Mod

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

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

提示

这个 五位数的端口号 并不固定，如果您想获取一个固定的端口号，就需要 安装辅助 Mod
在 1.20.1+ 版本的游戏中，您可以在局域网联机界面输入端口号来让游戏在特定端口上开放。

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

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

安装辅助 Mod

注意

通过辅助 Mod 关闭正版验证 可能 会改变玩家的 UUID 导致 背包内物品和玩家数据丢失，请关闭正版验证前 备份存档
所有辅助 Mod 都 不能 互相兼容，请勿 重复 添加联机模组 请务必 严格按照 辅助 Mod 中的使用方法操作，尤其是正版验证选项

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

游戏版本: Forge: 1.15.2 ~ 1.20.4, Fabric: 1.15.2 ~ 1.20.4, Quilt: 1.15.2 ~ 1.20.4, NeoForge: 1.20.2 ~ 1.20.4

使用方法

  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.2, fabric: 1.16.1 ~ 1.20.2

提示

此模组有部分版本可能会有不兼容问题，详情参考 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在新窗口打开

使用方法

  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 配置文件部分选项翻译如下

提示

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) 来加入游戏。

Java 版服务器部署

此段落希望为在 Windows 下部署 Java 版 Minecraft 的服务端的用户提供一些信息。

安装对应版本的 Java

推荐按照下述表格安装：

如果存在问题，如果您已经在使用 Java 8，请尝试更高版本的 Java；
如果您在使用最新版 Java，请尝试更低版本的 Java。

服务端推荐的 Java 版本下载地址
1.17 前的 Forge 服务端
1.12 前的其他服务端		最新版本 Java 8Java 官网在新窗口打开
其他服务端Java 21+微软构建的 OpenJDK在新窗口打开

准备服务端文件

请首先确认需要的服务器类型：

  • 纯净服：基于原版游戏的服务器
  • 插件服：运行服务端插件的服务器，拥有基于原版的扩展体验
  • Mod 服：运行 Mod 的服务器，拥有超越原游戏内容的体验

纯净服

您可以在 官网在新窗口打开 下载到最新的服务端 jar 文件。

您也可以在 MCVersions在新窗口打开 或者 MCBBS 下载到服务端 jar 文件。

插件服

比较常用的插件服务端有 Paper在新窗口打开，Spigot在新窗口打开 等。

您可以前往对应官网下载插件服的服务端。

Forge Mod 服

前往 Forge 官网在新窗口打开 下载您需要的版本的 Forge 安装器（installer）。

双击运行下载到的安装器 Jar 文件，您会看到如下界面：

选择第二项 Install Server，下方 ... 点击后选择您希望存储服务器文件的目录。

安装器会为您从微软官网下载服务端文件，并将 Forge 安装到服务端文件中。

Fabric Mod 服

前往 Fabric 官网在新窗口打开 下载对应版本的 Fabric 服务端安装器。

将下载到的 jar 文件移动到您希望存储服务端文件的目录，双击运行。

fabric 安装器将会开始下载文件，您可能看不到任何进度，但是能看到一个 .fabric 文件夹被创建出来。

其他

此处仅为一些示例，各类服务端分支使用方式大同小异。

准备开始

通常在 Windows 下，人们倾向于使用 bat（批处理）脚本运行 Minecraft 服务端。

您可以在存储服务端文件的目录中创建一个 启动.bat，其中包含以下内容：

java <Java 参数> -jar <服务端文件地址> <服务端参数>

Forge 服务端除外

通过 Forge 安装器安装的服务端通常已经自带启动文件，只需双击 run.bat 即可运行。
您可以在服务端目录中找到 user_jvm_args.txt 并在其中设置 Java 参数。

Java 参数

最简单的 Java 参数模式为： -Xmx4G -Xms4G，即初始堆内存 4G，最大堆内存 4G，
我们推荐这两个值相等并且不高于您空闲内存的一半，从而最小化 GC 带来的延迟。

对于 OpenJDK 9 以上的 Java， G1GC 已经被默认启用并且根据运行情况自动调整，我们建议不要盲目从网上抄参数加进去运行。

如果您确实可能遇到了 GC 带来的瓶颈，请参考 Oracle 的 G1GC 调优指南在新窗口打开。

服务端文件地址

通常为 ./服务端文件.jar。

服务端参数

您可以在这里写一个 nogui，启动后即可喜提黑框框后台。

如果不写会显示一个白色的基础信息展示页面，同样可以运行后台指令。

运行服务端

同意服务端协议

运行一次您的启动文件（如 启动.bat），此时您会发现程序立即退出，工作目录下多了一些文件，
打开其中的 eula.txt，其内容为 Minecraft 的 EULA 文档，将其中的 false 字样改为 true。

提示

EULA 即 Minecraft 的用户许可协议，您的修改即表示签署了该协议。

此行为表示您在法律意义上认可了 Mojang 附条件地授权您使用 Minecraft 服务端， 使用服务端时必须遵守 Minecraft 使用准则在新窗口打开。

修改配置

按需调整服务器配置文件，例如 server.properties。

插件服和 Mod 服可以将从网上下载的插件及 Mod 放置到服务器工作目录下的 plugins 和 mods 目录中。

再次运行启动文件即可正式启动服务端，这一次启动时服务端会生成世界，启动时间可能会稍长。

配置内网穿透

创建隧道 并打开隧道。

愉快地开始联机吧 😃

设置 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 即可连接。