玩家如何连接服务器
找到服务器连接地址,Java 版与基岩版客户端分别如何添加服务器,离线账号、白名单、额外端口以及连不上时的排查方法。
Minecraft · 更新于
找到连接地址
- 进入 我的实例,打开你的 Minecraft 实例。
- 切到「概览」标签,找到「玩家连接地址」卡片。
- 标有「主端口 · 玩家在游戏客户端填写的地址」的那一行就是玩家要填的地址,点「复制」即可。
地址的格式是 主机地址:端口,例如:
mc.example.com:31234
平台通过端口映射把服务器暴露到公网,外网端口是自动分配的,通常不是 25565 或 19132。下方列表中 25565 → 31234 这样的写法表示:服务端在容器内监听 25565,玩家从外网的 31234 端口进入。玩家只需要使用复制出来的完整地址,不要自己改成 25565。
更多端口相关说明见 网络与端口。
Java 版客户端
- 打开游戏,点击「多人游戏」。
- 点击「添加服务器」。
- 「服务器名称」随意填写,「服务器地址」粘贴完整的
主机地址:端口。 - 点击「完成」,在列表中选中服务器后点击「加入服务器」。
使用 Waterfall 或 Velocity 群组服时,玩家填写的是代理端实例的地址,而不是后端子服的地址。
基岩版客户端
适用于 Bedrock 和 NukkitX 核心,手机、Windows 版和主机版客户端都使用这种方式。
- 打开游戏,点击「游戏」,切到「服务器」标签。
- 滑到底部,点击「添加服务器」。
- 「服务器名称」随意填写;「服务器地址」只填冒号前面的主机地址;「端口」填冒号后面的数字。
- 保存后点击该服务器加入。
基岩版服务器使用 UDP 端口。部分主机平台的客户端不能直接添加自定义服务器,这属于客户端限制。
版本要对得上
| 核心 | 要求 |
|---|---|
| Java 版各核心 | 客户端版本要和服务端版本一致;模组服还需要安装相同的模组和加载器 |
| Bedrock | 客户端只能连接不低于自身版本的服务端。玩家客户端自动更新后连不上,就把实例的「Bedrock版本」改成更新的版本后重新安装 |
| NukkitX | 更新通常落后于官方客户端,新版客户端可能暂时无法连接 |
离线账号(非正版)进服
Java 版服务器默认开启正版验证,未购买正版的账号会被拒绝,提示无法验证用户名。如果要允许离线账号进服:
- 打开实例的「环境变量」标签。
- 将「正版验证」设为「关闭(允许离线账号)」,点击「保存变量」。
- 点击「重启」使配置生效。
关闭正版验证后任何人都可以冒用他人用户名进服,建议同时开启白名单,或安装登录类插件。各项参数的说明见 server.properties 与游戏参数。
基岩版对应的选项是「Xbox Live 验证」,关闭后玩家无需登录 Xbox 账号也能进服。
白名单
开启白名单后只有名单里的玩家可以进入:
- 在「环境变量」中把「白名单」设为开启(基岩版为「白名单(allow-list)」),保存后重启。
- 在「控制台」中添加玩家:
whitelist add 玩家名
whitelist remove 玩家名
whitelist list
基岩版服务端使用 allowlist add 玩家名,名单保存在 allowlist.json。
地图、语音等插件的额外端口
网页地图、语音聊天等插件会另外监听端口,需要在「网络」标签中开放:
- 打开实例的「网络」标签,找到「添加端口」。
- 「容器内部端口」填写插件配置中的监听端口,选择协议(网页地图一般为 TCP,语音一般为 UDP),可填写「备注(可选)」。
- 点击「添加端口」。平台会自动分配一个外网端口,在「端口列表」中可以看到对应关系。
如果插件要求内外端口号一致(例如需要把自己的端口告诉客户端),请改用「申请对等端口」,分配后把插件的监听端口改成该端口号。
每个实例最多添加 10 个自定义端口,TCP+UDP 计为 1 个。实例运行中添加端口会自动重启,在线玩家会短暂断开。
连不上时怎么查
| 现象 | 可能原因与处理 |
|---|---|
| 连接超时、找不到服务器 | 确认实例状态为「运行中」且控制台已出现启动完成提示;确认填写的是「玩家连接地址」里的完整地址和外网端口 |
| 刚开机就连不上 | 首次启动要生成世界,等控制台出现 Done (...)! For help, type "help" 再连接 |
| 提示版本不兼容 | 客户端与服务端版本不一致,调整客户端版本或在「环境变量」中修改核心版本后重新安装 |
| 提示无法验证用户名 | 使用了离线账号,参考上文关闭正版验证 |
| 提示不在白名单中 | 在控制台执行 whitelist add 玩家名 |
| 模组服连接时报缺少模组 | 客户端需要安装和服务端一致的模组和加载器版本 |
| 基岩版连不上 | 确认地址和端口分开填写;检查客户端版本是否高于服务端 |
如果以上都确认无误仍无法连接,请联系客服,并提供实例名称和连接时的报错截图。
