常见 Terraria 专用服务器问题的解决方案，包括启动失败、连接问题、模组错误和世界损坏。有关服务器基本配置，请参阅 Terraria 服务器设置指南。

---

服务器启动但世界未加载

检查 serverconfig.txt 中的 world 路径是否与 saves/Worlds/ 目录中的文件名完全匹配，包括大小写。在 Linux 服务器上路径区分大小写。

# Correct — matches actual filename
world=/home/container/saves/Worlds/MyWorld.wld

# Wrong — case mismatch will fail
world=/home/container/saves/Worlds/myworld.wld

如果文件根本不存在且您希望自动创建新世界，请将 serverconfig.txt 中的 autocreate 值设置为 1（小）、2（中）或 3（大）。

---

无法连接 — 连接被拒绝或超时

确认服务器正在 GPanel 中运行，并且您使用的是连接详情页面上显示的正确 IP 和端口。如果不确定，请参阅 如何查找您的服务器 IP 和端口。

其他需要检查的事项：

• 确保服务器已完全启动 — 在尝试连接之前，请在控制台日志中观察"Listening on port..."消息。
• 如果您最近更改了 serverconfig.txt 中的端口，请将其恢复。面板会自动分配您的端口；更改它可能导致不匹配。
• 验证您的本地防火墙或杀毒软件是否阻止了 Terraria 的出站连接。

---

密码提示未出现 / 密码错误

如果您在 serverconfig.txt 中设置了密码，请确保值周围没有多余的空格。该行应该写成 password=yourpassword，不带引号且末尾没有空格。

# Correct
password=mysecretpass

# Wrong — extra spaces will be included in the password
password= mysecretpass
password=mysecretpass 

---

tModLoader 服务器上模组未加载

• 确认 .tmod 文件位于 mods/ 目录中，而不是其子目录中。
• 检查服务器上的 tModLoader 版本是否与模组构建时使用的 tModLoader 版本匹配。过时的模组无法在较新的 tModLoader 版本上加载。
• 在 GPanel 中查看服务器控制台日志，了解启动期间 tModLoader 的具体错误消息。

有关完整的模组安装说明，请参阅 Terraria 模组安装 (tModLoader)。

---

难度设置无效 (tModLoader)

在 tModLoader 服务器上，serverconfig.txt 中的 difficulty 行不能以 # 字符开头。被注释掉的行（如 #difficulty=0）会被 tModLoader 忽略，这意味着无论设置什么值，难度可能默认为普通。

# This is IGNORED by tModLoader:
#difficulty=0

# This is applied correctly:
difficulty=0

---

在原版和 tModLoader 之间切换后世界损坏

请始终为原版和 tModLoader 会话使用单独的世界文件。如果您在原版中加载了 tModLoader 世界且现在已损坏，最安全的恢复选项是从备份还原。

---

服务器启动时崩溃

格式错误的 serverconfig.txt 或缺失的世界文件是导致启动崩溃的最常见原因。诊断步骤：

1. 打开 GPanel 中的控制台日志，查找第一行错误信息。
2. 仔细检查 serverconfig.txt 中的所有路径和值。
3. 如果您最近安装了模组，请尝试从 mods/ 目录中移除它们，看看服务器是否能在没有模组的情况下启动。
4. 如果在没有模组且配置干净的情况下崩溃仍然存在，请提交工单。

---

相关文章

• Terraria 服务器设置指南 — 服务器配置、世界设置和连接
• Terraria 模组安装 (tModLoader) — 安装和管理模组
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件

---