IT

Server di gioco

Distribuire i contenuti Garry's Mod con FastDL e Nginx

Configura FastDL per Garry's Mod con Nginx: compressione bzip2, sv_downloadurl, resource.AddFile, pubblicazione sicura, verifica, ripristino e risoluzione dei problemi.

7 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Questa guida spiega come inviare ai giocatori i tuoi contenuti personalizzati tramite FastDL, da un sito Nginx dedicato: preparazione dei file, compressione, pubblicazione, configurazione del server e ripristino.

HostMyServers non offre hosting di giochi gestito: amministri tu stesso questo server sul tuo VPS o server dedicato.

Serve davvero FastDL?

Metodo Velocità Da usare per
Workshop (resource.AddWorkshop) La più veloce Qualsiasi contenuto pubblicabile sul Workshop, da preferire
FastDL (sv_downloadurl) Veloce, file per file Contenuti che non puoi pubblicare sul Workshop
Download dal server di gioco (sv_allowdownload) Limitato a 64 KB/s Da evitare

I file .lua non sono interessati: il gioco li trasmette con un altro meccanismo.

Come funziona

  1. Il server contrassegna dei file da scaricare con resource.AddFile. Questi file devono esistere sul server di gioco
  2. Il giocatore riceve l'indirizzo definito in sv_downloadurl
  3. Per ogni file mancante, richiede prima la versione compressa, poi quella normale:
Testo
http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmt.bz2
http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmt

Il percorso sul sito web deve quindi essere identico al percorso in garrysmod/.

Prerequisiti

  • Un server installato con la guida Creare un server Garry's Mod. Questa guida riparte dal suo utente gmod, dalla cartella /home/gmod/gmod-server e dal servizio gmod.service
  • Un accesso SSH con sudo
  • Un sottodominio, qui fastdl.tuo-dominio.com, con un record DNS A verso l'indirizzo IP del server
  • La porta 80 TCP disponibile: se un altro sito usa già Nginx su questo server, questa guida aggiunge semplicemente un sito separato

Controlla il DNS prima di continuare:

Terminale
getent hosts fastdl.tuo-dominio.com

Passo 1: salvare la configurazione

Terminale
sudo -u gmod cp -p /home/gmod/gmod-server/garrysmod/cfg/server.cfg /home/gmod/server.cfg.prima-fastdl
sudo -u gmod ls -l /home/gmod/server.cfg.prima-fastdl

Passo 2: installare Nginx e bzip2

Terminale
sudo apt update
sudo apt install -y nginx bzip2

Crea poi la cartella del sito. Appartiene a gmod, che vi pubblica i file, e resta leggibile da Nginx, che gira come www-data con i pacchetti Debian e Ubuntu:

Terminale
sudo install -d -o gmod -g www-data -m 2750 /var/www/gmod-fastdl /var/www/gmod-fastdl/releases
sudo ls -ld /var/www/gmod-fastdl /var/www/gmod-fastdl/releases

I permessi mostrati devono essere drwxr-s---, con gmod e www-data come proprietari.

Passo 3: caricare i tuoi contenuti

I tuoi file devono esistere sul server di gioco. Raggruppali in un addon, rispettando la struttura del gioco e usando solo minuscole:

Testo
garrysmod/addons/mio_contenuto/
├── materials/mio_server/logo.vmt
├── materials/mio_server/logo.vtf
├── models/mio_server/cassa.mdl
└── sound/mio_server/annuncio.mp3

Se hai inviato questi file nella cartella ~/mio_contenuto del tuo account di amministrazione, copiali così:

Terminale
sudo mkdir -p /home/gmod/gmod-server/garrysmod/addons/mio_contenuto
sudo cp -r ~/mio_contenuto/. /home/gmod/gmod-server/garrysmod/addons/mio_contenuto/
sudo chown -R gmod:gmod /home/gmod/gmod-server/garrysmod/addons/mio_contenuto

Passo 4: creare lo script di pubblicazione

Questo script copia i tipi di file autorizzati, li comprime e pubblica il tutto in una nuova versione. Conserva le versioni recenti per consentire un ripristino.

Terminale
sudo -u gmod nano /home/gmod/fastdl-sync.sh
Terminale
#!/bin/bash
set -euo pipefail
umask 027

GAME="/home/gmod/gmod-server/garrysmod"
WEB="/var/www/gmod-fastdl"
KEEP=3

# Cartelle da pubblicare, ciascuna organizzata come garrysmod/
SOURCES=(
    "$GAME/addons/mio_contenuto"
    "$GAME/gamemodes/darkrp/content"
)

NEW="$WEB/releases/$(date +%Y-%m-%d_%H-%M-%S)"
mkdir "$NEW"

for src in "${SOURCES[@]}"; do
    [ -d "$src" ] || continue
    cd "$src"
    for dir in maps materials models particles resource sound; do
        [ -d "$dir" ] || continue
        find "$dir" -type f \( \
            -iname '*.bsp' -o -iname '*.vmt' -o -iname '*.vtf' -o -iname '*.png' -o -iname '*.jpg' \
            -o -iname '*.mdl' -o -iname '*.vvd' -o -iname '*.vtx' -o -iname '*.phy' -o -iname '*.ani' \
            -o -iname '*.pcf' -o -iname '*.ttf' -o -iname '*.otf' \
            -o -iname '*.wav' -o -iname '*.mp3' -o -iname '*.ogg' \
        \) -print0 | while IFS= read -r -d '' file; do
            mkdir -p "$NEW/$(dirname "$file")"
            cp -- "$file" "$NEW/$file"
            bzip2 -9 -k -f -- "$NEW/$file"
        done
    done
done

count=$(find "$NEW" -type f ! -name '*.bz2' | wc -l)
if [ "$count" -eq 0 ]; then
    rm -rf "$NEW"
    echo "Nessun file da pubblicare: versione attuale conservata." >&2
    exit 1
fi

ln -sfn "$NEW" "$WEB/current"

# Eliminare le versioni più vecchie
ls -1dt "$WEB"/releases/* | tail -n +$((KEEP + 1)) | xargs -r rm -rf --

echo "Pubblicazione completata: $count file in $NEW"

Rendi lo script eseguibile, poi lancialo:

Terminale
sudo -u gmod chmod 700 /home/gmod/fastdl-sync.sh
sudo -u gmod /home/gmod/fastdl-sync.sh

La cartella gamemodes/darkrp/content viene ignorata se non esiste. È elencata perché DarkRP contrassegna alcuni dei suoi file con resource.AddFile: devono quindi essere disponibili anche su FastDL. Aggiungi a SOURCES qualsiasi altro addon i cui contenuti siano contrassegnati.

Passo 5: configurare Nginx

Terminale
sudo nano /etc/nginx/sites-available/gmod-fastdl
Nginx
server {
    listen 80;
    listen [::]:80;
    server_name fastdl.tuo-dominio.com;

    root /var/www/gmod-fastdl/current;
    autoindex off;
    gzip off;

    types { }
    default_type application/octet-stream;
    add_header X-Content-Type-Options nosniff always;

    access_log /var/log/nginx/gmod-fastdl.access.log;
    error_log /var/log/nginx/gmod-fastdl.error.log;

    location / {
        return 404;
    }

    location ~ ^/(maps|materials|models|particles|resource|sound)/ {
        limit_except GET {
            deny all;
        }
        try_files $uri =404;
    }
}

Sono accessibili solo le cartelle dei contenuti. Attiva il sito, testa la configurazione e ricarica Nginx:

Terminale
sudo ln -s /etc/nginx/sites-available/gmod-fastdl /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t
sudo systemctl reload nginx

nginx -t deve indicare syntax is ok e test is successful.

Passo 6: aprire la porta 80

Usa lo strumento firewall già presente sul tuo server.

Con UFW

Terminale
sudo ufw allow 80/tcp
sudo ufw reload

Con iptables

Terminale
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Con nftables

Terminale
sudo nft add rule inet filter input tcp dport 80 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Passo 7: verificare il sito

Testa uno dei tuoi file, adattandone il percorso. Il primo comando deve rispondere 200:

Terminale
curl -I http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmt.bz2
curl -fsS http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmt.bz2 | bunzip2 | sudo -u gmod cmp - /home/gmod/gmod-server/garrysmod/addons/mio_contenuto/materials/mio_server/logo.vmt

Il comando cmp non deve mostrare nulla: il file pubblicato è quindi identico all'originale.

Verifica anche che il resto non sia accessibile. Queste due richieste devono rispondere 404:

Terminale
curl -I http://fastdl.tuo-dominio.com/
curl -I http://fastdl.tuo-dominio.com/cfg/server.cfg

Passo 8: contrassegnare i file da scaricare

Crea un file Lua lato server:

Terminale
sudo -u gmod mkdir -p /home/gmod/gmod-server/garrysmod/lua/autorun/server
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.lua
lua
resource.AddFile( "materials/mio_server/logo.vmt" )
resource.AddFile( "models/mio_server/cassa.mdl" )
resource.AddFile( "sound/mio_server/annuncio.mp3" )

Indica il percorso a partire da garrysmod/, senza addons/mio_contenuto/ e senza .bz2. resource.AddFile aggiunge anche i file collegati: il .vtf di un .vmt, oppure i .vvd, .vtx e .phy di un .mdl. Il gioco limita questo elenco a 8192 file.

Passo 9: attivare FastDL sul server

Terminale
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/cfg/server.cfg

Aggiungi queste righe, senza / alla fine dell'indirizzo:

Testo
sv_downloadurl "http://fastdl.tuo-dominio.com"
sv_allowdownload 0

sv_allowdownload 0 disattiva il download diretto dal server di gioco, lento ed esposto ad abusi. Riavvia il server:

Terminale
sudo systemctl restart gmod.service

Passo 10: verificare in gioco

  1. Sul server, segui le richieste:

    Terminale
    sudo tail -f /var/log/nginx/gmod-fastdl.access.log
  2. Sul tuo PC, elimina il contenuto di prova dalla cartella garrysmod/download/ se esiste

  3. Connettiti al server

Le richieste dei tuoi file .bz2 devono comparire con il codice 200 e i contenuti devono essere visualizzati in gioco. Premi Ctrl+C per uscire dal monitoraggio.

Aggiornare un contenuto

Il gioco non confronta il contenuto dei file: un giocatore che ha già un file non lo scarica di nuovo, anche se è cambiato. Per distribuire una nuova versione, assegna un nuovo nome al file e adatta fastdl.lua e i riferimenti al file.

Pubblica poi, quindi riavvia il server se fastdl.lua è cambiato:

Terminale
sudo -u gmod /home/gmod/fastdl-sync.sh
sudo systemctl restart gmod.service

Tornare indietro

Tornare a una pubblicazione precedente

Terminale
sudo -u gmod ls -1t /var/www/gmod-fastdl/releases
sudo -u gmod ln -sfn /var/www/gmod-fastdl/releases/AAAA-MM-GG_HH-MM-SS /var/www/gmod-fastdl/current

La modifica è immediata, senza riavviare Nginx.

Disattivare FastDL

Terminale
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/server.cfg.prima-fastdl /home/gmod/gmod-server/garrysmod/cfg/server.cfg
sudo -u gmod rm -f /home/gmod/gmod-server/garrysmod/lua/autorun/server/fastdl.lua
sudo rm -f /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t && sudo systemctl reload nginx
sudo systemctl start gmod.service

La copia di server.cfg non contiene le modifiche fatte dopo il passo 1: riportale se necessario.

In caso di problemi

HTTP ERROR 1 (Zero Length File) downloading ... o HTTP ERROR 2 (Connection closed) downloading ...

Questi messaggi compaiono nella console del giocatore. Verifica che sv_downloadurl inizi con http://, che il proxy Cloudflare sia disattivato sul sottodominio e che il file indicato risponda a curl -I.

Il log di Nginx mostra errori 404

Il file non è pubblicato, oppure il suo percorso è diverso. Elenca le richieste fallite:

Terminale
sudo awk '$9 == 404 {print $7}' /var/log/nginx/gmod-fastdl.access.log | sort | uniq -c | sort -rn | head

Controlla le maiuscole e minuscole del percorso, aggiungi se serve la sua cartella a SOURCES e rilancia lo script. Le richieste verso / o altri indirizzi non pertinenti provengono spesso da bot e possono essere ignorate.

Il log di Nginx mostra errori 403 o Permission denied

Controlla ogni livello di permessi:

Terminale
sudo namei -l /var/www/gmod-fastdl/current/materials

Le cartelle devono appartenere al gruppo www-data. Se hai pubblicato con un utente diverso da gmod, correggi i permessi, poi rilancia lo script:

Terminale
sudo chown -R gmod:www-data /var/www/gmod-fastdl

mkdir: cannot create directory ... Permission denied

Lo script non è stato lanciato con gmod, oppure la cartella non è stata creata al passo 2. Usa sudo -u gmod /home/gmod/fastdl-sync.sh.

Nessun file da pubblicare

La cartella sorgente è vuota, oppure i file non si trovano in materials, models, sound o in un'altra cartella riconosciuta. Controlla la struttura del passo 3.

bind() to 0.0.0.0:80 failed (98: Address already in use)

Un altro servizio occupa la porta 80. Identificalo con sudo ss -ltnp | grep ':80 '.

I giocatori non scaricano nulla

  • Verifica il valore attivo con rcon sv_downloadurl
  • Verifica che il file sia contrassegnato in fastdl.lua e presente sul server di gioco: altrimenti non viene aggiunto all'elenco
  • Il giocatore potrebbe aver limitato i download nelle sue opzioni. Il comando cl_downloadfilter nella sua console deve valere all
  • Il file potrebbe già trovarsi nella sua cartella garrysmod/download/

I giocatori vedono ancora la vecchia versione

È il comportamento normale del gioco. Rinomina il file, come indicato nella sezione sull'aggiornamento.

FAQ

Devo pubblicare gli addon del Workshop su FastDL?

No. Usa resource.AddWorkshop, descritto nella guida all'installazione del server.

Posso ospitare FastDL su un altro server?

Sì. Installa Nginx su quella macchina e copiaci il contenuto di current con rsync o scp. I file devono restare presenti sul server di gioco, altrimenti resource.AddFile non li aggiunge all'elenco.

I file .bz2 sono obbligatori?

No, ma riducono il volume trasferito. Lo script conserva anche la versione normale, usata se la versione compressa è assente.