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.
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
- Il server contrassegna dei file da scaricare con
resource.AddFile. Questi file devono esistere sul server di gioco - Il giocatore riceve l'indirizzo definito in
sv_downloadurl - Per ogni file mancante, richiede prima la versione compressa, poi quella normale:
http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmt.bz2
http://fastdl.tuo-dominio.com/materials/mio_server/logo.vmtIl 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-servere dal serviziogmod.service - Un accesso SSH con
sudo - Un sottodominio, qui
fastdl.tuo-dominio.com, con un record DNSAverso 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:
getent hosts fastdl.tuo-dominio.comPasso 1: salvare la configurazione
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-fastdlPasso 2: installare Nginx e bzip2
sudo apt update
sudo apt install -y nginx bzip2Crea 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:
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/releasesI 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:
garrysmod/addons/mio_contenuto/
├── materials/mio_server/logo.vmt
├── materials/mio_server/logo.vtf
├── models/mio_server/cassa.mdl
└── sound/mio_server/annuncio.mp3Se hai inviato questi file nella cartella ~/mio_contenuto del tuo account di amministrazione, copiali così:
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_contenutoPasso 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.
sudo -u gmod nano /home/gmod/fastdl-sync.sh#!/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:
sudo -u gmod chmod 700 /home/gmod/fastdl-sync.sh
sudo -u gmod /home/gmod/fastdl-sync.shLa 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
sudo nano /etc/nginx/sites-available/gmod-fastdlserver {
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:
sudo ln -s /etc/nginx/sites-available/gmod-fastdl /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t
sudo systemctl reload nginxnginx -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
sudo ufw allow 80/tcp
sudo ufw reloadCon iptables
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4Con nftables
sudo nft add rule inet filter input tcp dport 80 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confPasso 7: verificare il sito
Testa uno dei tuoi file, adattandone il percorso. Il primo comando deve rispondere 200:
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.vmtIl 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:
curl -I http://fastdl.tuo-dominio.com/
curl -I http://fastdl.tuo-dominio.com/cfg/server.cfgPasso 8: contrassegnare i file da scaricare
Crea un file Lua lato server:
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.luaresource.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
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/cfg/server.cfgAggiungi queste righe, senza / alla fine dell'indirizzo:
sv_downloadurl "http://fastdl.tuo-dominio.com"
sv_allowdownload 0sv_allowdownload 0 disattiva il download diretto dal server di gioco, lento ed esposto ad abusi. Riavvia il server:
sudo systemctl restart gmod.servicePasso 10: verificare in gioco
-
Sul server, segui le richieste:
Terminalesudo tail -f /var/log/nginx/gmod-fastdl.access.log -
Sul tuo PC, elimina il contenuto di prova dalla cartella
garrysmod/download/se esiste -
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:
sudo -u gmod /home/gmod/fastdl-sync.sh
sudo systemctl restart gmod.serviceTornare indietro
Tornare a una pubblicazione precedente
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/currentLa modifica è immediata, senza riavviare Nginx.
Disattivare FastDL
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.serviceLa 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:
sudo awk '$9 == 404 {print $7}' /var/log/nginx/gmod-fastdl.access.log | sort | uniq -c | sort -rn | headControlla 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:
sudo namei -l /var/www/gmod-fastdl/current/materialsLe cartelle devono appartenere al gruppo www-data. Se hai pubblicato con un utente diverso da gmod, correggi i permessi, poi rilancia lo script:
sudo chown -R gmod:www-data /var/www/gmod-fastdlmkdir: 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.luae presente sul server di gioco: altrimenti non viene aggiunto all'elenco - Il giocatore potrebbe aver limitato i download nelle sue opzioni. Il comando
cl_downloadfilternella sua console deve valereall - 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.