txAdmin:FiveM 面板完全指南

在 Linux 或 Windows VPS 上安装、首次启动、部署 QBCore 或 ESX 底座、实时控制台、定时重启、备份:用 txAdmin 管好您的 FiveM 服务器,全在这里。

概述

txAdmin 是随 FXServer(FiveM 服务器)一起发布的官方网页面板。它让您在浏览器里管理自己的 GTA V 角色扮演服务器:启动与停止、实时控制台、部署开箱即用的底座(recipe)、定时重启、玩家管理(封禁、白名单)以及崩溃监控。

本指南涵盖在 Linux VPS 以及 Windows VPS 上安装 txAdmin、用 PIN 码完成首次启动、让它常驻运行、需要开放的端口、按玩家人数选配置、升级、备份,以及最常见的问题——全部在我们的 FiveM 服务器套餐上实测过。

txAdmin 到底是什么?

自 2020 年起,txAdmin 就默认包含在 FXServer 里:不用另买,也不用另装。首次启动 FXServer 时,txAdmin 会自动运行并开出一个网页界面(默认在 40120 端口)。它是 FiveM 社区的标准工具,开源,由 Cfx.re 团队维护。

  • 实时控制台:实时服务器日志、命令、历史记录
  • Recipe:自动部署一整套底座(QBCore、ESX Legacy、原版)
  • 计划器:定时重启,并在游戏内发布公告
  • 玩家管理:封禁、警告、白名单、备注、按标识查历史
  • 监控:检测崩溃并自动重启

前置条件

  • 一台VPS,至少 4 GB 内存——若要跑带玩家的 QBCore/ESX 底座,建议 8 GB。Linux 一侧,Debian 和 Ubuntu 的资料最全:见我们的 VPS Debian 和 VPS Ubuntu 页面。Windows 一侧,需要一台带 RDP 访问的 Windows VPS。
  • 在 portal.cfx.re 上创建的免费许可密钥(任何 FiveM 服务器都必须有),通过 sv_licenseKey 写进 server.cfg
  • 防火墙里开放 30120 的 TCP 和 UDP(游戏)以及 40120 的 TCP(txAdmin 面板)
  • 如果要部署角色扮演框架,还需要一个 MariaDB 或 MySQL 数据库:QBCore 和 ESX 都把角色、物品栏和经济数据存在里面

在 Linux VPS 上安装

从 runtime.fivem.net 下载最新的 FXServer 构建,解压到一个目录(例如 ~/fxserver),然后执行 ./run.sh。txAdmin 会自动启动,并在终端里显示一个只在几分钟内有效的 4 位 PIN 码。在浏览器里打开 http://VPS-的-IP:40120,输入 PIN,然后绑定您的 Cfx.re 账号:以后就用它作为管理员身份。要让服务器在 SSH 断开后继续运行,请在 tmux、screen 里启动它,或者做成 systemd 服务——下一节给出完整的 unit 文件。

把 FXServer 做成 systemd 服务

在终端里手工启动的服务器,会随着 SSH 会话一起死掉,VPS 重启后也不会自己回来。systemd 服务能同时解决这两件事。新建 /etc/systemd/system/fxserver.service,内容如下,其中的用户和路径请改成您自己的:

  • [Unit] —— Description=FXServer FiveM,然后 After=network.target mariadb.service:网络和数据库就绪之前,服务器不会启动
  • [Service] —— User=fivem、WorkingDirectory=/home/fivem/fxserver、ExecStart=/home/fivem/fxserver/run.sh、Restart=always、RestartSec=10
  • [Install] —— WantedBy=multi-user.target
  • 然后执行 systemctl daemon-reload、systemctl enable --now fxserver,再用 journalctl -u fxserver -f 看启动日志——首次启动时 PIN 就显示在那里

用一个专用账号来跑服务器

不要用 root 启动 FXServer。新建一个专用的系统用户(adduser --system --group fivem),把服务器目录放到它名下,并把 txData 目录的所有权交给它。这样,一个写得不好的第三方资源——角色扮演生态里这类东西很多——只能碰到游戏文件,碰不到机器的其余部分。如果这台 VPS 上还放着网站或数据库,这种隔离是最低要求。

在 Windows VPS 上安装 txAdmin

FXServer 也有 Windows 构建,而且不少角色扮演社区就留在 Windows 上,因为他们的开发工具跑在那里。原理完全一样:从 runtime.fivem.net 下载 server.zip 压缩包,解压,运行 FXServer.exe。txAdmin 会启动,在控制台窗口里显示 PIN,面板响应在 http://VPS-的-IP:40120。有几点差别需要知道:

  • Windows 防火墙默认拦截:请建两条入站规则,一条给 30120 端口的 TCP 和 UDP,一条给 40120 端口的 TCP(用「高级安全 Windows Defender 防火墙」,或者 PowerShell 里的 New-NetFirewallRule)
  • 控制台窗口会随 RDP 会话一起关闭:要让服务器常驻,请把 FXServer.exe 注册成 Windows 服务(社区常用 NSSM 和 WinSW 两种工具),或者用一个「计算机启动时」触发的计划任务
  • 内存要比 Linux 留得多一些:系统本身就吃得更多。我们的Windows VPS 入门档是 8 GB,给 QBCore 或 ESX 底座留出了必要的余量
  • 微软许可不包含在内:这是一笔要另外算的开销,和 Linux VPS 不同

用 recipe 部署一套底座

首次访问时,txAdmin 的向导会提出部署一个 recipe:自动装好一整套服务器底座(框架、数据库、起步资源)。做角色扮演服务器就选 QBCore 或 ESX Legacy,想从零开始就选原版底座。recipe 还会配置 MySQL/MariaDB 连接——在 VPS 上请先装好 MariaDB 并建一个专用数据库。

要开哪些端口,为什么

一共只有三个端口,但有个经典错误:只给 30120 开了 TCP。FiveM 在 TCP 和 UDP 上用同一个端口号:TCP 用于发现和服务器列表,UDP 用于游戏流量。服务器出现在列表里却谁都连不上,几乎总是漏掉了 UDP。

  • 30120/tcp 和 30120/udp:游戏。对所有人开放。Debian 或 Ubuntu 下,ufw allow 30120 一次就把两个协议都开了
  • 40120/tcp:txAdmin 面板。建议限制到您自己的 IP 地址,见下文
  • 3306/tcp(MariaDB):不要对外开放。数据库和 FXServer 在同一台机器上,用 127.0.0.1 连接即可。把 MySQL 端口暴露在互联网上,是丢掉角色数据库最快的方式之一
  • 游戏端口可以改(server.cfg 里的 endpoint_add_tcp 和 endpoint_add_udp):想在同一台机器上跑两个服务器——一个生产、一个测试——就用得上

按玩家人数需要多少资源

RAGE 引擎非常依赖单个核心:处理器频率比 vCore 数量更重要。8 个慢核的 VPS 能承载的玩家,反而比 4 个快核的少。内存一侧则由第三方资源决定——一个完整的角色扮演服务器轻易就会加载上百个脚本。

  • 原版底座,几个玩家:4 GB 内存够用,这是启动 FXServer 的下限
  • QBCore 或 ESX,20 到 40 名玩家:8 GB。起步阶段角色扮演服务器的那五十来个脚本,单独就吃 2 到 4 GB,MariaDB 还要再多要 1 GB 左右
  • 成熟的服务器,64 槽位以上,带定制脚本:16 GB,并且用 SSD 存储——开局期间与数据库的往返一直不停
  • 磁盘:把资源的体积加上数据库算进去,并为备份留出空间。角色扮演服务器只会随时间变大,不会变小

日常使用中的 txAdmin 控制台

Live Console 标签页实时显示服务器日志,并接受所有 FXServer 命令(refresh、ensure 我的资源、restart es_extended……)。敏感操作按管理员账号记录:每一次踢人、封禁或重启都有迹可查,多个管理员一起管服务器时很实用。

  • Scheduler:每天安排 1 到 2 次重启并自动公告——FiveM 服务器的内存会随时间碎片化
  • Backups:定期备份您的数据目录和 MySQL 数据库(txAdmin 不会替您备份数据库)
  • Permissions:给每位管理员单独建一个权限受限的账号,而不是共用主账号

升级 FXServer 和 txAdmin

txAdmin 没有自己的升级流程:它内嵌在 FXServer 的 artifact 里,所以升级服务器就等于升级面板。操作本身简单,但必须按顺序来,否则会丢配置。

  1. 先从客户区做一个 VPS 快照,至少也要复制一份服务器目录并导出数据库
  2. 干净地停掉服务器(systemctl stop fxserver,或者 txAdmin 的 Stop 按钮)
  3. 只替换 artifact 里的文件——txData/、您自己的 resources/ 目录以及 server.cfg 都不要动:那些是您的数据,不是服务器的
  4. 重启,然后在控制台里确认所有资源都能加载。与新构建不兼容的资源会立刻在日志里现形
  5. 把上一个 artifact 留几天:这样回退就只是把旧目录换回来

真正需要备份的东西

支持请求里常出现一句话:「txAdmin 会做备份吧?」它确实会做,但备的不是您以为的东西。数据库并不由 txAdmin 备份。而角色、车辆、银行账户和物品栏都在数据库里——那是您的社区一点点攒出来的东西,丢了没人会原谅。

  • 数据库:每天用 cron 跑一次 mysqldump,并把结果送到 VPS 之外的地方
  • txData/ 目录:里面有 admins.json、面板配置以及处罚记录
  • 您的 resources/ 目录和 server.cfg:尤其是您改过的付费脚本,那些改动别处根本没有副本
  • VPS 快照覆盖整台机器,在客户区一键就能恢复。它们是数据库导出的补充,不是替代:快照会把您想撤销的那个错误也一并恢复

保护面板的访问

一个暴露在公网 IP 上的管理面板,显然是个靶子。三项措施就够了:

  • 把 40120 端口限制到您的 IP:ufw allow from 您的IP to any port 40120,然后 ufw deny 40120——只有您和共同管理员能进面板,游戏端口(30120)仍对所有人开放
  • 绝不要关掉身份验证,哪怕「只是试一下」:txAdmin 的免密模式只用于本地开发,公网 VPS 上绝不可用
  • 生产环境用 HTTPS 反向代理(可选):前面挂一个 Nginx 或 Caddy,配一个子域名和 Let's Encrypt 证书,而不是把 ip:40120 明文暴露出去——注意要把 WebSocket 头(Upgrade/Connection)正确转发,实时控制台依赖它们
  • 每人一个管理员账号,权限给到最小:txAdmin 是按账号记录操作的,大家共用同一个身份,这份记录就失去意义

常见问题与解决办法

  • 40120 页面打不开:端口没开——在防火墙里放行(ufw allow 40120/tcp),或者确认 txAdmin 真的在监听(看启动日志)
  • 服务器出现在列表里但谁都连不上:30120 只开了 TCP。UDP 也要开
  • PIN 过期:重启 FXServer,终端里会出现新的 PIN
  • 管理员权限丢了:停掉服务器,删掉 txData/admins.json 文件——txAdmin 会重新走一遍首次启动向导
  • 「Invalid license key」:Cfx.re 密钥和 IP 地址绑定。换过服务器的话,请在 portal.cfx.re 上重新生成,并替换 server.cfg 里的 sv_licenseKey 那一行
  • 反向代理后面实时控制台一直是空的:WebSocket 头没有转发。在 Nginx 配置里加上 Upgrade 和 Connection
  • 服务器反复重启:看崩溃前那一段日志。十次里有九次是前一天加的第三方资源——把它从 server.cfg 里去掉再重启来确认
  • 服务器卡顿:盯着监控标签页;如果加上您的数据库和玩家之后内存吃满了,就换一档更高的 VPS 套餐。换套餐在客户区操作,不需要重装
  • 开局期间反复被攻击:人气高的角色扮演服务器会被定期盯上。唯一的解法是在网络层做过滤;见我们的指南读懂 Anti-DDoS

常见问题

完全免费。txAdmin 开源,并且默认包含在 FXServer 里。它没有任何收费版本:如果有网站卖您「txAdmin」,那是骗局。

是 40120 端口(网页界面),旁边的 30120 端口给游戏用。两个都必须在 VPS 防火墙里放行——并且建议尽可能把 40120 限制到您自己的 IP。

游戏用 30120 的 TCP 和 UDP,txAdmin 面板用 40120 的 TCP。MySQL 端口(3306)对外保持关闭:数据库在本机连接。漏掉 30120 的 UDP 是最常见的错误——服务器会出现在列表里,却谁都连不上。

txAdmin 本身很轻,吃资源的是 FiveM 服务器。简单底座请预留 至少 4 GB,QBCore/ESX 带 20-40 名玩家 8 GB,超过 64 槽位或者定制资源很多时 16 GB。

能。FXServer 有 Windows 构建,txAdmin 在上面的用法完全一样:FXServer.exe、控制台里的 PIN、40120 端口上的面板。需要在 Windows 防火墙里开端口,并把服务器注册成服务,这样它才能在 RDP 会话关闭后继续运行。内存要比 Linux 留得多一些,还要算上微软许可,VPS 从不附带它。

先做快照,停掉服务器,然后只替换 artifact 里的文件。您的 txData/ 和 resources/ 目录以及 server.cfg 都不能动:那是您的数据。把上一个 artifact 留几天,以便随时回退。

不会,而这正是代价最高的误解。txAdmin 备份的是它自己的配置,不是您的 MySQL 数据库——角色、物品栏和经济都在那里面。请配一个每天跑的 mysqldump,把结果送到 VPS 之外,作为整机快照之外的补充。

不能。txAdmin 只为 FXServer(FiveM 和 RedM)设计。其他游戏可以用 Pterodactyl 这类通用面板。

停掉服务器,然后删除 txData/admins.json:重启之后 txAdmin 会显示一个新的 PIN,并重新进入创建主账号的向导。