用SRV记录连接Minecraft非默认端口

游戏服已经能用“IP:端口”连接,但希望玩家只输入一个域名,可以配置 SRV。它向支持该记录的 Minecraft Java 客户端提供目标主机和端口,不负责转发流量,也不会自动开放防火墙。

以下以原版 Java 版 26.3 的已开服环境为例,客户端与服务端版本一致;不是基岩版或任意第三方启动器的通用配置。首次开服先完成Minecraft Java安装与首次联机。本文只演示一个目标,不用多条 SRV 设计负载均衡。

先确定玩家真正连接的入口

记录已验证可用的公网地址与端口。假设玩家当前填写的是 203.0.113.10:25570,准备改成 play.example.com。这些是文档示例,发布前全部换成自己的值。

25570 指玩家从外部访问的端口。如果使用 NAT,外部 25570 映射到服务器内部 25565,SRV 应填 25570,而不是照抄 server.properties 的内部监听值;若直接公网监听,就核对实际开放的游戏端口。两者关系不清时先停在原地址联机测试,不靠改 DNS 猜测。

两条记录分别解决名称和端口

在当前有效的 DNS 区域 example.com 中配置下表。已有同名记录先保存内容并核对用途,不覆盖其他游戏或网站入口:

完整名称 类型 示例内容
play.example.com A 203.0.113.10
_minecraft._tcp.play.example.com SRV 优先级 0,权重 0,端口 25570,目标 play.example.com.

面板若自动补上 example.com,名称通常分别填 play与 _minecraft._tcp.play;若拆成服务、协议和名称,则对应 _minecraft、_tcp、play。保存后核对最终完整名称,避免下划线丢失或域名后缀重复。

SRV 目标填写完整主机名,不填 IP、URL 或“主机名:端口”;端口有独立字段。目标名称需要自己的 A/AAAA 地址记录,不能用 CNAME 别名充当 SRV 目标。本例直接以 play 的 A 记录作为目标,无需再加一层 CNAME。

只有一条 SRV 时,优先级和权重都设为 0 即可表达本例。按标准,优先级数值较小的优先,权重用于同优先级候选之间的选择;它不是带宽比例或在线人数配额,也不能据此承诺所有客户端都按预期分流。目标写成单独一个点表示服务不可用,不是“使用当前域名”。

查询时要查完整的SRV名称

在玩家电脑所在网络查询。Linux 或 macOS 使用 BIND dig 9.20 语法:

dig -r _minecraft._tcp.play.example.com. SRV +timeout=3 +tries=1
dig -r play.example.com. A +timeout=3 +tries=1
dig -r play.example.com. AAAA +timeout=3 +tries=1

第一条 ANSWER 中应出现下列四个关键字段;前面的 TTL 可与示例不同:

_minecraft._tcp.play.example.com. 600 IN SRV 0 0 25570 play.example.com.

接着确认目标 A 地址正确。没有部署 IPv6 时,不要求一定有 AAAA;已有 AAAA 却指向无法联机的地址,应查清后修正。只查询 play.example.com的 A,或用 ping 看地址,都没有检查到 SRV 中的端口。

目标返回多个地址时,逐个确认对应端口通向计划中的游戏入口,不要只测其中一个正常地址就结束。旧 IP 仍混在记录里,可能让部分玩家进入旧服;清理前先确认它是否仍承担业务,并保留原记录用于回退。

Windows 可在终端查询同一完整名称:

nslookup -type=SRV _minecraft._tcp.play.example.com

输出应列出 priority、weight、port 和目标主机名。无结果时保留状态和 DNS 服务器信息:名称不存在、空答案、SERVFAIL 与超时不是同一故障。再向承载该记录的实际权威 DNS 核对;权威已更新但玩家网络仍旧,可按DNS缓存排查处理,不反复修改同一条记录。

用游戏客户端完成最后一步

在 Java 客户端“多人游戏”的添加服务器或直接连接入口,填写 play.example.com,不带协议、路径或手写端口。先确认服务器列表信息与预期一致,再实际进入正确世界;列表显示在线还不代表登录、版本和白名单都通过。

域名失败而已知正确的公网 IP 加端口仍可联机时,重点比较玩家使用的 DNS、SRV 完整名称、目标地址和客户端版本。两种方式都失败则回到游戏监听、映射与网络检查。某些状态查询工具只测 A 记录或固定端口,不能用其“离线”结果直接推翻实际联机验证。

记录修改前后的两条 DNS、TTL 和测试时间。需回退时只恢复本次变更的记录,并继续保留原有可用入口;缓存过渡不保证立即结束。增加 SRV 不需要改存档、关闭正版验证或重新创建服务器。