FiveM server na Linuxu – instalace, server.cfg a txAdmin

FiveM je multiplayerová modifikace pro GTA V, na které běží většina roleplay serverů. Serverová část se jmenuje FXServer (Cfx.re platforma) a dá se provozovat na Windows i Linuxu. Tento návod ukazuje čistou instalaci na Linux VPS – bez frameworku jako ESX nebo QBCore, které se instalují až nad ní.

Co budete potřebovat

• Linux VPS (Ubuntu/Debian), pro malý server stačí 2–4 jádra a 4 GB RAM, s roleplay frameworkem a mnoha skripty víc.
• Účet na portal.cfx.re pro vygenerování licenčního klíče serveru (sv_licenseKey).
• Otevřený port 30120 TCP i UDP, pro webové rozhraní txAdmin port 40120 TCP.
• Hráči musí vlastnit legální kopii GTA V.

1. Uživatel a adresáře

FXServer nespouštějte jako root:

sudo adduser --disabled-password --gecos "" fivem
sudo -iu fivem
mkdir -p ~/server ~/server-data

2. Stažení FXServeru

Linuxové buildy najdete na https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/. Vyberte doporučený (recommended) build, zkopírujte odkaz na fx.tar.xz a stáhněte:

cd ~/server
wget "ODKAZ_NA/fx.tar.xz"
tar xf fx.tar.xz
rm fx.tar.xz

Nevybírejte slepě nejnovější build – stránka označuje, které buildy jsou doporučené a které mají známé problémy.

3. Základní server-data

Oficiální sada základních resources je v repozitáři cfx-server-data:

cd ~
git clone https://github.com/citizenfx/cfx-server-data.git server-data

Obsahuje složku resources/ s výchozími skripty (chat, spawnmanager, mapmanager, sessionmanager…).

4. server.cfg

Vytvořte ~/server-data/server.cfg:

# Síť
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Základní resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Informace o serveru
sv_hostname "Muj FiveM server"
sets sv_projectName "Muj server"
sets sv_projectDesc "Testovaci server"
sets locale "cs-CZ"
sv_maxclients 32

# Bezpečnost
sv_scriptHookAllowed 0

# OneSync (nutný pro více hráčů a moderní skripty)
set onesync on

# Oprávnění
add_ace group.admin command allow
add_principal identifier.fivem:123456 group.admin

# Licenční klíč z portal.cfx.re
sv_licenseKey "VAS_KLIC"

• ensure spustí resource (a při změně ho restartuje).
• sv_scriptHookAllowed 0 zakáže klientům ScriptHook – důležité proti podvádění.
• identifier.fivem:123456 nahraďte svým identifikátorem (ID účtu Cfx.re).
• Maximální povolený sv_maxclients závisí na vašem účtu na Cfx.re platformě.

Licenční klíč nikdy nedávejte do veřejného repozitáře. Pokud verzujete konfiguraci v gitu, přesuňte citlivé řádky do samostatného souboru a načtěte ho přes exec secrets.cfg.

5. První spuštění

cd ~/server-data
bash ~/server/run.sh +exec server.cfg

Server se spustí v terminálu. V konzoli můžete psát příkazy (status, restart chat, quit). Pro test se připojte z klienta FiveM přes F8 konzoli: connect IP_SERVERU:30120.

6. txAdmin

txAdmin je webový panel pro správu FiveM serveru, který je součástí FXServeru. Spustíte ho tak, že run.sh zavoláte bez +exec:

bash ~/server/run.sh

V konzoli se objeví adresa (port 40120) a PIN. V prohlížeči projdete průvodcem: propojení s účtem Cfx.re, výběr adresáře server-data nebo nasazení šablony (včetně ESX či QBCore receptů).

txAdmin pak řídí start serveru, automatické restarty, zálohy databáze u receptů, ban systém a plánované restarty. Port 40120 ale chraňte – nejlépe povolte jen pro svou IP:

sudo ufw allow 30120
sudo ufw allow from VASE_IP to any port 40120 proto tcp

7. Spuštění jako služba

Aby server běžel i po odhlášení a restartu VPS, vytvořte /etc/systemd/system/fivem.service:

[Unit]
Description=FiveM txAdmin
After=network-online.target
Wants=network-online.target

[Service]
User=fivem
WorkingDirectory=/home/fivem/server-data
ExecStart=/bin/bash /home/fivem/server/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now fivem
journalctl -u fivem -f

PIN pro první přihlášení do txAdminu najdete v logu služby.

Alternativou je provozovat FiveM v Pterodactylu – komunitní egg pro FiveM existuje a txAdmin v něm běží také.

Frameworky a databáze

Roleplay frameworky (ESX, QBCore, Qbox) potřebují databázi MariaDB/MySQL a resource oxmysql. Připojení se nastavuje v server.cfg:

set mysql_connection_string "mysql://fivem:[email protected]/fivem?charset=utf8mb4"

Časté problémy

Problém	Příčina
Server není v seznamu serverů	chybí/neplatný licenční klíč, blokovaný port 30120
Hráči se nepřipojí, ale lokálně ano	povolen jen TCP, chybí UDP
Resource se nespustí	chybí ensure, chyba ve fxmanifest.lua
Lagy s více hráči	vypnutý OneSync nebo náročné skripty – použijte příkaz resmon v klientovi

Při hledání chyby v Lua nebo JS skriptu se hodí vložit fxmanifest.lua a chybovou hlášku do ColdHost AI v režimu Programování.