查询结果包含什么
输入地址,选择版本,然后点击查询。每个版本都会得到一张卡片,包含:
- 在线或离线,离线时还会给出最可能的原因。
- 服务器列表条目,按游戏的方式绘制:图标、用游戏字体和颜色显示的 MOTD、玩家人数和信号格。离线的服务器会显示和游戏里一样的红色“无法连接至服务器”。
- 版本和协议。 版本是服务器报告的名称,在代理端和 Paper 分支上通常是自定义文字,比如
Velocity 3.4.0或Paper 1.21.4。协议是一个数字,客户端拿它和自己的协议号比较,决定能否加入。 - 玩家,包括在线人数和上限;Java 版还会显示服务器在玩家样本中列出的名字。很多服务器会在这个列表里填上彩色文字而不是真实玩家名,工具会原样绘制它们。
- Java 版的 SRV 目标,或者响应的端口。
复制会把一段简短的总结放到剪贴板,可以直接发到 Discord。复制分享链接给出的链接打开时会执行同样的查询。
Java 版与基岩版
两个版本使用的协议不同,所以一个服务器可能在一个版本上在线,在另一个版本上不在线。
| Java 版 | 基岩版 | |
|---|---|---|
| 默认端口 | 25565 (TCP) | 19132 (UDP) |
| SRV 记录 | 支持,_minecraft._tcp |
不支持 |
| 服务器图标 | 支持,64×64 PNG | 不支持 |
| 列表中的玩家名 | 支持,显示部分样本 | 不支持 |
装了 Geyser 的 Paper 或 Spigot 服务器两个版本都会响应:Java 版走常用端口,基岩版走 Geyser 的端口。选择“Java + 基岩版”可以同时看到两者。如果 Java 版卡片在线而基岩版不在线,问题出在 Geyser 这边:它的端口、UDP 转发,或者主机只开放了 TCP。
服务器为什么显示离线
按顺序逐一排查:
- 服务器没有运行,或者还在启动中。世界加载完成后服务器列表才会响应。
- 地址或端口错误。 如果用的是服务器主机,面板上会显示准确的地址和端口。非默认端口必须手动输入:
play.example.com:25566。 - 端口没有开放。 在家开服时,要在路由器上把端口转发到运行服务器的机器,Java 版用 TCP,基岩版用 UDP。然后在那台机器的防火墙中放行。
- server.properties 中设置了
server-ip,而机器上并没有这个地址。除非你确定需要,否则请留空。 - server.properties 中的
enable-status=false会让服务器在所有服务器列表中隐藏,包括这个查询工具。 - 服务器屏蔽了数据中心。 反机器人插件、防火墙和一些大型服务器会丢弃不是来自家庭宽带的连接。玩家照样能进游戏,但状态查询工具会看到服务器离线。
SRV 记录
SRV 记录让玩家可以用 play.example.com 进服,而服务器实际运行在另一台主机或另一个端口上。在你的 DNS 服务商处创建:
| 字段 | 值 |
|---|---|
| 名称 | _minecraft._tcp.play(对应 play.example.com) |
| 优先级和权重 | 0 和 5 |
| 端口 | 服务器的端口,比如 25566 |
| 目标 | 服务器所在的主机,比如 node3.host.com |
只有 Java 版会读取 SRV 记录。基岩版玩家必须自己输入地址和端口,所以基岩版服务器通常保持在 19132。