02 - FXServer e txAdmin

3 min read

FXServer e txAdmin

INFO

FXServer è il processo eseguibile del server FiveM. txAdmin è il pannello web che lo gestisce (avvio, backup, monitoraggio, permessi). Qui vediamo come installarli entrambi.

ObiettivoDettagli
Cosa imparerai• Scaricare e avviare gli artifact FXServer
• Ottenere la license key da Keymaster
• Installare e usare txAdmin
Prerequisiti• Account Cfx.re
• Cartella di lavoro dedicata al server

1. License Key (Keymaster)

La license key identifica il tuo server su Cfx.re ed è obbligatoria.

  1. Vai su https://portal.cfx.re/ e accedi
  2. Sezione Keymaster → Create new
  3. Scegli Server License
  4. Compila: nome server, community, IP (0.0.0.0 per dinamico)
  5. Copia la chiave: cfxk_xxxxxxxxxxxxxxxxxxxxxxxxx

WARNING

La license key è legata al tuo account. Non condividerla pubblicamente: può essere usata per impersonare il tuo server.

2. Scaricare gli Artifacts

Gli artifact sono i binari del server. Scarica sempre l’ultima versione raccomandata (non le versioni “optional” se non hai motivo).

Windows

  1. Vai su https://runtime.fivem.net/artifacts/fiveam/
  2. Scarica l’ultima build Recommended
  3. Estrai in una cartella tipo C:\fivem-server\

Linux (VPS)

mkdir -p ~/fivem-server && cd ~/fivem-server
# Sostituisci la versione con l'ultima raccomandata
wget https://runtime.fivem.net/artifacts/five/server/linux/xxxxx/fx.tar.xz
tar -xf fx.tar.xz

3. Struttura del Server

Dopo l’estrazione, crea la struttura base:

fivem-server/
├── FXServer.exe           ← Binario (Windows)
├── run.sh / run.cmd       ← Script di avvio
├── server.cfg             ← Configurazione
├── resources/             ← Le tue risorse
└── txData/                ← Dati txAdmin (auto-creata)

TIP

La cartella resources/ è case-sensitive su Linux. Mantieni i nomi delle cartelle coerenti (es. ox_lib, es_extended) per evitare problemi di avvio.

4. Avviare FXServer in Modalità Vanilla

Senza txAdmin, si avvia con la license key da linea di comando:

# Windows (run.cmd)
FXServer.exe +set sv_licenseKey "cfxk_XXXX" +set gamename gta5 +exec server.cfg
 
# Linux (run.sh)
chmod +x run.sh && ./run.sh +set sv_licenseKey "cfxk_XXXX" +set gamename gta5 +exec server.cfg

5. Installare txAdmin

txAdmin è la soluzione consigliata per gestire il server via browser.

Opzione A — Bundle ufficiale

Scarica il txAdmin full package da https://github.com/tabarra/txAdmin/releases (tag FxServer): contiene FXServer + txAdmin insieme, già configurati.

Opzione B — Aggiungere a FXServer esistente

# Nella cartella del server
cd resources
git clone https://github.com/tabarra/txAdmin.git

Poi nel server.cfg:

ensure txAdmin
set txAdminPort 40120

Primo accesso

  1. Avvia il server
  2. Vai su http://localhost:40120/ (o IP_SERVER:40120)
  3. Crea la password admin
  4. Segui la procedura guidata: nome server, license key, template

TIP

txAdmin genera automaticamente un server.cfg di base se non esiste. Puoi comunque mantenerne uno tuo e selezionarlo.

6. Funzioni Utili di txAdmin

FunzioneDescrizione
Live ConsoleConsole del server nel browser
PlayersLista giocatori, kick, ban
ResourcesStart/stop/restart risorse
SchedulerRiavvii programmati (es. ogni 6h)
BackupBackup automatici del server
DeployerAggiornamento artifacts
Admin PermissionsGestione permessi

Riavvio Programmato

Scheduler → Nuovo job → Command: ensure myresource

WARNING

I riavvii automatici frequenti (ogni 1-2h) sono un pattern diffuso ma non risolvono problemi di performance: nascondono i leak invece di sistemarli. Usa il riavvio come misura di sicurezza, non come soluzione.

7. Aggiornare gli Artifacts

  • txAdmin → Deployer → Update → seleziona la nuova versione
  • Manuale: scarica gli artifacts e sovrascrivi i file (fai backup di txData/ e resources/)

WARNING

Prima di aggiornare, leggi i changelog del server e dei tuoi framework (ESX, ox_*): alcune versioni richiedono l’aggiornamento coordinato di più risorse.

TIP

Prossimo passo: 03 - server.cfg

Torna alla: Indice Generale