Servir les contenus Garry's Mod avec FastDL et Nginx
Configurez FastDL pour Garry's Mod avec Nginx : compression bzip2, sv_downloadurl, resource.AddFile, publication sécurisée, vérification, retour arrière et dépannage.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment envoyer vos contenus personnalisés aux joueurs par FastDL, depuis un site Nginx dédié : préparation des fichiers, compression, publication, configuration du serveur et retour arrière.
HostMyServers ne propose pas d'hébergement de jeux géré : vous administrez vous-même ce serveur sur votre VPS ou votre serveur dédié.
Faut-il utiliser FastDL ?
| Méthode | Vitesse | À utiliser pour |
|---|---|---|
Workshop (resource.AddWorkshop) |
La plus rapide | Tout contenu publiable sur le Workshop, à privilégier |
FastDL (sv_downloadurl) |
Rapide, fichier par fichier | Contenus que vous ne pouvez pas publier sur le Workshop |
Téléchargement depuis le serveur de jeu (sv_allowdownload) |
Limité à 64 Ko/s | À éviter |
Les fichiers .lua ne sont pas concernés : le jeu les transmet par un autre mécanisme.
Fonctionnement
- Le serveur marque des fichiers à télécharger avec
resource.AddFile. Ces fichiers doivent exister sur le serveur de jeu - Le joueur reçoit l'adresse définie dans
sv_downloadurl - Pour chaque fichier manquant, il demande d'abord la version compressée, puis la version normale :
http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmt.bz2
http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmtLe chemin sur le site web doit donc être identique au chemin dans garrysmod/.
Prérequis
- Un serveur installé avec le guide Créer un serveur Garry's Mod. Ce guide repart de son utilisateur
gmod, du dossier/home/gmod/gmod-serveret du servicegmod.service - Un accès SSH avec
sudo - Un sous-domaine, ici
fastdl.votre-domaine.com, avec un enregistrement DNSAvers l'adresse IP du serveur - Le port 80 TCP disponible : si un autre site utilise déjà Nginx sur ce serveur, ce guide ajoute simplement un site séparé
Contrôlez le DNS avant de continuer :
getent hosts fastdl.votre-domaine.comÉtape 1 : sauvegarder la configuration
sudo -u gmod cp -p /home/gmod/gmod-server/garrysmod/cfg/server.cfg /home/gmod/server.cfg.avant-fastdl
sudo -u gmod ls -l /home/gmod/server.cfg.avant-fastdlÉtape 2 : installer Nginx et bzip2
sudo apt update
sudo apt install -y nginx bzip2Créez ensuite le dossier du site. Il appartient à gmod, qui y publie les fichiers, et reste lisible par Nginx, qui tourne sous www-data avec les paquets Debian et 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/releasesLes droits affichés doivent être drwxr-s---, avec gmod et www-data comme propriétaires.
Étape 3 : déposer vos contenus
Vos fichiers doivent exister sur le serveur de jeu. Regroupez-les dans un addon, en respectant l'arborescence du jeu et en n'utilisant que des minuscules :
garrysmod/addons/mon_contenu/
├── materials/mon_serveur/logo.vmt
├── materials/mon_serveur/logo.vtf
├── models/mon_serveur/caisse.mdl
└── sound/mon_serveur/annonce.mp3Si vous avez envoyé ces fichiers dans le dossier ~/mon_contenu de votre compte d'administration, copiez-les ainsi :
sudo mkdir -p /home/gmod/gmod-server/garrysmod/addons/mon_contenu
sudo cp -r ~/mon_contenu/. /home/gmod/gmod-server/garrysmod/addons/mon_contenu/
sudo chown -R gmod:gmod /home/gmod/gmod-server/garrysmod/addons/mon_contenuÉtape 4 : créer le script de publication
Ce script copie les types de fichiers autorisés, les compresse et publie le tout dans une nouvelle version. Il conserve les versions récentes pour permettre un retour arrière.
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
# Dossiers à publier, chacun organisé comme garrysmod/
SOURCES=(
"$GAME/addons/mon_contenu"
"$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 "Aucun fichier à publier : version actuelle conservée." >&2
exit 1
fi
ln -sfn "$NEW" "$WEB/current"
# Supprimer les versions les plus anciennes
ls -1dt "$WEB"/releases/* | tail -n +$((KEEP + 1)) | xargs -r rm -rf --
echo "Publication terminée : $count fichiers dans $NEW"Rendez le script exécutable, puis lancez-le :
sudo -u gmod chmod 700 /home/gmod/fastdl-sync.sh
sudo -u gmod /home/gmod/fastdl-sync.shLe dossier gamemodes/darkrp/content est ignoré s'il n'existe pas. Il est listé car DarkRP marque certains de ses fichiers avec resource.AddFile : ils doivent donc aussi être disponibles sur FastDL. Ajoutez à SOURCES tout autre addon dont les contenus sont marqués.
Étape 5 : configurer Nginx
sudo nano /etc/nginx/sites-available/gmod-fastdlserver {
listen 80;
listen [::]:80;
server_name fastdl.votre-domaine.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;
}
}Seuls les dossiers de contenu sont accessibles. Activez le site, testez la configuration et rechargez Nginx :
sudo ln -s /etc/nginx/sites-available/gmod-fastdl /etc/nginx/sites-enabled/gmod-fastdl
sudo nginx -t
sudo systemctl reload nginxnginx -t doit indiquer syntax is ok et test is successful.
Étape 6 : ouvrir le port 80
Utilisez l'outil de pare-feu déjà en place sur votre serveur.
Avec UFW
sudo ufw allow 80/tcp
sudo ufw reloadAvec iptables
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4Avec nftables
sudo nft add rule inet filter input tcp dport 80 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confÉtape 7 : vérifier le site
Testez un de vos fichiers, en adaptant son chemin. La première commande doit répondre 200 :
curl -I http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmt.bz2
curl -fsS http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmt.bz2 | bunzip2 | sudo -u gmod cmp - /home/gmod/gmod-server/garrysmod/addons/mon_contenu/materials/mon_serveur/logo.vmtLa commande cmp ne doit rien afficher : le fichier publié est alors identique à l'original.
Vérifiez aussi que le reste n'est pas accessible. Ces deux requêtes doivent répondre 404 :
curl -I http://fastdl.votre-domaine.com/
curl -I http://fastdl.votre-domaine.com/cfg/server.cfgÉtape 8 : marquer les fichiers à télécharger
Créez un fichier Lua côté serveur :
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/mon_serveur/logo.vmt" )
resource.AddFile( "models/mon_serveur/caisse.mdl" )
resource.AddFile( "sound/mon_serveur/annonce.mp3" )Indiquez le chemin à partir de garrysmod/, sans addons/mon_contenu/ et sans .bz2. resource.AddFile ajoute aussi les fichiers liés : le .vtf d'un .vmt, ou les .vvd, .vtx et .phy d'un .mdl. Le jeu limite cette liste à 8192 fichiers.
Étape 9 : activer FastDL sur le serveur
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/cfg/server.cfgAjoutez ces lignes, sans / à la fin de l'adresse :
sv_downloadurl "http://fastdl.votre-domaine.com"
sv_allowdownload 0sv_allowdownload 0 désactive le téléchargement direct depuis le serveur de jeu, lent et exposé à des abus. Redémarrez le serveur :
sudo systemctl restart gmod.serviceÉtape 10 : vérifier en jeu
-
Sur le serveur, suivez les requêtes :
Terminalsudo tail -f /var/log/nginx/gmod-fastdl.access.log -
Sur votre poste, supprimez le contenu de test du dossier
garrysmod/download/s'il existe -
Connectez-vous au serveur
Les requêtes de vos fichiers .bz2 doivent apparaître avec le code 200, et les contenus doivent s'afficher en jeu. Appuyez sur Ctrl+C pour quitter le suivi.
Mettre à jour un contenu
Le jeu ne compare pas le contenu des fichiers : un joueur qui possède déjà un fichier ne le télécharge pas à nouveau, même s'il a changé. Pour diffuser une nouvelle version, donnez un nouveau nom au fichier et adaptez fastdl.lua ainsi que les références au fichier.
Publiez ensuite, puis redémarrez le serveur si fastdl.lua a changé :
sudo -u gmod /home/gmod/fastdl-sync.sh
sudo systemctl restart gmod.serviceRevenir en arrière
Revenir à une publication précédente
sudo -u gmod ls -1t /var/www/gmod-fastdl/releases
sudo -u gmod ln -sfn /var/www/gmod-fastdl/releases/AAAA-MM-JJ_HH-MM-SS /var/www/gmod-fastdl/currentLe changement est immédiat, sans redémarrer Nginx.
Désactiver FastDL
sudo systemctl stop gmod.service
sudo -u gmod cp -p /home/gmod/server.cfg.avant-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 copie de server.cfg ne contient pas les changements faits après l'étape 1 : reportez-les si besoin.
En cas de problème
HTTP ERROR 1 (Zero Length File) downloading ... ou HTTP ERROR 2 (Connection closed) downloading ...
Ces messages apparaissent dans la console du joueur. Vérifiez que sv_downloadurl commence par http://, que le proxy Cloudflare est désactivé sur le sous-domaine et que le fichier indiqué répond avec curl -I.
Le journal Nginx affiche des erreurs 404
Le fichier n'est pas publié, ou son chemin diffère. Listez les requêtes en échec :
sudo awk '$9 == 404 {print $7}' /var/log/nginx/gmod-fastdl.access.log | sort | uniq -c | sort -rn | headVérifiez la casse du chemin, ajoutez si besoin son dossier à SOURCES et relancez le script. Les requêtes vers / ou d'autres adresses sans rapport proviennent souvent de robots et peuvent être ignorées.
Le journal Nginx affiche des erreurs 403 ou Permission denied
Contrôlez chaque niveau de droits :
sudo namei -l /var/www/gmod-fastdl/current/materialsLes dossiers doivent appartenir au groupe www-data. Si vous avez publié avec un autre utilisateur que gmod, corrigez les droits, puis relancez le script :
sudo chown -R gmod:www-data /var/www/gmod-fastdlmkdir: cannot create directory ... Permission denied
Le script n'a pas été lancé avec gmod, ou le dossier n'a pas été créé à l'étape 2. Utilisez sudo -u gmod /home/gmod/fastdl-sync.sh.
Aucun fichier à publier
Le dossier source est vide, ou les fichiers ne se trouvent pas dans materials, models, sound ou un autre dossier reconnu. Vérifiez l'arborescence de l'étape 3.
bind() to 0.0.0.0:80 failed (98: Address already in use)
Un autre service occupe le port 80. Identifiez-le avec sudo ss -ltnp | grep ':80 '.
Les joueurs ne téléchargent rien
- Vérifiez la valeur active avec
rcon sv_downloadurl - Vérifiez que le fichier est bien marqué dans
fastdl.luaet présent sur le serveur de jeu : sinon, il n'est pas ajouté à la liste - Le joueur a peut-être limité les téléchargements dans ses options. La commande
cl_downloadfilterde sa console doit valoirall - Le fichier se trouve peut-être déjà dans son dossier
garrysmod/download/
Les joueurs voient encore l'ancienne version
C'est le comportement normal du jeu. Renommez le fichier, comme indiqué dans la section de mise à jour.
FAQ
Faut-il publier les addons du Workshop sur FastDL ?
Non. Utilisez resource.AddWorkshop, décrit dans le guide d'installation du serveur.
Puis-je héberger FastDL sur un autre serveur ?
Oui. Installez Nginx sur cette machine et copiez-y le contenu de current avec rsync ou scp. Les fichiers doivent rester présents sur le serveur de jeu, sinon resource.AddFile ne les ajoute pas à la liste.
Les fichiers .bz2 sont-ils obligatoires ?
Non, mais ils réduisent le volume transféré. Le script garde aussi la version normale, utilisée si la version compressée est absente.