玩家如何连接服务器

找到服务器连接地址,Java 版与基岩版客户端分别如何添加服务器,离线账号、白名单、额外端口以及连不上时的排查方法。

Minecraft · 更新于

找到连接地址

  1. 进入 我的实例,打开你的 Minecraft 实例。
  2. 切到「概览」标签,找到「玩家连接地址」卡片。
  3. 标有「主端口 · 玩家在游戏客户端填写的地址」的那一行就是玩家要填的地址,点「复制」即可。

地址的格式是 主机地址:端口,例如:

mc.example.com:31234

平台通过端口映射把服务器暴露到公网,外网端口是自动分配的,通常不是 25565 或 19132。下方列表中 25565 → 31234 这样的写法表示:服务端在容器内监听 25565,玩家从外网的 31234 端口进入。玩家只需要使用复制出来的完整地址,不要自己改成 25565。

更多端口相关说明见 网络与端口。

Java 版客户端

  1. 打开游戏,点击「多人游戏」。
  2. 点击「添加服务器」。
  3. 「服务器名称」随意填写,「服务器地址」粘贴完整的 主机地址:端口。
  4. 点击「完成」,在列表中选中服务器后点击「加入服务器」。

使用 Waterfall 或 Velocity 群组服时,玩家填写的是代理端实例的地址,而不是后端子服的地址。

基岩版客户端

适用于 Bedrock 和 NukkitX 核心,手机、Windows 版和主机版客户端都使用这种方式。

  1. 打开游戏,点击「游戏」,切到「服务器」标签。
  2. 滑到底部,点击「添加服务器」。
  3. 「服务器名称」随意填写;「服务器地址」只填冒号前面的主机地址;「端口」填冒号后面的数字。
  4. 保存后点击该服务器加入。

基岩版服务器使用 UDP 端口。部分主机平台的客户端不能直接添加自定义服务器,这属于客户端限制。

版本要对得上

核心 要求
Java 版各核心 客户端版本要和服务端版本一致;模组服还需要安装相同的模组和加载器
Bedrock 客户端只能连接不低于自身版本的服务端。玩家客户端自动更新后连不上,就把实例的「Bedrock版本」改成更新的版本后重新安装
NukkitX 更新通常落后于官方客户端,新版客户端可能暂时无法连接

离线账号(非正版)进服

Java 版服务器默认开启正版验证,未购买正版的账号会被拒绝,提示无法验证用户名。如果要允许离线账号进服:

  1. 打开实例的「环境变量」标签。
  2. 将「正版验证」设为「关闭(允许离线账号)」,点击「保存变量」。
  3. 点击「重启」使配置生效。

关闭正版验证后任何人都可以冒用他人用户名进服,建议同时开启白名单,或安装登录类插件。各项参数的说明见 server.properties 与游戏参数。

基岩版对应的选项是「Xbox Live 验证」,关闭后玩家无需登录 Xbox 账号也能进服。

白名单

开启白名单后只有名单里的玩家可以进入:

  1. 在「环境变量」中把「白名单」设为开启(基岩版为「白名单(allow-list)」),保存后重启。
  2. 在「控制台」中添加玩家:
whitelist add 玩家名
whitelist remove 玩家名
whitelist list

基岩版服务端使用 allowlist add 玩家名,名单保存在 allowlist.json。

地图、语音等插件的额外端口

网页地图、语音聊天等插件会另外监听端口,需要在「网络」标签中开放:

  1. 打开实例的「网络」标签,找到「添加端口」。
  2. 「容器内部端口」填写插件配置中的监听端口,选择协议(网页地图一般为 TCP,语音一般为 UDP),可填写「备注(可选)」。
  3. 点击「添加端口」。平台会自动分配一个外网端口,在「端口列表」中可以看到对应关系。

如果插件要求内外端口号一致(例如需要把自己的端口告诉客户端),请改用「申请对等端口」,分配后把插件的监听端口改成该端口号。

每个实例最多添加 10 个自定义端口,TCP+UDP 计为 1 个。实例运行中添加端口会自动重启,在线玩家会短暂断开。

连不上时怎么查

现象 可能原因与处理
连接超时、找不到服务器 确认实例状态为「运行中」且控制台已出现启动完成提示;确认填写的是「玩家连接地址」里的完整地址和外网端口
刚开机就连不上 首次启动要生成世界,等控制台出现 Done (...)! For help, type "help" 再连接
提示版本不兼容 客户端与服务端版本不一致,调整客户端版本或在「环境变量」中修改核心版本后重新安装
提示无法验证用户名 使用了离线账号,参考上文关闭正版验证
提示不在白名单中 在控制台执行 whitelist add 玩家名
模组服连接时报缺少模组 客户端需要安装和服务端一致的模组和加载器版本
基岩版连不上 确认地址和端口分开填写;检查客户端版本是否高于服务端

如果以上都确认无误仍无法连接,请联系客服,并提供实例名称和连接时的报错截图。