连接时请先使用面板中显示的服务器地址和端口。默认端口只是对协议的说明,并不能替代具体的端口分配。如果加入失败,请先检查服务器启动状态、客户端和地址,然后再修改网络规则。

从左至右:排查原因、保护初始状态、仅编辑副本并检查结果。
从左至右:排查原因、保护初始状态、仅编辑副本并检查结果。

区分两种游戏连接方式

连接方式 常见默认值 对你的服务器起决定作用的因素
Java 版玩家 TCP 25565 显示的 Java 版地址和分配的 TCP 端口
Bedrock 版玩家 UDP 19132 显示的 Bedrock 版地址和分配的 UDP 端口
通过 Geyser 使用的 Bedrock 版 独立的 UDP 入口 实际的 Geyser 配置和端口分配
RCON 独立的远程管理功能 正常游戏并不需要

Paper 配置参考和BDS 参考描述了服务器参数。开放的 TCP 端口并不能证明 Bedrock 版的 UDP 入口可以正常工作。

RCON 不是额外的游戏端口。不要为了尝试修复失败的加入而开放这个管理入口。可选的网页地图同样拥有自己的连接方式,对于正常的 Minecraft 登录来说并非必需。

按以下顺序进行检查

  1. 在面板中打开正确的服务器。它的安装是否已完成,进程是否确实已启动?
  2. 查看控制台的启动日志。缺少模组或存在端口绑定错误的服务器无法可靠地接受连接。
  3. 比较版本类型(Edition)和支持的客户端版本。对于整合包,必须启动指定的客户端实例。
  4. 从面板中准确复制地址和端口。不要误用 SFTP、网页或管理相关的数据。
  5. 测试一次新的连接,并记录准确的错误信息、时间和时区。

对于附加的 Java 版端口,地址示例形式类似 play.example.net:25570。这只是示例,并非你服务器的实际地址。Bedrock 版根据客户端不同,会提供分别填写地址和端口的字段。不同游戏主机在能否添加自定义服务器方面存在差异。

将错误信息作为排查线索

观察到的现象 下一步合理的检查
主机名未知 拼写和 DNS 解析
连接被拒绝 启动状态、分配的端口和正在监听的服务
连接超时 相应协议的可达性和网络路径
客户端或服务器版本过旧 双方支持的版本
白名单或封禁提示 相关账户的准入规则
模组握手失败 整合包、加载器和共同的玩法模组

这些信息只是线索,并不是确切的远程诊断结果。请与另一名玩家进行比较:如果只有一个账户失败,通常先对服务器进行大幅改动并非最合理的第一步。如果直接使用地址和端口可以正常连接,但自有域名不行,那就应重点排查 DNS。

自有域名与 SRV 记录

Java 版的 SRV 记录可以指向正确的目标主机和端口。示例域名的典型格式如下:

_minecraft._tcp.play.example.net. 3600 IN SRV 0 0 25570 node.example.net.

目标主机必须能够正确解析。该记录本身不会开放端口,也不能替代可访问的服务器分配。设置时请参考指南连接自有域名,之后再用一次全新的连接尝试进行测试。DNS 缓存可能会保留旧的解析结果。

不要把这种 Java 版的做法当作通用的 Bedrock 版解决方案。在 Bedrock 版中,请使用相应客户端所记载的地址和明确指定的端口。使用 Geyser 时,你需要一个真正可访问的 Bedrock 版入口;仅仅在文本文件中随意填入一个空闲端口是不够的。

租用的服务器还是家庭服务器?

使用租用的服务器时,通常不需要在你的家庭路由器上设置端口转发。服务器位于主机商那里。如果服务器已成功启动,但面板中显示的地址仍无法访问,请向技术支持提供具体的错误信息和发生时间。

对于自行搭建的家庭服务器,还需要考虑公网可达性、路由器分配和防火墙。只需为正确的内部主机开放必要的连接。私有局域网地址在你的网络之外并不是一个公网可访问的目标。在存在运营商级 NAT 的情况下,仅靠路由器端口转发可能是不够的。

不要为了绕过网络故障就一律关闭防火墙、杀毒软件或账户验证。也不要为此更改 online-mode。这样做会改变登录方式,并可能影响玩家数据的对应关系。

哪些信息有助于技术支持进行诊断

请记录服务器、版本类型(Edition)、客户端和服务器版本、准确的错误信息、发生时间、使用的地址类型,以及是否有其他玩家也受到影响。请附上控制台中相关的启动和连接日志行。请勿透露密码、会话代码或访问密钥。

如果确实是启动错误,可参考 Paper 错误诊断。如果是整合包相关的问题,整合包加入指南比进一步更改端口更为合适。

FAQ

我的 Java 版服务器一定要使用 25565 端口吗?

不一定。起决定作用的是分配给你的连接信息。如果使用其他端口,你可以直接标明该端口,或设置相应的域名解析。

在线端口检测工具能证明 Bedrock 版可以正常连接吗?

只有当该工具确实合理地检测了实际的 Bedrock 版连接时才可以。普通的 TCP 检测对 UDP 几乎说明不了什么。请使用相应的 Bedrock 版客户端进行测试。

玩游戏需要 RCON 吗?

不需要。RCON 是一项管理功能,并不属于解决普通连接错误的手段。

相关指南

本指南的其他语言版本

Deutsch · English · Español · Français · Nederlands · Português · Русский