本指南涵盖了运行 Team Fortress 2 专用服务器时可能遇到的常见问题,包括 GSLT 令牌问题、SourceMod 无法加载、VAC 错误和服务器浏览器可见性问题。有关初始服务器设置,请参阅 TF2 服务器设置指南。
GSLT 令牌问题
症状: 服务器控制台显示 "Invalid or expired GSLT" 或服务器未公开列出。
原因及修复方法:
- 令牌因长时间未使用而过期 — 请在 steamcommunity.com/dev/managegameservers 重新生成。
- 拥有该令牌的 Steam 账户存在 VAC 封禁 — 需要使用一个未被封禁的新账户生成令牌。
- 该令牌已被另一个正在运行的服务器使用 — 每个服务器实例需要独立的唯一令牌。
server.cfg中的sv_setsteamaccount行存在拼写错误或多余空格 — 请验证它与令牌字符串完全匹配。- 生成令牌时使用了错误的 App ID — TF2 需要使用 App ID 440。
SourceMod 无法加载
症状: 安装后 sm version 返回 "Unknown command"。
原因及修复方法:
- MetaMod:Source 未安装或未加载 — 请先确认
meta version是否正常工作。如果不行,请重新检查 MetaMod 的安装。SourceMod 需要 MetaMod 才能运行。 - 文件上传到了错误的目录 — SourceMod 必须位于
tf/addons/sourcemod/,而不是服务器根目录或其他游戏文件夹中。 - 下载了错误的版本 — 服务器运行在 Linux 上。请确保下载的是 Linux 版本,而非 Windows 版本。
- 文件权限问题 — 确保所有上传的文件都是可读的。如果不确定,请通过 SFTP 重新上传。
- 检查日志 — 查看
tf/addons/sourcemod/logs/中的错误消息,了解哪些内容加载失败。
提示: 修复任何 SourceMod 安装问题后,请务必执行完整的服务器重启(而不仅仅是换图),以确保所有内容正确加载。
VAC 问题 / VAC 安全模式已禁用
症状: 服务器控制台显示 "VAC secure mode is disabled" 或玩家收到 VAC 已关闭的警告。
原因及修复方法:
- 无有效 GSLT — VAC 需要有效的
sv_setsteamaccount令牌。请参阅 服务器设置指南了解 GSLT 说明。 - 已加载的插件或扩展被标记 — 某些非官方二进制扩展可能触发 VAC 禁用。逐一移除最近安装的插件以找出原因。
- 设置了
sv_cheats 1— 启用作弊后 VAC 会自动禁用。请确保server.cfg中设置了sv_cheats 0。 - 如果在解决以上问题后 VAC 仍然禁用,请执行完整的服务器重启(而不仅仅是换图)。
服务器未出现在浏览器中
插件导致服务器崩溃
症状: 安装或更新插件后,服务器意外崩溃或重启。
原因及修复方法:
警告: 切勿从不受信任的来源安装插件。恶意的
.smx 文件可以在您的服务器上执行任意命令。请仅使用来自 AlliedModders 或经过验证的 GitHub 仓库的插件。
玩家无法连接
症状: 玩家收到超时、连接被拒绝或"服务器无响应"错误。
原因及修复方法:
- 服务器未运行 — 在 GPanel 中检查确认服务器在线且未处于崩溃循环中。
- IP 或端口错误 — 在 GPanel 中验证连接信息。请参阅 如何查找您的服务器 IP 和端口指南。
- 密码不匹配 — 如果
server.cfg中设置了sv_password,玩家在连接时必须输入正确的密码。 - 服务器已满 — 检查服务器是否已达到
maxplayers上限。 - 自定义地图下载超时 — 如果服务器运行自定义地图且未配置 FastDL,网速较慢的玩家在地图下载过程中可能超时。请参阅 服务器设置指南了解 FastDL 配置。
通用诊断步骤
在排查任何 TF2 服务器问题时,请在提交支持工单之前按以下步骤收集有用信息:
- 在 GPanel 中检查服务器控制台输出的错误消息。
- 查看
tf/addons/sourcemod/logs/中的日志(如果已安装 SourceMod)。 - 检查
tf/console.log或 GPanel 控制台中的引擎级错误。 - 如果问题是在某次更改后出现的,请撤销该更改并重新测试。
- 尝试在开发者控制台中通过
connect IP:PORT直接连接,以排除浏览器相关问题。
相关文章
- TF2 服务器设置指南 — Server.cfg 配置、GSLT 令牌、地图轮换、FastDL、连接方式
- TF2 管理员与插件设置 — SourceMod/MetaMod 安装、管理员账户、插件管理
- 如何查找您的服务器 IP 和端口
- 如何通过 SFTP 上传文件
仍然需要帮助? 如果您无法通过本指南解决问题,请 提交支持工单,并附上
tf/addons/sourcemod/logs/ 中的相关日志输出或服务器控制台信息。