饥荒联机版地面能进、洞穴进不去:核对双分片与存档

饥荒联机版专服的地面和洞穴通常由两个分片进程共同提供。能进入地面,只证明地面入口可用,不能证明洞穴进程、两者之间的连接和洞穴存档正常。本篇用于原来已经配置地面与洞穴的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同时当成两个分片的独立配置。

检查端口占用与参数覆盖

  1. 核对两个分片各自的实际UDP游戏端口,同一机器上不能占用同一个监听地址与端口。
  2. 检查启动命令是否含-port。它会覆盖server.ini里的server_port,因此只修改INI未必改变实际监听。
  3. 同机多进程还要核对Steam内部端口等实例参数是否冲突,不只看玩家入口端口。
  4. Linux上可用sudo ss -lnup按实际端口和进程对照;Windows按实际进程和UDP监听检查。通用TCP连通测试不能证明这些UDP入口可用。

分片之间的连接与玩家公网入口是不同链路。先从两边日志查明洞穴尝试连接的目标及明确错误,再核对对应配置和规则;不为排错把所有端口向公网开放。

按洞穴日志继续处理

日志线索 处理方向
进程立即退出或端口占用 核对启动了哪一份实例,是否重复拉起或端口相同。
世界文件读取失败 核对实际洞穴数据目录、运行账号权限及最近迁移/恢复记录。
模组或版本不匹配 对照两分片及客户端所用版本和需要的模组,不直接删掉洞穴存档。
连接其他分片失败 结合两边同一时刻日志核对集群配置、目标地址与端口,必要时与原可用配置比较。

改动和恢复要把整个集群考虑进去

需要修改配置或恢复存档时,先安排维护并让地面、洞穴正常保存退出,再备份整个集群及相关模组配置。不要只恢复地面或只恢复洞穴的任意旧副本,造成世界进度和角色位置不一致。

完成修正后按原管理方式启动所需分片,让测试玩家进入地面、下洞穴、再返回地面,核对角色与物品正常。之后正常保存、关闭并重新加入,确认两边进度保留,才算完成验收。

仍失败时,提交两份同一时段的server_log.txt和脱敏启动参数。集群令牌、连接密钥及玩家隐私要遮盖,不直接公开完整配置。相关文档:游戏服务器连接排查 · 安全恢复备份 · 日志脱敏。