Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Garry's Mod

Qu'est-ce que FastDL (téléchargement rapide) sur GMod et comment l'installer ?

26 août 2026 17 min de lecture Mis à jour :
Partager cet article

FastDL (Fast Download, téléchargement rapide) est la méthode qui permet aux joueurs de télécharger en HTTP, depuis un serveur web distinct, les fichiers de modèles, de textures (matériaux), de sons et de maps propres à votre serveur Garry's Mod (GMod). Lorsqu'un joueur se connecte au serveur, il récupère les fichiers manquants non pas depuis le serveur de jeu, mais depuis l'adresse que vous indiquez avec sv_downloadurl. Ce guide s'adresse aux administrateurs de serveur qui doivent distribuer une partie de leur contenu en dehors du Workshop (Atelier) ; les autres sujets se trouvent sur la page Guides Garry's Mod.

Avant de commencer

  • Un serveur GMod fonctionnel : l'installation de SteamCMD, la commande de lancement et server.cfg doivent être prêts. Sinon, suivez d'abord le guide Installer un serveur Garry's Mod de zéro. Les chemins ci-dessous reprennent les dossiers de ce guide : C:\GModServer sous Windows, /home/steam/gmod sous Linux.
  • Un serveur web : il peut tourner sur le même VDS que le serveur de jeu. Ce guide utilise nginx sous Linux (Ubuntu) et IIS (Internet Information Services) sous Windows Server. Pour une autre option comme Apache, consultez le guide Installer et gérer les serveurs web Nginx et Apache sur un VDS.
  • Accès administrateur : SSH avec un compte disposant des droits sudo sous Linux, RDP (Bureau à distance) avec le compte Administrator sous Windows. Si la connexion échoue, la console VNC de l'Espace client affiche l'écran du serveur dans votre navigateur.
  • Droit de distribution : vous devez détenir le droit de distribuer les modèles, textures et sons que vous envoyez aux joueurs.

Avant de commencer l'installation, déterminez quelle méthode vous convient. La page Serving Content de Facepunch décrit trois façons d'envoyer du contenu :

MéthodeOrigine des fichiersPoint fortPoint faible
Workshop (resource.AddWorkshop)Steam WorkshopLa voie la plus rapide selon Facepunch ; l'addon se télécharge en un seul paquet (.gma)Le contenu doit être publié sur le Workshop
FastDL (sv_downloadurl)Votre serveur web, fichier par fichierDistribue aussi les fichiers non publiés sur le WorkshopLe contenu des fichiers n'est pas vérifié ; un fichier mis à jour sous le même nom n'est pas retéléchargé
Téléchargement depuis le serveur (sv_allowdownload 1)Le serveur de jeu lui-mêmeAucun serveur web nécessaireEnviron 64 kb/s ; Facepunch le considère comme obsolète et exploitable

Si votre contenu est sur le Workshop, FastDL n'est pas nécessaire ; utilisez la méthode décrite dans le guide Addons Workshop pour GMod, à savoir resource.AddWorkshop. FastDL sert aux fichiers que vous ne pouvez pas ou ne voulez pas publier sur le Workshop (logo du serveur, sons personnalisés, modèles d'un addon de type dossier, etc.).

1. Rassembler le contenu et déterminer le chemin virtuel

L'erreur la plus fréquente avec FastDL concerne la structure des dossiers. Le joueur demande un fichier par son chemin virtuel (virtual path), relatif au dossier garrysmod ; la structure des dossiers sur le serveur web doit correspondre exactement à ce chemin. D'après la page resource.AddFile de Facepunch, les dossiers addons/<addon>/ et gamemodes/<gamemode>/content/ sont montés à la racine (mount) ; ces préfixes ne font pas partie du chemin virtuel :

Fichier sur le serveur de jeuChemin virtuelFichier sur le serveur web
garrysmod/maps/gm_examplemap.bspmaps/gm_examplemap.bspfastdl/maps/gm_examplemap.bsp.bz2
garrysmod/addons/server_content/materials/myserver/logo.vmtmaterials/myserver/logo.vmtfastdl/materials/myserver/logo.vmt.bz2
garrysmod/gamemodes/examplemode/content/sound/myserver/intro.wavsound/myserver/intro.wavfastdl/sound/myserver/intro.wav.bz2

Regroupez le contenu propre au serveur dans un seul addon de type dossier, par exemple dans garrysmod/addons/server_content/, avec les dossiers materials, models et sound. Respectez trois règles :

  • Le dossier des sons s'appelle sound, et non sounds.
  • Écrivez les noms de fichiers et de dossiers en minuscules. Sous Linux, les chemins de fichiers sont sensibles à la casse ; d'après la documentation FastDL de Valve, un fichier dont la casse du nom ne correspond pas n'est pas téléchargé en HTTP.
  • Ne placez pas les fichiers Lua sur le serveur web. D'après Facepunch, les fichiers Lua ne sont pas considérés comme du contenu et sont envoyés aux joueurs par une autre voie, sans réglage supplémentaire. Exposer sur le web les dossiers cfg, data ou lua rend accessibles à tous des informations secrètes comme, dans server.cfg, la valeur rcon_password ou le mot de passe de la base de données dans le code Lua côté serveur.

2. Installer le serveur web et créer le dossier FastDL

Linux (Ubuntu, nginx) :

sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/html/fastdl
sudo ufw allow 80/tcp

Sous Ubuntu, le site par défaut de nginx sert le dossier /var/www/html ; votre adresse FastDL est donc http://SERVER_IP/fastdl/. Ne placez pas le dossier sous /home/steam : nginx s'exécute avec un utilisateur distinct et peut ne pas pouvoir lire le dossier personnel des autres utilisateurs, ce qui provoque une erreur 403 Forbidden. Ne faites pas non plus pointer le dossier racine du site (root) vers le dossier du serveur de jeu ; sinon, les fichiers cfg et lua seraient eux aussi publiés. Si vous n'utilisez pas ufw, ouvrez le port 80/TCP dans votre propre pare-feu.

Windows Server (IIS) : exécutez ces commandes dans PowerShell ouvert en tant qu'administrateur :

Install-WindowsFeature -Name Web-Server -IncludeManagementTools
New-Item -ItemType Directory -Path C:\inetpub\wwwroot\fastdl
New-NetFirewallRule -DisplayName "FastDL HTTP 80" -Direction Inbound -Protocol TCP -LocalPort 80 -Action Allow

Le site par défaut d'IIS (« Default Web Site ») sert le dossier C:\inetpub\wwwroot. Si une règle d'autorisation existe déjà pour le port 80 dans le pare-feu, la dernière ligne est inutile. Le pare-feu fait partie du système d'exploitation et relève de votre gestion ; pour les ports de jeu, consultez le guide Ouverture des ports et pare-feu pour GMod.

3. Copier les fichiers dans le dossier web

Ne copiez que les dossiers de contenu dans le dossier web ; le nom du dossier de l'addon ne fait pas partie du chemin côté web.

Linux :

K=/home/steam/gmod/garrysmod/addons/server_content
sudo cp -r "$K/materials" "$K/models" "$K/sound" /var/www/html/fastdl/
sudo mkdir -p /var/www/html/fastdl/maps
sudo cp /home/steam/gmod/garrysmod/maps/gm_examplemap.bsp /var/www/html/fastdl/maps/

Retirez de la commande les dossiers qui n'existent pas dans votre addon ; un dossier inexistant provoque une erreur.

Windows (« Command Prompt » ou PowerShell) :

robocopy C:\GModServer\garrysmod\addons\server_content\materials C:\inetpub\wwwroot\fastdl\materials /S
robocopy C:\GModServer\garrysmod\addons\server_content\models C:\inetpub\wwwroot\fastdl\models /S
robocopy C:\GModServer\garrysmod\addons\server_content\sound C:\inetpub\wwwroot\fastdl\sound /S
robocopy C:\GModServer\garrysmod\maps C:\inetpub\wwwroot\fastdl\maps gm_examplemap.bsp

/S copie aussi les sous-dossiers non vides. La dernière ligne ne copie que le fichier de map indiqué.

4. Compresser les fichiers avec bzip2

D'après Facepunch, le joueur demande d'abord la version de chaque fichier compressée en .bz2, et s'il ne la trouve pas, il essaie le fichier non compressé. Valve recommande aussi la compression bzip2 pour accélérer les téléchargements et gagner de la place sur le serveur web. Le nom du fichier compressé s'obtient en ajoutant .bz2 à la fin du nom d'origine : le fichier logo.vmt devient logo.vmt.bz2. Effectuez la compression sur les copies du dossier web ; ne touchez pas aux fichiers d'origine du serveur de jeu.

Linux :

sudo find /var/www/html/fastdl -type f ! -name '*.bz2' -exec bzip2 -f {} +
sudo chmod -R a+rX /var/www/html/fastdl

La première commande compresse chaque fichier dont le nom ne se termine pas par .bz2 et remplace l'original par sa version compressée ; -f écrase un éventuel ancien fichier .bz2, et si vous ajoutez -k, le fichier d'origine est conservé. La seconde commande donne aux fichiers le droit de lecture et aux dossiers le droit de traversée, pour que le serveur web puisse les lire.

Windows : Windows ne fournit pas d'outil bzip2 ; installez 7-Zip, gratuit et open source. Pour un seul fichier, faites un clic droit dessus dans le « File Explorer » (Explorateur de fichiers) et, dans la fenêtre d'ajout à l'archive du menu 7-Zip, choisissez bzip2 comme format d'archive. Pour tout le dossier, dans PowerShell :

$7z = "C:\Program Files\7-Zip\7z.exe"
Get-ChildItem C:\inetpub\wwwroot\fastdl -Recurse -File |
  Where-Object { $_.Extension -ne ".bz2" -and $_.Name -ne "web.config" } |
  ForEach-Object { & $7z a -tbzip2 "$($_.FullName).bz2" $_.FullName -sdel }

-tbzip2 définit le type d'archive sur bzip2 ; ce format n'accepte qu'un fichier par archive. -sdel supprime le fichier d'origine une fois la compression terminée avec succès. Si vous avez installé 7-Zip dans un autre dossier, corrigez le chemin de la première ligne. Si vous mettez à jour un fichier et le recompressez, supprimez d'abord l'ancien fichier .bz2.

5. Vérifier que le serveur web sert les fichiers

Le serveur web associe à chaque fichier un type MIME (MIME type, déclaration du type de fichier). Il n'est pas documenté si le jeu tient compte de ce type, mais certains serveurs web ne servent pas du tout les extensions qu'ils ne connaissent pas.

IIS : d'après la documentation de Microsoft, IIS ne sert pas les types de fichiers pour lesquels aucun mappage MIME n'est défini ; le joueur reçoit une erreur 404 et le journal d'IIS indique 404.3. Créez le fichier C:\inetpub\wwwroot\fastdl\web.config et écrivez-y ce qui suit :

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <staticContent>
      <remove fileExtension=".bz2" />
      <mimeMap fileExtension=".bz2" mimeType="application/octet-stream" />
    </staticContent>
  </system.webServer>
</configuration>

La ligne remove évite le conflit (500.19) qui se produirait si un mappage existait déjà pour la même extension à un niveau supérieur. Si vous laissez aussi des fichiers non compressés (.bsp, .vmt, .vtf, .mdl, .vvd, .vtx, .phy, etc.), ajoutez les deux mêmes lignes pour chaque extension. Dans le « Notepad » (Bloc-notes), choisissez comme type d'enregistrement All Files (Tous les fichiers) ; sinon, le fichier sera enregistré sous le nom web.config.txt.

nginx : dans la configuration par défaut de nginx, la ligne default_type application/octet-stream; sert avec ce type les extensions qu'il ne reconnaît pas (.bz2, .vmt, .mdl, etc.) ; aucun réglage supplémentaire n'est nécessaire. Vous pouvez vérifier que la ligne est bien présente avec grep default_type /etc/nginx/nginx.conf. La liste des répertoires est désactivée par défaut dans nginx (autoindex) et dans IIS (« Directory Browsing ») ; ne l'activez pas, sinon la liste de tous les fichiers du dossier sera visible par tous.

Ouvrez ensuite dans le navigateur de votre propre ordinateur une adresse comme http://SERVER_IP/fastdl/materials/myserver/logo.vmt.bz2 ; le fichier doit se télécharger. Sous Linux, vous pouvez aussi tester depuis le serveur lui-même :

curl -I http://127.0.0.1/fastdl/materials/myserver/logo.vmt.bz2

La première ligne de la réponse doit afficher 200 OK. 404 indique une erreur de chemin ou de casse, 403 un problème de droits.

6. Déclarer les fichiers avec resource.AddFile

Le serveur de jeu doit indiquer aux joueurs quels fichiers télécharger. Vous le faites avec un fichier Lua exécuté côté serveur : C:\GModServer\garrysmod\lua\autorun\server\fastdl.lua sous Windows, /home/steam/gmod/garrysmod/lua/autorun/server/fastdl.lua sous Linux. Créez le dossier s'il n'existe pas ; sous Linux, créez le fichier avec l'utilisateur steam.

-- Fichiers envoyés aux joueurs via FastDL (chemins relatifs au dossier garrysmod/)
resource.AddFile("materials/myserver/logo.vmt")            -- le logo.vtf du même nom est aussi ajouté
resource.AddFile("models/myserver/sign.mdl")               -- les fichiers .vvd, .phy et .vtx sont aussi ajoutés
resource.AddFile("materials/models/myserver/sign.vmt")     -- la texture du modèle est ajoutée séparément
resource.AddSingleFile("sound/myserver/intro.wav")

D'après Facepunch, la différence entre les deux fonctions est la suivante :

  • resource.AddFile ajoute le fichier avec ses fichiers associés : pour un .vmt, le .vtf du même nom ; pour un .mdl, les fichiers .vvd, .ani, .dx80.vtx, .dx90.vtx et .phy du même nom. Elle écrit une erreur distincte pour chaque fichier associé introuvable. Cette liste ne comprend pas les textures du modèle ; ajoutez-les séparément.
  • resource.AddSingleFile n'ajoute que le fichier indiqué. Si certains fichiers associés manquent à votre modèle, ajoutez un par un ceux qui existent avec cette fonction.

Les chemins ne comportent ni l'extension .bz2 ni le préfixe addons/<addon>/. Si le fichier n'existe pas sur le serveur de jeu, il n'est pas envoyé aux joueurs. Toutes les fonctions resource.Add* partagent une limite de 8192 fichiers téléchargeables. Au lieu d'écrire un par un tous les sons d'un dossier, vous pouvez faire une boucle avec file.Find :

local folder = "sound/myserver/"
local files = file.Find(folder .. "*", "GAME")
for _, name in ipairs(files or {}) do
    resource.AddSingleFile(folder .. name)
end

Le chemin de recherche "GAME" parcourt tout le contenu monté, addons compris, selon la structure de garrysmod/. Facepunch indique que les chemins contenant des majuscules peuvent ne pas fonctionner comme prévu sous Linux ; écrivez les noms de dossiers en minuscules. N'ajoutez pas les fichiers Lua à cette liste. Sous Windows, le « Notepad » peut enregistrer le fichier sous le nom fastdl.lua.txt ; là encore, choisissez comme type d'enregistrement All Files.

7. Configurer sv_downloadurl et sv_allowdownload

Ajoutez ces lignes au fichier garrysmod/cfg/server.cfg. Valve recommande également le fichier server.cfg pour ces variables :

// Adresse FastDL : entre guillemets, terminée par /
sv_downloadurl "http://203.0.113.10/fastdl/"
// Désactiver le téléchargement direct (lent) depuis le serveur de jeu
sv_allowdownload 0

203.0.113.10 est une adresse d'exemple ; remplacez-la par l'adresse IP de votre serveur ou par votre nom de domaine. La documentation FastDL de Valve demande d'écrire l'adresse entre guillemets et avec le / final ; l'adresse peut compter au maximum 127 caractères. L'exemple de Facepunch n'a pas de / final, mais suivez le format de Valve. Écrivez l'adresse sous la forme finale que vous avez testée dans le navigateur ; il n'est pas documenté si le client du jeu suit les redirections (redirect).

Les sources divergent au sujet de sv_allowdownload. La page générale sv_downloadurl que Valve a rédigée pour tous les jeux Source indique de régler cette valeur sur 1 ; dans GMod, la valeur par défaut est également 1. La documentation de Facepunch propre à Garry's Mod, en revanche, ne demande pour FastDL que sv_downloadurl et resource.Add* ; elle rattache le réglage sv_allowdownload 1 à l'ancienne méthode ServerDL, jugée obsolète, et le considère comme exploitable, car des clients modifiés peuvent ralentir le serveur en demandant des fichiers en rafale. Facepunch ne dit pas explicitement « réglez-le sur 0 » ; la recommandation de 0 est déduite de ces deux informations. D'après Valve, pour un fichier absent de FastDL ou dont la casse du nom ne correspond pas, le joueur bascule vers le téléchargement lent depuis le serveur de jeu ; avec 0, cette voie est fermée et les fichiers manquants apparaissent immédiatement lors du test. Si le test de l'étape 8 réussit avec ce réglage, FastDL fonctionne à lui seul. Redémarrez le serveur et vérifiez la valeur en tapant sv_downloadurl dans la console.

8. Tester depuis le jeu

Les fichiers que vous testez ne doivent pas se trouver sur votre propre ordinateur. Les fichiers téléchargés sont écrits sur l'ordinateur du joueur dans le dossier garrysmod/download/ ; si vous les avez déjà téléchargés, supprimez-les de cet endroit. Ouvrez la console du jeu et connectez-vous avec les commandes de débogage recommandées par Valve :

developer 1
download_debug 1
connect 203.0.113.10:27015

Dans la console, les lignes en rouge commençant par Error Downloading indiquent les fichiers qui n'ont pas pu être téléchargés ; corrigez le chemin et la casse d'après ces lignes. Après le test, rétablissez les réglages avec developer 0 et download_debug 0. Dans leurs paramètres de téléchargement (cl_downloadfilter : all, none, nosounds, mapsonly, noworkshop), les joueurs peuvent choisir les fichiers qu'ils reçoivent ; un joueur qui choisit none, nosounds ou mapsonly ne télécharge pas tout ou partie des fichiers FastDL.

Exemple de configuration

Réglage / fichierEmplacementRôleExemple
sv_downloadurlcfg/server.cfgAdresse FastDL ; entre guillemets, terminée par /, 127 caractères au maximumsv_downloadurl "http://203.0.113.10/fastdl/"
sv_allowdownloadcfg/server.cfgTéléchargement direct depuis le serveur de jeu ; à garder désactivé dans GModsv_allowdownload 0
resource.AddFilelua/autorun/server/fastdl.luaAjoute le fichier et ses fichiers associés à la liste de téléchargementresource.AddFile("materials/myserver/logo.vmt")
resource.AddSingleFilelua/autorun/server/fastdl.luaN'ajoute que le fichier indiquéresource.AddSingleFile("sound/myserver/intro.wav")
Dossier FastDLnginx / IISFichiers compressés, selon la structure du chemin virtuel/var/www/html/fastdl, C:\inetpub\wwwroot\fastdl
web.configDossier FastDL d'IISMappage MIME pour .bz2<mimeMap fileExtension=".bz2" mimeType="application/octet-stream" />
download_debugConsole du joueurAffiche les erreurs de téléchargementdownload_debug 1

Erreurs fréquentes

  • Le téléchargement est toujours lent ou FastDL n'est pas utilisé du tout : sv_downloadurl n'a pas été défini, a été écrit dans un autre fichier, ou le serveur n'a pas été redémarré. Tapez sv_downloadurl dans la console du serveur et vérifiez la valeur.
  • Dans la console, Error Downloading, erreur 404 dans le navigateur : le chemin côté web ne correspond pas au chemin virtuel. En général, le préfixe addons/<addon>/ a été copié, le dossier a été nommé sounds ou la casse diffère. Corrigez le chemin d'après le tableau de l'étape 1.
  • Erreur 404 (404.3 dans le journal) ou 500.19 sur IIS : 404.3 indique que l'extension n'a pas de mappage MIME ; placez le fichier web.config de l'étape 5 dans le dossier FastDL. 500.19 indique que web.config contient une faute de frappe ou une extension définie deux fois ; vérifiez les balises et les lignes remove.
  • 403 Forbidden sous nginx : le serveur web ne parvient pas à lire le fichier. Exécutez la commande sudo chmod -R a+rX /var/www/html/fastdl ; si vous avez placé le dossier sous /home, déplacez-le sous /var/www/html.
  • Les fichiers se téléchargent, mais les joueurs voient un modèle ERROR ou une texture violette et noire : les textures du modèle (.vmt et .vtf) n'ont pas été ajoutées à la liste, ou le réglage cl_downloadfilter du joueur bloque le téléchargement. Ajoutez les textures avec resource.AddFile et demandez au joueur de vérifier son réglage.
  • Le fichier mis à jour ne parvient pas aux joueurs : FastDL ne vérifie pas le contenu des fichiers ; d'après Valve, le fichier du même nom déjà présent chez le joueur n'est pas écrasé. Donnez un nouveau nom au fichier (par ex. logo_v2.vmt), mettez à jour les endroits qui y font référence et ajoutez le nouveau fichier à la liste et au dossier web.
  • Erreurs resource.AddFile dans la console du serveur : le fichier n'existe pas à ce chemin virtuel sur le serveur de jeu, ou un fichier associé (par ex. .dx80.vtx) est manquant. Corrigez le chemin ou ajoutez un par un les fichiers existants avec resource.AddSingleFile.
  • L'adresse web n'est pas accessible depuis l'extérieur : le port 80/TCP est fermé dans le pare-feu ou le serveur web ne fonctionne pas. Ajoutez la règle ; sous Linux, redémarrez le service avec sudo systemctl restart nginx. Si le réglage du pare-feu coupe aussi votre connexion SSH ou RDP, connectez-vous via la console VNC de l'Espace client pour le corriger.

Questions fréquentes

Dois-je utiliser FastDL ou le Workshop ?

Si le contenu est sur le Workshop ou si vous pouvez l'y publier, choisissez le Workshop ; Facepunch le présente comme la méthode la plus rapide, et la page resource.AddFile recommande, pour un grand nombre de fichiers, resource.AddWorkshop. Les deux fonctionnent aussi ensemble : les gros paquets se téléchargent depuis le Workshop, et les quelques fichiers spécifiques que vous ne pouvez pas y publier, depuis FastDL.

Le serveur web doit-il être sur le même VDS que le serveur de jeu ?

Ce n'est pas nécessaire ; sv_downloadurl peut pointer vers n'importe quelle adresse HTTP. Sur le même VDS, le trafic de téléchargement partage la même ligne réseau et le même processeur que le trafic de jeu ; surveillez l'utilisation du réseau et du CPU dans les graphiques d'utilisation en direct de l'Espace client. Si les ressources ne suffisent pas, vous pouvez consulter les offres de la page Location de serveur Garry's Mod.

Puis-je utiliser une adresse HTTPS ?

Oui ; l'exemple de Facepunch utilise une adresse commençant par https://. Il vous faut pour cela un nom de domaine pointant vers votre serveur et un certificat valide ; consultez le guide Installer un certificat SSL. D'après Valve, dans certains environnements d'hébergement web, seul l'un des deux fonctionne correctement ; si l'un pose problème, essayez l'autre.

Comment distribuer des maps avec FastDL ?

Placez le fichier .bsp de la map dans le dossier maps/ du dossier web et compressez-le, comme aux étapes 3 et 4 ; d'après l'exemple de Valve, un joueur qui ne possède pas la map la télécharge depuis cet emplacement lors de sa connexion. Ajoutez avec resource.AddFile les textures et modèles qui ne sont pas intégrés à la map. Pour installer la map sur le serveur et pour les maps du Workshop, consultez le guide Installer une map personnalisée sur GMod.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.