如何使用 txAdmin 创建 FiveM 服务器
在 VPS 或专用 Linux 服务器上使用 txAdmin 安装 FiveM 服务器的完整指南:Cfx.re 许可证密钥、systemd 服务、防火墙、MariaDB 数据库、更新和备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装 FiveM 服务器(FXServer),通过其 Web 管理界面 txAdmin 进行配置,并以专用用户将其作为服务运行。
订购服务器
要托管您的 FiveM 服务器,HostMyServers 提供多种选择。使用角色扮演(roleplay)类框架并加载大量资源的服务器需要高速处理器和充足的内存。
- Performance VPS - 独享资源和高速处理器,非常适合 FiveM
- NVMe VPS - 适合小型服务器或测试服务器
- 经济型专用服务器 - 适合玩家较多的服务器
- 性能专用服务器 - 最佳性能
前提条件
- 以 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_ 开头。
- 使用您的账户登录 Cfx.re 门户。
- 打开服务器注册密钥页面。
- 点击 + 按钮,填写所需信息(服务器的名称、标语、描述和语言),然后点击 Generate Key。
- 使用 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配置向导
- 输入 PIN 码,然后点击 Link Account 并使用您的 Cfx.re 账户登录。
- 设置 txAdmin 管理员密码。
- 为您的服务器命名。
- 选择 Popular Recipes,然后选择一个模板。对于简单的服务器,请选择 Cfx.re 的基础模板(FiveM Basic Server,有时显示为 CFX Default FiveM)。
- 保留建议的目标文件夹,然后进入 Recipe Deployer。
- 粘贴您的
cfxk_密钥,如果模板需要数据库,请填写数据库信息,然后点击 Run Recipe。 - 部署完成后,点击 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 mariadbCREATE 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 没有响应。
连接到服务器
- 启动 FiveM。
- 按
F8键打开控制台。 - 输入:
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 -deletesudo 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.1Access denied:检查用户名、密码和数据库名称- 如果密码包含特殊字符,请将其替换为使用
openssl rand -hex 16生成的值
无法访问 txAdmin
- 检查服务是否正在运行,以及端口 40120 是否正在监听
- 检查您的公网 IP 地址是否仍与
您的IP一致 - 使用 SSH 隧道,它不依赖防火墙规则