FR

Serveurs de jeux

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.

7 min de lecture, mis à jour le 18 novembre 2026

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

  1. Le serveur marque des fichiers à télécharger avec resource.AddFile. Ces fichiers doivent exister sur le serveur de jeu
  2. Le joueur reçoit l'adresse définie dans sv_downloadurl
  3. Pour chaque fichier manquant, il demande d'abord la version compressée, puis la version normale :
Texte
http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmt.bz2
http://fastdl.votre-domaine.com/materials/mon_serveur/logo.vmt

Le 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-server et du service gmod.service
  • Un accès SSH avec sudo
  • Un sous-domaine, ici fastdl.votre-domaine.com, avec un enregistrement DNS A vers 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 :

Terminal
getent hosts fastdl.votre-domaine.com

Étape 1 : sauvegarder la configuration

Terminal
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

Terminal
sudo apt update
sudo apt install -y nginx bzip2

Cré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 :

Terminal
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

Les 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 :

Texte
garrysmod/addons/mon_contenu/
├── materials/mon_serveur/logo.vmt
├── materials/mon_serveur/logo.vtf
├── models/mon_serveur/caisse.mdl
└── sound/mon_serveur/annonce.mp3

Si vous avez envoyé ces fichiers dans le dossier ~/mon_contenu de votre compte d'administration, copiez-les ainsi :

Terminal
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.

Terminal
sudo -u gmod nano /home/gmod/fastdl-sync.sh
Terminal
#!/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 :

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

Le 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

Terminal
sudo nano /etc/nginx/sites-available/gmod-fastdl
Nginx
server {
    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 :

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

nginx -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

Terminal
sudo ufw allow 80/tcp
sudo ufw reload

Avec iptables

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

Avec nftables

Terminal
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 :

Terminal
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.vmt

La 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 :

Terminal
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 :

Terminal
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/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

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

Ajoutez ces lignes, sans / à la fin de l'adresse :

Texte
sv_downloadurl "http://fastdl.votre-domaine.com"
sv_allowdownload 0

sv_allowdownload 0 désactive le téléchargement direct depuis le serveur de jeu, lent et exposé à des abus. Redémarrez le serveur :

Terminal
sudo systemctl restart gmod.service

Étape 10 : vérifier en jeu

  1. Sur le serveur, suivez les requêtes :

    Terminal
    sudo tail -f /var/log/nginx/gmod-fastdl.access.log
  2. Sur votre poste, supprimez le contenu de test du dossier garrysmod/download/ s'il existe

  3. 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é :

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

Revenir en arrière

Revenir à une publication précédente

Terminal
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/current

Le changement est immédiat, sans redémarrer Nginx.

Désactiver FastDL

Terminal
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.service

La 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 :

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

Vé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 :

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

Les dossiers doivent appartenir au groupe www-data. Si vous avez publié avec un autre utilisateur que gmod, corrigez les droits, puis relancez le script :

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

mkdir: 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.lua et 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_downloadfilter de sa console doit valoir all
  • 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.