The Forest 服务器故障排除
本指南介绍 Legion Hosting 托管的 The Forest 专用服务器的常见问题和解决方案。有关初始服务器配置和设置，请参阅 The Forest 专用服务器设置指南。
服务器未出现在服务器浏览器中
原因： Steam 游戏服务器登录令牌 (GSLT) 缺失或无效，或查询端口不可达。
- 确保在
config.cfg中将serverSteamAccount设置为有效的 GSLT。在 steamcommunity.com/dev/managegameservers 生成一个（App ID 242760）。 - 确认服务器已完全启动 — 启动后可能需要一两分钟才会出现在浏览器中。
- 尝试使用 GPanel Network 选项卡中显示的查询端口，手动将服务器添加到 Steam 收藏夹。
- 验证您分配的游戏端口和查询端口（显示在 GPanel 的 Network 选项卡中）与
config.cfg中的值一致。如果您怀疑存在防火墙问题，请 联系支持。
存档未加载 / 重启后世界重置
原因：
initType 设置为 New 而非 Continue，或指定了错误的存档槽位。
- 打开
config.cfg并将initType设置为Continue。 - 确认
slot值与包含您存档数据的槽位一致。 - 检查
TheForestDedicatedServer_Data/目录，确认存档文件确实存在于预期的槽位文件夹中。
提示： 配置文件位于
TheForestDedicatedServer_Data/forest/config/config.cfg。您可以通过 gpanel.legionhosting.net 的 GPanel 文件管理器或通过 SFTP 进行编辑。
玩家无法连接
可能的原因：
- 服务器尚未完全启动 — 启动后等待 60–90 秒再尝试连接。
- 玩家使用了错误的端口 — 确保他们连接的是游戏端口（而非查询端口）。在 GPanel 的 Network 选项卡中查看正确的端口。
- 服务器设置了密码 — 确认玩家拥有
config.cfg中serverPassword的正确密码。 - 服务器已满 — 在 GPanel 中检查
maxPlayers和当前玩家数量。 - 玩家不在白名单中 — 如果
whitelist.txt存在且非空，则只有列出的 Steam ID 才能加入。详见 The Forest 服务器管理员与主机控制。
服务器启动时崩溃
诊断步骤：
- 尝试启动后，立即在 GPanel 中查看服务器控制台输出。查找引用
config.cfg语法错误的错误信息。 - 确认
config.cfg中没有无效字符或格式错误的行 — 每个设置应独占一行，=符号周围不应有多余空格。 - 如果崩溃发生在游戏更新之后，请尝试从 GPanel 执行完整的服务器重新安装以更新服务器二进制文件。
高延迟 / 卡顿
- 如果服务器经常满员且套餐资源有限，请减少
maxPlayers。 - 在建筑密集的世界中禁用树木再生（
allowTrees false）— 大量再生的树木会增加服务器负载。 - 确保 GPanel 中没有与服务器同时运行的大型后台进程。
相关文章
- The Forest 专用服务器设置指南 — 配置、难度模式、存档和连接
- The Forest 服务器管理员与主机控制 — 管理员列表、白名单和游戏内命令
仍需帮助？
如果您按照上述步骤操作后仍然遇到问题，请 提交工单，并附上您的服务器 ID、问题描述以及 GPanel 中的相关控制台输出。
