如何更新 FXServer artifacts
在 Linux FiveM 服务器上更新 FXServer 和 txAdmin:检查版本、备份、安装推荐或指定的构建、验证以及回退。
本页内容
artifacts 是 Cfx.re 发布的 FiveM 服务器文件:FXServer 以及它所内置的 txAdmin 版本。本指南介绍如何妥善地更新它们,并保留上一个版本,以便用几条命令即可回退。
前提条件
- 已按照指南创建 FiveM 服务器安装服务器,包括其中的
/home/fivem/update-fxserver.sh脚本和备份脚本/usr/local/sbin/backup-fivem.sh - 具有
sudo权限的 SSH 访问 - 一段没有玩家的时间:操作期间服务器会停止
本指南与安装指南一样,针对的是 GTA V Legacy 版的 FiveM。GTA V Enhanced 版的 FiveM 使用另一个服务器压缩包。
何时更新
Cfx.re 主要发布两个渠道:
| 渠道 | 用途 |
|---|---|
recommended |
建议用于生产服务器的版本 |
latest |
最新的版本,适合测试新功能或修复 |
根据 Cfx.re 的支持政策,推荐版本在下一个版本发布后的六周内仍受支持,latest 版本在下一个版本发布后的两周内仍受支持。旧版本仍可继续运行,但不再受支持。超过三个月的不受支持版本,将无法再从服务器列表中加入。
步骤 1:查看版本
在服务器运行时,显示已安装的版本:
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'
sudo grep -E "^version" /home/fivem/server/alpine/opt/cfx-server/citizen/system_resources/monitor/fxmanifest.lua第一行例如显示 FXServer-master v1.0.0.12345 linux:构建号是最后一个数字,这里是 12345。第二行给出 txAdmin 的版本。请记下这两个值。
与已发布的版本进行比较:
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"(recommended|latest)":"[0-9]+"'如果您的构建与 recommended 相同,则无需更新。
步骤 2:备份
检查磁盘空间,然后运行备份:
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups需要有足够空间存放 /home/fivem/server 的第二份副本。请记下最新归档文件 fivem_DATE.tar.gz 的日期。
步骤 3:安装推荐版本
停止服务器,保留当前版本的副本,然后运行安装脚本:
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service该脚本只会替换 /home/fivem/server。您的资源、server.cfg 和 txAdmin 账户仍保留在 /home/fivem/txData 中。
安装指定的构建
此方法用于测试 latest 或选择某个特定构建。请创建第二个脚本:
sudo -iu fivem
nano ~/install-fxserver-build.sh#!/bin/bash
set -euo pipefail
URL="${1:?请将 fx.tar.xz 的链接作为参数传入}"
case "$URL" in
https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/*/fx.tar.xz) ;;
*) echo "地址被拒绝:应为 Linux 官方压缩包" >&2; exit 1 ;;
esac
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"
[ -x "$TMP/run.sh" ] && [ -d "$TMP/alpine" ] || { echo "压缩包不完整" >&2; exit 1; }
rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"
echo "已安装版本:$URL"chmod +x ~/install-fxserver-build.sh
exit然后获取所需的地址。对于 latest:
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4对于其他构建,请从官方 Linux 构建列表中复制其 fx.tar.xz 文件的地址。完成步骤 2 的备份后,替换 FX_TAR_XZ_URL 进行安装:
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/install-fxserver-build.sh 'FX_TAR_XZ_URL'
sudo systemctl start fivem.service步骤 4:检查服务器
等待约一分钟,然后检查服务、端口和新版本:
sudo systemctl is-active fivem.service
sudo ss -tulpn | grep -E ':(30120|40120)\b'
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'服务应返回 active,两个端口都应处于监听状态,构建号也应已发生变化。接着查找启动错误:
sudo grep -a -E "Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log与平时相比,此命令不应返回任何新内容。如果您使用数据库,请同时检查连接:
sudo grep -a 'Database server connection established' /home/fivem/fxserver.log最后连接游戏并测试主要功能:角色登录、物品栏、载具、管理命令。
请将 /home/fivem/server.previous 保留几天。一切稳定后,释放空间:
sudo -u fivem rm -rf /home/fivem/server.previous回退到上一个版本
将保留的文件夹放回原位:
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server.previous /home/fivem/server
sudo systemctl start fivem.service使用步骤 1 的命令检查版本,然后查看控制台:
sudo tail -n 50 /home/fivem/fxserver.log如果回退后 txAdmin 拒绝启动
较新版本的 txAdmin 可能已转换了其玩家数据库。此时旧版本会停止,并显示以下消息:
Your players database is on v5, and this txAdmin supports up to v4.请从步骤 2 的归档中恢复 txData,并替换 DATE:
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.failed
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
sudo systemctl start fivem.service自该备份以来在 txAdmin 中进行的操作(例如封禁)将会丢失。无需恢复 MariaDB:更新 FXServer 不会修改您的数据库。确认服务器正常后,请删除 /home/fivem/txData.failed。
故障排除
找不到下载地址
脚本未能从 Cfx.re 获得可用的响应。请测试访问:
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/server如果命令失败,请检查服务器的出站连接和 DNS,然后稍后再试。
curl: (22) The requested URL returned error: 404
压缩包的地址不完整或有误。请完整复制,包含构建号、其标识符和 fx.tar.xz。
tar (child): xz: Cannot exec: No such file or directory
缺少用于解压该压缩包的软件包:
sudo apt install -y xz-utilsNo space left on device
磁盘已满。请使用 sudo bash -c 'du -sh /home/fivem/*' 找出占用空间的内容,然后删除旧的 server.failed 和 txData.failed 文件夹,或将归档文件移出服务器。同时也请删除因中断而遗留的任何 /home/fivem/fxserver.* 临时文件夹。
服务处于活动状态,但端口没有监听
请查看控制台并检查权限:
sudo tail -n 100 /home/fivem/fxserver.log
sudo ls -l /home/fivem/server/run.sh
sudo chown -R fivem:fivem /home/fivem/server更新后出现 Resource can't run
消息 Resource 'name' can't run: 后面跟着 server needs to be 12345 or higher,表示该资源需要更新的构建。请安装该构建,或使用该资源的较旧版本。如果某个资源之前能正常运行,现在却以其他方式失败,请参阅诊断 FiveM 服务器的崩溃和卡顿,或在修复期间先回退到上一个版本。
end-of-support 或 end-of-life 警告
当 artifacts 过旧时,该消息会向玩家和管理员显示。灰色警告(end-of-support)不影响服务器的访问。红色警告(end-of-life)可能会导致无法连接:请更新服务器。