本指南将引导您完成在 Legion Hosting 上托管的 FiveM（GTA V 多人游戏）服务器的设置 — 从获取 CFX 许可证密钥和配置 TXAdmin，到编辑 server.cfg 和连接玩家。

前提条件

• 一台 Legion Hosting FiveM 服务器（在您的账户中处于活跃状态）
• 一个 Cfx.re 论坛账户（免费 — 生成许可证密钥所需）
• 可访问 GPanel
• PC 上已安装 FiveM 客户端（fivem.net）

步骤 1：获取您的 CFX 许可证密钥

每个 FiveM 服务器都需要一个来自 Cfx.re（FiveM 的开发者）的唯一许可证密钥。此密钥是免费的，并与您的 Cfx.re 账户绑定。

1. 前往 https://keymaster.fivem.net/ 并使用您的 Cfx.re 论坛账户登录。
2. 点击 New Server（或 Register a new server）。
3. 填写详细信息：
   • Label： 为您的服务器取一个便于识别的名称（例如 "My Legion FiveM Server"）
   • Server IP Address： 输入您在 GPanel 中的服务器 IP 地址（参阅 如何查找您的服务器 IP 和端口）
   • Server Type： 选择适当的类型（通常选择 "Other / Apache / nginx"）
4. 点击 Generate。
5. 复制生成的许可证密钥 — 在后续步骤中会用到。

步骤 2：首次启动服务器和 TXAdmin 设置

在 Legion Hosting 上托管的 FiveM 服务器附带 TXAdmin — 一个与 FiveM 服务器同时运行的基于网页的管理面板。首次启动时，TXAdmin 将引导您完成初始设置。

启动服务器

1. 登录 GPanel 并选择您的 FiveM 服务器。
2. 转到 Startup 标签页，找到 FIVEM_LICENSE（或类似名称的）变量。在此处粘贴您的 CFX 许可证密钥并保存。
3. 转到 Console 标签页，点击 Start。
4. 观察控制台输出。首次启动时，服务器将下载所需的 FiveM artifacts — 这可能需要几分钟。
5. 当 TXAdmin 准备就绪后，您将在控制台中看到包含 TXAdmin URL 和 PIN 码的消息。

完成 TXAdmin 设置

1. 在浏览器中打开 TXAdmin URL。
2. 输入 GPanel 控制台输出中显示的 PIN。
3. 创建您的 TXAdmin 管理员账户（用户名和密码）。
4. TXAdmin 将引导您完成设置向导：
   • Server Name： 选择在 FiveM 服务器浏览器中显示的名称。
   • Deployment Type： 选择一个模板（例如 "Popular Recipes" 用于预配置的基础设置，或 "Remote URL / Template" 用于自定义设置）。
   • Server Data Folder： 除非有特定理由，否则保持默认设置。
   • CFX Key： 如果再次提示，请粘贴您的许可证密钥。
5. 完成向导，让 TXAdmin 完成服务器文件的部署。这可能需要几分钟。

步骤 3：配置 server.cfg

server.cfg 文件是 FiveM 服务器的主要配置文件。TXAdmin 在设置过程中会生成一个基本的配置文件，但您需要检查并自定义它。

访问 server.cfg

1. 在 GPanel 中，点击 Files 标签页。
2. 导航到您的服务器数据文件夹（通常是根目录或 TXAdmin 模板创建的文件夹）。
3. 点击 server.cfg 在内联编辑器中打开它。

基本设置

最简 server.cfg 示例：

# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"

# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"

# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"

# Player Limit
sv_maxclients 48

# Privacy
sv_endpointprivacy true

# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat

步骤 4：连接到您的 FiveM 服务器

服务器配置完成并运行后，玩家可以通过 FiveM 服务器浏览器或直接连接方式加入。

直接连接

1. 打开 FiveM 客户端。
2. 按 F8 打开 FiveM 控制台，或点击主屏幕上的 Direct Connect 按钮。
3. 以 IP:PORT 格式输入您的服务器 IP 和游戏端口。
4. 点击 Connect。

服务器浏览器

1. 打开 FiveM 客户端并点击 Play。
2. 在服务器浏览器中，搜索您的服务器名称（server.cfg 中的 sv_hostname 值）。
3. 点击您的服务器，然后点击 Connect。

使用 TXAdmin 管理您的服务器

初始设置完成后，TXAdmin 提供一个网页仪表板用于日常服务器管理。通过 http://YOUR_SERVER_IP:TXADMIN_PORT 访问。

获取帮助

如果您按照本指南操作后仍然遇到问题：

1. 从 GPanel 控制台或 TXAdmin 日志中复制所有错误信息。
2. 记录您卡在哪个步骤以及已经尝试过的方法。
3. 在 https://legionhosting.net/submitticket.php 提交工单并附上这些信息。我们的团队将尽快为您提供帮助。

相关文章

• FiveM 资源、脚本和数据库设置
• FiveM 故障排除
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件
• 服务器启动指南