Valheim 故障排除

本指南涵盖运行 Valheim 专用服务器时可能遇到的常见问题，包括连接问题、世界加载失败和 mod 相关错误。有关初始服务器配置，请参阅 Valheim 专用服务器设置指南。有关 mod 安装步骤，请参阅 Valheim Mod 安装指南。

服务器未显示在服务器浏览器中

原因：Steam 服务器浏览器通过查询端口发现服务器，而不是游戏端口。如果查询端口被阻止或未正确映射，即使玩家可以直接连接，服务器也不会出现在任何服务器列表中。

解决方案：打开 GPanel，转到 Network 选项卡。确认您的游戏端口和查询端口都已列出并正确分配。如果您不确定端口信息，请参阅如何查找服务器 IP 和端口。在排除服务器列表可见性问题时，请使用 Steam 收藏夹方法（在设置指南中有说明）直接连接。

服务器因密码错误拒绝启动

原因：密码少于 5 个字符、为空，或密码字符串中包含服务器名称。

解决方案：转到 GPanel 中的 Startup 选项卡，更新 Password 变量。确保满足以下所有要求：

至少 5 个字符长
不包含 ServerName 作为子字符串
不能为空

保存后重启服务器。

世界未加载 / 生成了新世界

原因：WorldName 启动变量与世界文件的文件名不匹配，或两个必需的世界文件（.fwl 或 .db）中只有一个存在。

解决方案：

通过 SFTP 连接并导航到：

/.config/unity3d/IronGate/Valheim/worlds_local/

确认 <WorldName>.fwl 和 <WorldName>.db 两个文件都存在。
验证 GPanel 中的 WorldName 启动变量与文件名完全匹配（区分大小写，不含扩展名）。
如果生成了新世界，请停止服务器，删除或重命名新创建的世界文件，恢复备份文件，然后重启。

玩家无法连接

原因：玩家无法连接 Valheim 服务器可能有多种原因。

解决方案：请逐一检查以下项目：

服务器仍在启动中：Valheim 可能需要几分钟才能完全启动，特别是安装了 mod 的情况下。请等到控制台显示服务器就绪后再连接。
端口错误：通过游戏内浏览器连接的玩家应使用游戏端口。通过 Steam 收藏夹添加服务器的玩家应使用查询端口。在 GPanel 的 Network 选项卡中查看您分配的端口。
密码不匹配：确保玩家输入了正确的服务器密码。密码区分大小写。
Mod 版本不匹配：如果安装了 Valheim Plus 或其他强制 mod，所有玩家必须拥有完全相同的版本。详情请参阅 Mod 安装指南。

BepInEx Mod 未加载

原因：BepInEx 文件被放置在错误的目录中，或服务器根目录缺少 doorstop 库。

解决方案：

通过 SFTP 验证 BepInEx/ 文件夹位于服务器根目录中，与 valheim_server.x86_64 在同一目录下。
验证 doorstop_libs/ 文件夹也存在于服务器根目录中，并包含 libdoorstop_x64.so。在基于 Pterodactyl 的面板上，doorstop 通过环境变量加载 — 不需要 run_bepinex.sh 脚本，也不需要它存在。
检查您的 mod .dll 文件是否在 BepInEx/plugins/ 内，而不是在根目录或其他子目录中。
重启服务器并检查服务器控制台日志中的 BepInEx 初始化消息或错误输出。

预期的目录结构如下：

/ (server root)
  valheim_server.x86_64
  BepInEx/
    plugins/        ← mod .dll files go here
    config/
    patchers/
  doorstop_libs/
    libdoorstop_x64.so

添加 Mod 后服务器崩溃或不稳定

原因：某个 mod 与当前 Valheim 版本不兼容、与其他 mod 冲突或配置错误。

解决方案：

在 GPanel 中检查服务器控制台输出，查找引用特定 mod 或插件名称的错误消息。
从 BepInEx/plugins/ 中移除所有 mod 并重启服务器，确认在没有 mod 的情况下服务器能正常运行。
逐个重新添加 mod，每次之间重启服务器，以确定导致崩溃的 mod。
检查 mod 的 Thunderstore 或 Nexus 页面，了解兼容性说明和所需依赖项。

Valheim 游戏更新后：mod 可能会失效，直到作者发布更新版本。如果您的服务器在更新前运行稳定但更新后崩溃，请暂时移除 mod，直到有更新版本可用。

跨平台联机不工作

原因：跨平台联机启动变量未启用，或 mod 干扰了跨平台联机功能。

解决方案：

转到 GPanel 中的 Startup 选项卡，将 ENABLE_CROSSPLAY 设置为 1。
重启服务器。
请注意，大多数 BepInEx mod 不兼容跨平台联机。如果您安装了 mod 且跨平台玩家无法连接，您可能需要在 mod 和跨平台联机支持之间做出选择。

Valheim 专用服务器设置指南 — 启动配置、连接和世界存档
Valheim Mod 安装指南 — BepInEx、Thunderstore 和 Valheim Plus
如何查找服务器 IP 和端口
如何通过 SFTP 上传文件

如果按照本指南操作后仍然遇到问题，我们的支持团队随时为您提供帮助。提交支持工单，并附上您服务器的 GPanel 详细信息、问题描述以及服务器控制台中的任何错误消息。

Valheim 故障排除 - 知識庫

技术支持

分类

Valheim 故障排除