饥荒联机版地面能进、洞穴进不去:核对双分片与存档
饥荒联机版专服的地面和洞穴通常由两个分片进程共同提供。能进入地面,只证明地面入口可用,不能证明洞穴进程、两者之间的连接和洞穴存档正常。本篇用于原来已经配置地面与洞穴的PC专服,不通过重建世界来处理连接问题。
先确认是哪一种现象
- 地面正常,但进入洞口时一直连接或被退回:记录具体时间与客户端提示。
- 启动时只出现一个进程或只有地面日志:先检查洞穴是否启动。
- 洞穴加载失败并持续退出:先看它自己的启动日志,不先扩大公网开放范围。
保留发生时间、当前游戏版本和原启动方式。不要连续重启整台服务器,避免地面玩家也丢掉未保存进度。
对照两个进程实际读取的位置
Klei专服使用-cluster指定集群,使用-shard指定分片。以同机部署为例,两份原启动命令应使用同一集群名,但分片分别对应原来的地面与洞穴目录:
| 进程 | 需要核对的参数 |
|---|---|
| 地面 | -cluster MyClusterName -shard Master |
| 洞穴 | -cluster MyClusterName -shard Caves |
这是参数结构,不是让你额外启动两份重复实例。实际名称以原配置为准。还要一起核对-persistent_storage_root、-conf_dir和运行账号:即使集群名相同,不同账号或存储根目录也可能读到不同存档。
在已经确定的集群根目录中,应分别核对:
cluster.ini
Master/server.ini
Caves/server.ini
Master/server_log.txt
Caves/server_log.txt
文件必须属于本次运行的实例。不要只看另一个目录里几天前的正常日志;也不要把某一份server.ini同时当成两个分片的独立配置。
检查端口占用与参数覆盖
- 核对两个分片各自的实际UDP游戏端口,同一机器上不能占用同一个监听地址与端口。
- 检查启动命令是否含
-port。它会覆盖server.ini里的server_port,因此只修改INI未必改变实际监听。 - 同机多进程还要核对Steam内部端口等实例参数是否冲突,不只看玩家入口端口。
- Linux上可用
sudo ss -lnup按实际端口和进程对照;Windows按实际进程和UDP监听检查。通用TCP连通测试不能证明这些UDP入口可用。
分片之间的连接与玩家公网入口是不同链路。先从两边日志查明洞穴尝试连接的目标及明确错误,再核对对应配置和规则;不为排错把所有端口向公网开放。
按洞穴日志继续处理
| 日志线索 | 处理方向 |
|---|---|
| 进程立即退出或端口占用 | 核对启动了哪一份实例,是否重复拉起或端口相同。 |
| 世界文件读取失败 | 核对实际洞穴数据目录、运行账号权限及最近迁移/恢复记录。 |
| 模组或版本不匹配 | 对照两分片及客户端所用版本和需要的模组,不直接删掉洞穴存档。 |
| 连接其他分片失败 | 结合两边同一时刻日志核对集群配置、目标地址与端口,必要时与原可用配置比较。 |
改动和恢复要把整个集群考虑进去
需要修改配置或恢复存档时,先安排维护并让地面、洞穴正常保存退出,再备份整个集群及相关模组配置。不要只恢复地面或只恢复洞穴的任意旧副本,造成世界进度和角色位置不一致。
完成修正后按原管理方式启动所需分片,让测试玩家进入地面、下洞穴、再返回地面,核对角色与物品正常。之后正常保存、关闭并重新加入,确认两边进度保留,才算完成验收。
仍失败时,提交两份同一时段的server_log.txt和脱敏启动参数。集群令牌、连接密钥及玩家隐私要遮盖,不直接公开完整配置。相关文档:游戏服务器连接排查 · 安全恢复备份 · 日志脱敏。