AC EVO Server Panel

🌍 Public — aucun compte requis

• Page d'accueil : serveurs en direct (joueurs connectés, circuit en cours), calendrier des prochains événements, derniers résultats
• Timing en direct par serveur, tours invalides signalés en temps réel (track limits, split manqué)
• Réactions emoji vers le chat in-game depuis la page timing
• Résultats de session détaillés : drapeaux, meilleurs tours, secteurs color-codés, gap au leader
• Classement par circuit avec filtres (véhicule, catégorie, plage de performance/PI) et meilleur temps mis en avant
• Session en cours sur le timing : nom de la session, phase (attente de départ, en cours, dernier tour, terminée) et temps restant estimé
• Incidents et sanctions dans chaque résultat : contacts, murs, objets, chocs avec dégâts, sanctions de course (avec leur cause, le tour et le moment)
• Fair-play : classement des pilotes à la conduite la plus propre (incidents par tour), avec un compteur que l'administrateur peut remettre à zéro
• ELO : niveau des pilotes d'après leurs courses, dans l'esprit de Low Fuel Motorsport (informatif ; refus de participation sous un seuil possible, désactivé par défaut)
• Championnats : points cumulés sur plusieurs courses (barème libre, bonus pole / meilleur tour, pires manches retirées, participation minimale), publics ou privés
• Carte des accrochages : le plan du circuit et une voiture en 3D, reliés — chaque impact (mur, voiture, objet) s'affiche à l'endroit de la piste et de la voiture où il a eu lieu, avec sa vitesse, ses dégâts et les pilotes concernés ; filtres, vue densité (37 circuits calés)
• Contacts en direct sur le timing (option) : qui vient de toucher qui, un mur ou un objet
• Exports CSV : classement d'une session, fair-play, championnats
• Inscription pilote (validation manuelle ensuite par un admin), confirmation d'email optionnelle
• Interface multilingue : FR / EN / ES / DE / IT

🏎️ Pilote — compte connecté

• Tableau de bord : inscriptions à venir/passées, événements privés disponibles, désinscription tant que l'inscription est en attente
• Historique personnel des tours : chaque tour roulé est enregistré en direct (temps, voiture, circuit), sans attendre la fin d'une session — au-delà d'une rétention configurable, l'historique est condensé en résumés mensuels plutôt que supprimé
• Liaison de compte Steam (identité vérifiée, requise pour l'historique des tours)
• Consultation de la bibliothèque de mods véhicules (upload réservé aux admins)

🛠️ Admin

• Démarrage / arrêt / restart du serveur, watchdog auto-restart, logs et métriques CPU/RAM en direct
• Éditeur de config JSON complet : circuit, météo, sessions (Practice / Qualifying / Warmup / Race), voitures
• Banque de véhicules (97 voitures, catégories Road/Race/Track, filtres, images) et banque de circuits (36 circuits, layout, longueur, images), upload des images véhicules/circuits
• Gestion des mods véhicules : upload multiple par glisser-déposer (.kspkg), tags manuels (catégorie, PI), image de couverture auto-détectée ou personnalisée, détection et signalement des conflits d'identifiant entre mods
• Roulement de configs avec file d'attente propre à chaque serveur, glisser-déposer, option cycle
• Gestion complète des événements (création, publication, inscriptions, génération de l'entry_list.json) et des comptes pilotes (approbation/rejet)
• Emails transactionnels (approbation, rejet, rappel)
• Modération in-game depuis le panel : chat admin, kick, envoi aux stands, mute, pénalités, lest/restricteur, saut de session, bannissement en direct (\ban, enregistré dans la page Accès et signalé sur Discord)
• Modes de jeu supplémentaires : course instantanée, tour lancé, rallye, A vers B, test drive
• Options de course : course au nombre de tours, arrêt aux stands obligatoire (pneus / ravitaillement), sanctions personnalisées — toutes désactivées par défaut
• Page Accès : liste blanche des pilotes approuvés, bannissement par SteamID, lest et restricteur par joueur, refus selon le niveau ELO (option)
• Avertissement de capacité : si le nombre de joueurs dépasse celui des stands du circuit choisi
• Santé du serveur : en marche ou non, joueurs, CPU, mémoire, redémarrages, disponibilité sur 24 h et courbes, espace disque, dernière sauvegarde
• Championnats : création, choix des manches parmi les courses jouées, barème et bonus
• Exports CSV : tous les résultats, pilotes
• Élévation du bot du panel en admin in-game à la demande, redémarrage du container du serveur de jeu

👑 Superadmin

• Toutes les variables .env éditables depuis l'interface, sans accès SSH
• Gestion des comptes admin/superadmin (création, désactivation, suppression)
• Multi-serveurs : création, activation/désactivation, suppression de serveurs — chacun dans son propre container Docker, avec son propre bot et son propre watchdog
• Mise à jour du serveur de jeu ACE EVO depuis l'interface (SteamCMD, identifiants + code Steam Guard, suivi de progression en direct) — distincte de la mise à jour du panel lui-même
• Journal d'audit : qui a fait quoi, quand et depuis quelle adresse (connexions, serveur, réglages, comptes, sauvegardes) — jamais de secret ; filtres, export CSV, conservation configurable
• Sauvegarde et restauration en un clic : base, réglages, configurations, images ; sauvegarde automatique quotidienne ; restauration vérifiée (contenu, intégrité de la base, version) avec sauvegarde de sécurité préalable
• Double authentification : réinitialisation du 2FA d'un compte (appareil perdu)
• Upload des images véhicules/circuits

🔒 Sécurité

• CSRF, rate limiting, protection anti brute-force sur le login (blocage IP après 5 échecs), HSTS, CSP, X-Frame-Options
• Double authentification (TOTP) pour les comptes administrateurs : Google Authenticator, Aegis, 2FAS, Bitwarden… avec QR code, 10 codes de secours à usage unique, codes non rejouables
• Journal d'audit de toutes les actions d'administration
• Ingestion des résultats authentifiée : le serveur de jeu s'identifie par un jeton propre à l'installation, avec ou sans reverse proxy ; toute requête passée par un proxy sans jeton est refusée
• IP réelle des visiteurs derrière un reverse proxy (TRUSTED_PROXIES) : limite de débit et anti-brute-force par visiteur, pas par proxy
• Dépendances à jour (contrôle pip-audit), restauration de sauvegarde protégée contre les archives piégées

🔔 Notifications Discord

• Webhooks configurables par serveur : démarrage/arrêt/crash, connexions joueurs, meilleur tour, actions admin — avec fallback sur le webhook global
• Messages lisibles : serveur en en-tête, heure affichée dans le fuseau de chaque lecteur, noms de voitures et de circuits en clair, pseudo cliquable vers Steam, record du serveur rappelé avec le meilleur tour, message de plantage qui passe au vert quand le serveur repart
• Récapitulatif de fin de session (option) : podium, meilleur tour, incidents et sanctions regroupés par pilote ; notification des bannissements

🎨 Interface

• Thème clair et thème foncé (bouton soleil/lune ; suit le réglage de l'appareil par défaut), lisible sur téléphone
• UI Tailwind CSS v3 + HTMX + Alpine.js — actions sans rechargement, toasts temps réel, transitions fluides
• Fuseau horaire configurable, statut rafraîchi toutes les 5 s
• Footer avec version, git hash et liens GitHub

🚀 Installation

📖 Pas à pas avec captures / step-by-step guide with screenshots (English): Getting started

Une seule commande installe le panel et son serveur de jeu (Docker, Wine compris) ; la même commande le met à jour. Rien à cloner, rien à configurer à la main : clés et mots de passe sont générés, et le panel installe lui-même SteamCMD puis vous propose de télécharger le serveur ACE EVO dès la première connexion — il suffit de saisir votre compte Steam.

Prérequis : un compte Steam qui possède Assetto Corsa EVO (le compte anonyme de Steam n'a pas accès au serveur).

🐧 Linux (Debian, Ubuntu…)

curl -fsSL https://raw.githubusercontent.com/Zyphro3D/pannel-ac-evo-server/master/install.sh | sudo bash

Docker est proposé à l'installation s'il manque. Le panel s'installe dans /opt/pannel-ac-evo-server (option --dir).

🪟 Windows 10 / 11

Dans Terminal (administrateur) (clic droit sur Démarrer) :

irm https://raw.githubusercontent.com/Zyphro3D/pannel-ac-evo-server/master/install.ps1 | iex

Docker Desktop est installé (winget) s'il manque : redémarrez alors Windows, ouvrez Docker Desktop une fois, et relancez la commande. Le script ouvre aussi les ports du panel et du jeu dans le pare-feu Windows (réseau privé). Le panel s'installe dans %USERPROFILE%\ace-evo-panel.

Docker Desktop doit rester lancé pour que le panel et le serveur tournent : activez Settings → General → Start Docker Desktop when you sign in to your computer.

Ensuite

1. À la fin, le script affiche l'adresse du panel (http://IP:4300) et les identifiants générés (aussi dans le fichier .env) : changez les mots de passe dans le panel.
2. Connectez-vous en superadmin : le panel propose de télécharger le serveur ACE EVO. Saisissez votre compte Steam (identifiant, mot de passe, code Steam Guard si demandé) — rien n'est conservé.
3. Démarrez le serveur depuis la page Serveur. Au premier démarrage, le runtime Visual C++ nécessaire au serveur sous Wine s'installe tout seul (une à deux minutes).

Premier lancement : environ 10 minutes (construction des images).

Ouvrir les ports (accès depuis internet)

Configurez une redirection de ports sur votre box/routeur vers l'IP locale de votre serveur.

Multi-serveur : chaque serveur supplémentaire utilise ses propres ports (ex. serveur 2 : 9701 TCP/UDP + 8082 HTTP). Ouvrez les ports correspondants.

Accès HTTPS (optionnel)

Mode 1 — HTTP direct (défaut, aucune config supplémentaire)

http://IP:4300

Mode 2 — HTTPS intégré via Let's Encrypt

sudo apt install certbot
sudo certbot certonly --standalone -d votre-domaine.fr

Dans .env :

PANEL_PORT=443
SSL_CERTFILE=/etc/letsencrypt/live/votre-domaine.fr/fullchain.pem
SSL_KEYFILE=/etc/letsencrypt/live/votre-domaine.fr/privkey.pem
SESSION_COOKIE_SECURE=true

Dans docker-compose.yml, décommentez la ligne :

- /etc/letsencrypt:/etc/letsencrypt:ro

Après chaque renouvellement du certificat :

docker compose up -d panel

Mode 3 — Reverse proxy (Nginx, Caddy…)

Laissez le panel sur HTTP port 4300 et gérez le SSL côté reverse proxy. Assurez-vous que SESSION_COOKIE_SECURE=true est défini dans .env.

Architecture

docker compose
├── ace-panel       → Flask (port 4300) — rebuild rapide sans toucher au jeu
├── ace-server      → Wine + ACE EVO exe (ports 9700, 8081) — géré par le panel
├── ace-server-*    → Serveurs additionnels (multi-serveur, ports configurables)
└── dockerproxy     → Proxy Docker socket (isolation sécurité)

Volumes persistants :
  ./aceserver      → /aceserver   (configs, résultats, binaires)
  ./media          → /panel/media (images circuits, véhicules, bannières)
  panel_data                      (base de données SQLite)
  wine_prefix                     (prefix Wine du serveur principal, runtime Visual C++ compris)
  steamcmd                        (SteamCMD, installé automatiquement par le panel)
  steam_session                   (fichiers de travail de SteamCMD)

Structure du dossier aceserver/ :

aceserver/
├── AssettoCorsaEVOServer.exe   ← téléchargé par le panel (SteamCMD), non versionné
├── cars.json                   ← liste des voitures disponibles
├── events_practice.json        ← modèles de sessions practice
├── events_race_weekend.json    ← modèles de sessions race weekend
├── configs/                    ← fichiers de config JSON — créés par le panel, non versionnés
│   ├── default.json            ← créé automatiquement au premier démarrage
│   ├── *.json                  ← configs créées depuis l'interface
│   └── default.json.example   ← template fourni dans le repo
└── results/                    ← résultats de session — non versionnés
    └── result*.json

Configuration

Référence complète des variables .env (voir aussi .env.example) :

Général

Serveur de jeu

Bot TCP in-game (optionnel)

Le bot TCP se connecte au serveur ACE EVO pour envoyer des messages de bienvenue, détecter les meilleurs tours et alimenter le timing en direct.

Multi-serveur : un bot indépendant est démarré automatiquement pour chaque serveur activé. Chaque bot se connecte au container ACE EVO correspondant sur son port interne.

HTTPS / SSL (optionnel)

Si les deux variables sont renseignées, le panel démarre en HTTPS via gunicorn. Sinon, il utilise waitress en HTTP.

Discord (optionnel)

Emails (optionnel)

Mise à jour

Depuis le panel : Paramètres → Panel → Mise à jour du panel, bouton « Mettre à jour » (superadmin). Chaque version est signée ; la machine vérifie signature et empreinte, reconstruit, redémarre et revient à la version précédente si le panel ne répond plus. Cette fonction s'active en lançant une fois la commande d'installation ci-dessous (elle installe l'agent de mise à jour : service systemd sous Linux, tâche planifiée à l'ouverture de session sous Windows).

À la main : relancez la commande d'installation (Linux : curl … install.sh | sudo bash, Windows : irm … install.ps1 | iex) : elle télécharge la dernière version, vérifie son empreinte SHA-256, remplace le code et reconstruit les containers.

Le .env, la base de données, les configurations et les fichiers du jeu ne sont jamais modifiés par une mise à jour. Les migrations de schéma s'appliquent automatiquement au démarrage.

Installation faite avec git clone : git pull puis docker compose up -d --build fonctionne toujours ; le script d'installation peut aussi être lancé dans le même dossier (--dir), vos réglages sont conservés.

Rebuild complet et multi-serveur : docker-compose.override.yml est auto-généré par le panel et référence tous vos serveurs additionnels. Un docker compose up -d --build reconstruit tous les containers (principal + additionnels) sans intervention manuelle.

Personnalisations Docker locales : ne modifiez pas docker-compose.yml directement — vos changements seraient écrasés à chaque mise à jour. Utilisez docker-compose.override.yml à la place (Docker Compose le fusionne automatiquement). Notez que le panel régénère ce fichier pour la section services des serveurs additionnels ; ajoutez vos surcharges dans une section séparée.

Configs serveur : les fichiers aceserver/configs/*.json sont créés et gérés par le panel, ils ne sont pas versionnés. Une mise à jour ne les modifiera jamais.

Ceci met à jour le panel, pas le serveur de jeu. Pour mettre à jour ACE EVO Server lui-même (nouveau build Steam), utilisez le bouton de mise à jour dans l'interface (superadmin) — il lance SteamCMD avec suivi de progression, sans passer par la ligne de commande.

Changelog

Voir CHANGELOG.md pour l'historique complet des versions.

Soutenir le projet

Le panel est développé sur le temps libre, distribué gratuitement, et maintenu activement. Si vous l'utilisez pour vos courses ou votre club, le soutien sur Patreon aide à financer les prochaines fonctionnalités.

Soutenir Zyphro sur Patreon

Licence

Elastic License 2.0 — vous pouvez utiliser, copier, modifier et redistribuer le panel, y compris pour un club ou une communauté qui encaisse des inscriptions. Il est interdit de le proposer à des tiers comme service hébergé ou géré (revendre l’accès au panel) et de retirer les mentions de licence. © 2026 Florian Praturlon. Les versions publiées jusqu’à la v2.3.0 restent sous CC BY-NC 4.0 pour celles et ceux qui les ont reçues.

Crédits Wine : approche Docker inspirée de VandaLpr/acevo-docker-server.