中文

游戏服务器

如何使用 txAdmin 创建 FiveM 服务器

在 VPS 或专用 Linux 服务器上使用 txAdmin 安装 FiveM 服务器的完整指南:Cfx.re 许可证密钥、systemd 服务、防火墙、MariaDB 数据库、更新和备份。

阅读约 9 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 FiveM 服务器(FXServer),通过其 Web 管理界面 txAdmin 进行配置,并以专用用户将其作为服务运行。

订购服务器

要托管您的 FiveM 服务器,HostMyServers 提供多种选择。使用角色扮演(roleplay)类框架并加载大量资源的服务器需要高速处理器和充足的内存。

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • 64 位 x86_64 Linux 系统(Debian 12/13 或 Ubuntu 22.04/24.04),不支持 ARM 处理器
  • 已启用防火墙:nftables、iptables 或 ufw(一次只使用一种防火墙工具)
  • 一个 Cfx.re 账户,用于创建服务器许可证密钥
  • 每位玩家都需拥有一份正版 GTA V
  • 端口 30120 TCP 和 UDP 可访问,端口 40120 TCP(txAdmin)仅限您的 IP 地址访问

配置要求

Cfx.re 未公布服务器的最低配置。下列数值仅供参考,请根据您的资源和玩家数量进行调整。

用途 CPU 内存 存储
基础或测试服务器 2 核,高主频 4 GB 20 GB SSD
角色扮演框架,最多 48 名玩家 4 核,高主频 8 GB 40 GB NVMe SSD
高负载服务器,大量资源 6 核或更多 16 GB 及以上 80 GB NVMe SSD

系统更新

终端
sudo apt update && sudo apt upgrade -y

安装依赖项

txAdmin 的文档在 screen 中运行服务器,而 xz-utils 用于解压压缩包:

终端
sudo apt install -y curl tar xz-utils screen ca-certificates

创建专用用户

服务器绝不能以 root 身份运行。请创建专用用户:

终端
sudo adduser --disabled-password --gecos "" fivem

使用的端口

端口 协议 用途 访问范围
30120 TCP 和 UDP 游戏(玩家连接和服务器信息) 公开
40120 TCP txAdmin Web 界面 仅限您的 IP 地址
3306 TCP MariaDB(如已安装) 仅限本地,请勿开放

防火墙配置

开放游戏端口,并将 txAdmin 限制为您的固定 IP 地址:请替换 您的IP。如果您没有固定 IP 地址,请不要创建放行 您的IP 的规则,改用下文介绍的 SSH 隧道。

使用 UFW

UFW 启用后默认拒绝入站连接。请使用 sudo ufw status 确认其已启用。

终端
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from 您的IP to any port 40120 proto tcp
sudo ufw reload

使用 iptables

最后一条规则会对所有其他地址屏蔽 txAdmin,同时不影响本地 SSH 隧道:

终端
sudo iptables -A INPUT -p tcp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p tcp -s 您的IP --dport 40120 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 40120 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4

重启后保留规则需要安装 iptables-persistent 软件包。

使用 nftables

这些命令使用 inet filter 表和 input 链,二者在 Debian 的 /etc/nftables.conf 中默认存在。

终端
sudo nft add rule inet filter input tcp dport 30120 accept
sudo nft add rule inet filter input udp dport 30120 accept
sudo nft add rule inet filter input ip saddr 您的IP tcp dport 40120 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 40120 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

创建 Cfx.re 许可证密钥

每台服务器都需要一个免费的许可证密钥,密钥以 cfxk_ 开头。

  1. 使用您的账户登录 Cfx.re 门户。
  2. 打开服务器注册密钥页面。
  3. 点击 + 按钮,填写所需信息(服务器的名称、标语、描述和语言),然后点击 Generate Key。
  4. 使用 Copy Key 复制密钥,并保存好以备配置步骤使用。

安装 FXServer

以 fivem 用户身份登录,并创建 txAdmin 数据文件夹:

终端
sudo -iu fivem
mkdir -p ~/txData

创建一个用于下载 FXServer 推荐版本的脚本。该脚本也将用于后续更新:

终端
nano ~/update-fxserver.sh
终端
#!/bin/bash
set -euo pipefail

API="https://changelogs-live.fivem.net/api/changelog/versions/linux/server"
URL=$(curl -fsSL "$API" | grep -o '"recommended_download":"[^"]*"' | cut -d'"' -f4)
[ -n "$URL" ] || { echo "找不到下载地址" >&2; exit 1; }

TMP=$(mktemp -d "$HOME/fxserver.XXXXXX")
trap 'rm -rf "$TMP"' EXIT

curl -fL -o "$TMP/fx.tar.xz" "$URL"
tar -xJf "$TMP/fx.tar.xz" -C "$TMP"
rm -f "$TMP/fx.tar.xz"

rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"

echo "已安装版本:$URL"

运行该脚本,然后退出 fivem 用户的会话:

终端
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exit

~/server 文件夹中应包含 run.sh 和 alpine。如果您希望自行选择版本,可在官方下载页面查看压缩包列表。

配置为 systemd 服务

创建服务文件

终端
sudo nano /etc/systemd/system/fivem.service

文件内容:

配置
[Unit]
Description=FiveM Server (FXServer + txAdmin)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/home/fivem/txData
Environment=TERM=xterm
Environment=TXHOST_DATA_PATH=/home/fivem/txData
Environment=TXHOST_TXA_PORT=40120
Environment=TXHOST_GAME_NAME=fivem
ExecStartPre=/usr/bin/truncate -s 0 /home/fivem/fxserver.log
ExecStart=/usr/bin/screen -L -Logfile /home/fivem/fxserver.log -DmS fivem /home/fivem/server/run.sh
Restart=always
RestartSec=15
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

不要向 run.sh 传递 +exec 参数:否则 txAdmin 将无法启动。

变量 作用
TXHOST_DATA_PATH txAdmin 数据文件夹,与 FXServer 文件分开存放,以便在更新后保留
TXHOST_TXA_PORT Web 界面端口(默认 40120)
TXHOST_GAME_NAME 将 txAdmin 限制为 FiveM 模板

启用并启动服务

终端
sudo systemctl daemon-reload
sudo systemctl enable fivem.service
sudo systemctl start fivem.service

管理命令

终端
# 检查状态
sudo systemctl status fivem.service

# 停止服务器
sudo systemctl stop fivem.service

# 重启服务器
sudo systemctl restart fivem.service

# 实时查看控制台
sudo tail -f /home/fivem/fxserver.log

使用 txAdmin 进行配置

访问界面

最安全的方式是使用 SSH 隧道,因为流量始终加密,且无需开放任何管理端口。在您的电脑上执行:

终端
ssh -L 40120:127.0.0.1:40120 您的用户名@服务器IP

保持此会话开启,然后在浏览器中打开 http://127.0.0.1:40120。如果您已在防火墙中放行 您的IP,也可以使用 http://服务器IP:40120。

获取 PIN 码

首次启动时,txAdmin 会显示一个 4 位 PIN 码。请等待约十五秒,然后在服务器上查看:

终端
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.log

配置向导

  1. 输入 PIN 码,然后点击 Link Account 并使用您的 Cfx.re 账户登录。
  2. 设置 txAdmin 管理员密码。
  3. 为您的服务器命名。
  4. 选择 Popular Recipes,然后选择一个模板。对于简单的服务器,请选择 Cfx.re 的基础模板(FiveM Basic Server,有时显示为 CFX Default FiveM)。
  5. 保留建议的目标文件夹,然后进入 Recipe Deployer。
  6. 粘贴您的 cfxk_ 密钥,如果模板需要数据库,请填写数据库信息,然后点击 Run Recipe。
  7. 部署完成后,点击 Save & Run Server。

服务器文件创建在 /home/fivem/txData 的一个子文件夹中,该文件夹的名称以 .base 结尾。确切路径由 txAdmin 显示。

MariaDB 数据库(如需要)

基础模板不需要数据库。ESX Legacy 或 Qbox 等框架需要数据库,而它们用于连接数据库的资源 oxmysql 推荐使用 MariaDB。请在开始部署之前安装:

终端
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadb

生成一个不含特殊字符的密码,因为该密码将被放入连接地址中:

终端
openssl rand -hex 16

创建数据库及其用户,并将 GENERATED_PASSWORD 替换为该密码:

终端
sudo mariadb
SQL
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'GENERATED_PASSWORD';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

然后在 txAdmin 部署过程中填写:

字段 值
主机 127.0.0.1
端口 3306
用户 fivem
密码 生成的密码
数据库 fivem

txAdmin 会将连接信息写入 server.cfg,格式如下:

文本
set mysql_connection_string "mysql://fivem:GENERATED_PASSWORD@127.0.0.1/fivem?charset=utf8mb4"

检查服务器

检查端口是否正在监听:

终端
sudo ss -tulpn | grep -E ':(30120|40120)\b'

在您的电脑上,此地址应返回 JSON 格式的服务器信息:

文本
http://服务器IP:30120/info.json

另外,请从 您的IP 以外的网络连接确认 http://服务器IP:40120 没有响应。

连接到服务器

  1. 启动 FiveM。
  2. 按 F8 键打开控制台。
  3. 输入:connect 服务器IP:30120

新服务器最多可能需要 8 分钟才会出现在公开列表中。

管理

大部分管理操作都可在 txAdmin 中完成:

菜单 用途
Live Console 实时服务器控制台
CFG Editor 编辑 server.cfg
Resources 资源列表和管理
Players 玩家、警告和封禁
Admins 管理员账户和权限
Settings 设置,包括重启计划(Restart Schedule)
Master Actions 仅限主账户的操作

在游戏中,按 F8 打开控制台并输入 tx,即可显示 txAdmin 菜单。

server.cfg 中一些实用的设置,可在 CFG Editor 中修改:

文本
sv_maxclients 48
sv_endpointPrivacy true
参数 描述
sv_maxclients 最大玩家数,取决于您的订阅
sv_endpointPrivacy 在公开信息中隐藏玩家的 IP 地址

Cfx.re 指出,服务器的名称和描述现在通过门户管理。请不要设置 rcon_password:这样 RCON 将保持禁用状态,并由 Live Console 取代。

服务器更新

该脚本会安装最新的推荐版本,且不会改动 txData:

终端
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

每次更新前请先备份。

自动备份

txData 包含您的资源、server.cfg 和 txAdmin 账户。因此备份中含有机密信息:请妥善保管,不要公开。

备份脚本

终端
sudo nano /usr/local/sbin/backup-fivem.sh

如果不使用 MariaDB,请将 DB_NAME 留空:

终端
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/fivem/backups"
DB_NAME="fivem"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

install -d -o fivem -g fivem -m 750 "$BACKUP_DIR"

# 服务器和 txAdmin 的文件,不含缓存
tar --exclude='*/cache' -czf "$BACKUP_DIR/fivem_$DATE.tar.gz" -C /home/fivem txData

# 数据库
if [ -n "$DB_NAME" ]; then
    mariadb-dump --single-transaction "$DB_NAME" | gzip > "$BACKUP_DIR/fivem_db_$DATE.sql.gz"
fi

chown fivem:fivem "$BACKUP_DIR"/fivem_*"$DATE"*

# 删除超过7天的备份
find "$BACKUP_DIR" -name "fivem_*.gz" -mtime +7 -delete
终端
sudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

计划备份

终端
sudo nano /etc/cron.d/fivem-backup
文本
# 每晚 5:30 备份
30 5 * * * root /usr/local/sbin/backup-fivem.sh

请定期将这些归档文件复制到服务器之外。

恢复备份

终端
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.old
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
zcat /home/fivem/backups/fivem_db_DATE.sql.gz | sudo mariadb fivem
sudo systemctl start fivem.service

请将 DATE 替换为归档文件的日期;如果不使用数据库,请跳过 zcat 这一行。

故障排除

服务无法启动

  • 查看服务日志:sudo journalctl -u fivem.service -n 50
  • 查看控制台:sudo tail -n 100 /home/fivem/fxserver.log
  • 确认架构为 x86_64:uname -m
  • 检查权限:sudo chown -R fivem:fivem /home/fivem

Failed to start HTTP server, port 40120 is already in use

另一个 txAdmin 实例已占用该端口。请找出该实例:

终端
sudo ss -ltnp | grep ':40120'

如果您手动运行过 run.sh,请在启动服务之前先停止该进程。

找不到 PIN 码

只有在尚无管理员时才会显示 PIN 码。请重启服务,等待几秒钟,然后重新运行 grep 命令。如果已存在账户,请使用该账户登录。

如果您丢失了主账户的密码,请停止服务,重命名 /home/fivem/txData/admins.json,然后重启:txAdmin 会再次提示创建管理员。

No license key was specified

密钥缺失或不正确。请在 CFG Editor 中检查 sv_licenseKey 这一行,或在 Cfx.re 门户上重新生成密钥。

服务器未出现在列表中

  • 使用 connect 服务器IP:30120 测试直接连接
  • 检查 http://服务器IP:30120/info.json 是否有响应
  • 检查端口 30120 是否同时开放了 TCP 和 UDP
  • 检查 server.cfg 中的 sv_master1 "" 行是否已用 # 注释
  • 启动后最多等待 8 分钟

服务器仍限制为 48 名玩家

需要 Element Club Argentum 或更高级别的订阅,并将服务器保持为最新版本,然后设置合适的 sv_maxclients 值并重启。

数据库连接错误

  • ECONNREFUSED:使用 sudo systemctl status mariadb 检查 MariaDB 是否正在运行,并确保主机使用 127.0.0.1
  • Access denied:检查用户名、密码和数据库名称
  • 如果密码包含特殊字符,请将其替换为使用 openssl rand -hex 16 生成的值

无法访问 txAdmin

  • 检查服务是否正在运行,以及端口 40120 是否正在监听
  • 检查您的公网 IP 地址是否仍与 您的IP 一致
  • 使用 SSH 隧道,它不依赖防火墙规则