Comment installer fiveshield sur votre serveur FiveM en 5 minutes

Avant de commencer

Vous aurez besoin de :

• Un compte Discord (utilisé pour vous connecter à fiveshield)
• Un serveur FiveM déjà en fonctionnement (n'importe quel hébergeur)
• 10$ CAD pour le dépôt initial
• Un accès au système de fichiers de votre serveur (pour y déposer la ressource et modifier server.cfg)

C'est tout. Pas de changement DNS, pas de configuration Cloudflare, pas de réseau complexe. Le processus complet prend moins de 5 minutes.

Étape 1 — Connectez-vous avec Discord

Rendez-vous sur l'anti-DDoS fiveshield pour FiveM et cliquez sur Se connecter avec Discord. Nous utilisons Discord OAuth — nous ne voyons jamais votre mot de passe. Votre compte Discord devient votre identité fiveshield.

Une fois connecté, vous arrivez sur le tableau de bord où vous pouvez gérer vos serveurs, surveiller le nombre de joueurs et contrôler votre solde.

Étape 2 — Créez votre serveur et approvisionnez votre solde

Cliquez sur Créer un serveur depuis le tableau de bord. Vous devrez :

• Nommer votre serveur — cela devient votre sous-domaine fiveshield (ex. monserveur.fiveshield.co)
• Choisir une localisation proxy — choisissez la région la plus proche de votre base de joueurs (BHS5, DE1, GRA11, RBX-A, SBG5, UK1, WAW1, SGP1 ou SYD1)
• Déposer 10$ CAD — ce n'est pas des frais, l'argent va directement dans votre solde et sert à payer votre utilisation quotidienne

Le dépôt de 10$ assure que votre compte a des fonds pour couvrir les premiers jours de protection. Après ça, la facturation est quotidienne basée sur votre pic de joueurs — pas de contrat, pas d'abonnement.

Étape 3 — Téléchargez et placez la ressource

Depuis le tableau de bord de votre serveur, ouvrez le guide d'installation et cliquez sur Télécharger fiveshield. Vous obtiendrez un zip contenant un seul dossier fiveshield avec tout à l'intérieur :

• Les fichiers de la ressource Lua (server.lua, fxmanifest.lua, version.txt)
• Un fichier fiveshield.cfg (votre configuration personnelle, avec votre sous-domaine, votre clé API et vos plages d'IP proxy déjà remplis)

Extrayez le zip et placez le dossier ainsi :

votre-serveur/
├── server.cfg
└── resources/
    └── fiveshield/       ← placez le dossier de la ressource ICI
        ├── fxmanifest.lua
        ├── server.lua
        ├── fiveshield.cfg   ← votre config personnalisée (reste à l'intérieur)
        └── version.txt

Note : fiveshield.cfg reste désormais à l'intérieur du dossier de la ressource. Vous n'avez plus besoin de le déplacer à côté de server.cfg.

Vous n'avez pas besoin de modifier fiveshield.cfg. Le fichier téléchargé contient déjà votre sous-domaine, votre clé API et les bons paramètres CDN et plages d'IP. Les plages d'IP proxy restent aussi à jour automatiquement à l'exécution — la ressource rafraîchit sv_proxyIPRanges depuis notre API à chaque démarrage du serveur.

Étape 4 — Ajoutez exec resources/fiveshield/fiveshield.cfg à server.cfg

Ouvrez votre server.cfg et ajoutez cette ligne en toute première position, avant toute autre commande exec ou ensure :

exec resources/fiveshield/fiveshield.cfg

Cette seule ligne suffit. Elle charge fiveshield.cfg depuis le dossier de la ressource, qui à son tour :

• Configure votre endpoint CDN et vos plages d'IP proxy
• Force le listing indirect via votre sous-domaine fiveshield
• Démarre la ressource fiveshield avec ensure fiveshield

Vous n'avez pas à ajouter ensure fiveshield vous-même dans server.cfg — fiveshield.cfg le fait déjà pour vous. Le déclarer deux fois provoquera des erreurs.

Pourquoi en première ligne ? fiveshield doit configurer le listing et les paramètres du file-server avant que FiveM ne lise le reste de votre config. Si la ligne exec arrive après d'autres commandes, la protection peut ne pas se charger correctement.

Étape 5 — Redémarrez votre serveur

Redémarrez (ou démarrez) votre serveur FiveM. Au démarrage, vous devriez voir la bannière fiveshield dans la console confirmant :

DDoS Protection is now active

En coulisses, la ressource :

1. S'enregistre auprès de notre API avec votre clé API
2. Vérifie les mises à jour et se met à jour automatiquement si une nouvelle version est disponible
3. Valide votre configuration — en s'assurant que tous les paramètres requis sont présents
4. Commence à router le trafic des joueurs — chaque joueur qui se connecte est assigné à une instance proxy dans votre localisation choisie

Le cache CDN est géré automatiquement par fiveshield.cfg — les téléchargements de ressources sont servis via nos 330+ emplacements CDN edge mondiaux, sans configuration supplémentaire.

Optionnel mais fortement recommandé — Pare-feu OVH Edge

Si votre serveur d'origine est hébergé chez OVH (bare metal, VPS ou Game), terminez l'installation en verrouillant l'Edge Network Firewall pour que seul fiveshield et votre propre IP puissent atteindre la machine. C'est ce qui empêche les attaquants de contourner le proxy et de frapper directement l'IP d'origine.

Dans l'OVH Manager, allez dans Bare Metal Cloud → Network → IP, trouvez l'IP de votre serveur, ouvrez le menu ⋮ → Configurer le Edge Network Firewall, puis ajoutez :

Puis basculez l'interrupteur Actif en haut à droite.

Crucial : La règle Autoriser en priorité 1 doit contenir une IP. Laisser le champ IP source vide autorise tout le trafic IPv4 et annule complètement l'intérêt du pare-feu.

Vous pouvez ajouter autant de règles Autoriser supplémentaires (priorités 2, 3, …) que vous voulez d'IP en liste blanche — votre IP domicile, celle de votre admin, etc. Le trafic du proxy fiveshield est géré à une autre couche et n'a pas besoin d'être mis en liste blanche ici.

Et après ?

Une fois votre serveur lancé avec fiveshield :

• Surveillance du tableau de bord — voyez en temps réel les joueurs connectés, les stats de bande passante et les taux de cache
• Facturation quotidienne — facturé selon votre pic de joueurs simultanés chaque jour (minimum 2,25$ CAD/jour)
• Protection automatique — les attaques DDoS sont absorbées silencieusement, aucune action requise de votre part
• Gestion du cache — purgez le cache CDN en un clic quand vous mettez à jour des ressources

Questions fréquentes

Puis-je changer ma localisation proxy plus tard ? Oui — vous pouvez changer de localisation à tout moment depuis le tableau de bord.

Que se passe-t-il si mon solde est épuisé ? Votre serveur sera désactivé — toutes les sessions de joueurs actives sont fermées et le transfert proxy est arrêté. Rechargez votre solde depuis le tableau de bord pour réactiver la protection.

Est-ce que ça fonctionne avec txAdmin ? Oui. fiveshield inclut la protection du panneau txAdmin sans frais supplémentaires.

Dois-je changer l'IP de mon serveur ? Non. Les joueurs se connectent via le proxy fiveshield — votre IP d'origine reste cachée et inchangée (surtout si vous configurez aussi le pare-feu OVH ci-dessus).

Où retrouver ma clé API si je dois réinstaller ? Ouvrez votre serveur dans le tableau de bord, cliquez sur Guide d'installation et téléchargez un nouveau zip. Le nouveau fiveshield.cfg contiendra votre clé API actuelle, prête à l'emploi.

Pour aller plus loin

• Comment fiveshield protège votre serveur FiveM contre les attaques DDoS — l'architecture multi-couches en coulisses
• Comprendre XDP : la technologie derrière notre filtrage L4 — pourquoi la latence même-localisation est < 0,5 ms
• Pourquoi chaque serveur FiveM a besoin d'un cache CDN — 98 % de réduction de bande passante, expliqué
• Tarification par joueur expliquée — comment fonctionnent la facturation quotidienne et les remises de volume