🐳 Docker Recommandé

Une image nginx légère servant le site, prête à l'emploi.

git clone https://github.com/gothamblood/NeonFlare neonflare
cd neonflare
docker build -t neonflare .
docker run -d --name neonflare --restart unless-stopped -p 8080:80 neonflare

Accessible ensuite sur http://localhost:8080.

🐍 Python 3 (serveur local)

Le serveur HTTP intégré à Python suffit : aucune installation, rien à configurer. C'est la méthode à utiliser pour Firefox en local (voir la limite ci-dessous).

git clone https://github.com/gothamblood/NeonFlare neonflare
cd neonflare
python3 -m http.server 8000 --bind 127.0.0.1

Accessible ensuite sur http://127.0.0.1:8000 (Ctrl+C pour arrêter). Lance la commande depuis la racine du dépôt, pas depuis un sous-dossier. --bind 127.0.0.1 limite l'accès à ta machine. Garde toujours la même adresse : 127.0.0.1:8000 et localhost:8000 ont chacun leur propre stockage.

🌐 nginx manuel

Le dépôt fournit un nginx.conf prêt à l'emploi -- un bloc server {} complet, à déposer tel quel dans conf.d/.

git clone https://github.com/gothamblood/NeonFlare neonflare
cp neonflare/nginx.conf /etc/nginx/conf.d/neonflare.conf
cp -r neonflare/* /usr/share/nginx/html/
nginx -s reload

🪟 IIS (Windows)

Copie le dossier tel quel dans la racine du site. web.config apporte la même règle de cache que nginx.conf, plus les mêmes blocages de fichiers internes (Jenkinsfile, nginx.conf, scripts/, fichiers cachés) -- web.config lui-même est déjà protégé nativement par IIS.

git clone https://github.com/gothamblood/NeonFlare neonflare
# Copie le contenu de neonflare/ dans la racine de ton site IIS
# (ex. C:\inetpub\wwwroot\neonflare) -- web.config est déjà inclus.

💻 En local, sans serveur

Aucune fonctionnalité ne dépend d'un appel réseau vers un backend -- ouvre simplement index.html dans ton navigateur.

git clone https://github.com/gothamblood/NeonFlare neonflare
# puis ouvre neonflare/index.html directement dans ton navigateur

🖥️ Shells embarqués (ttyd + tmux)

Nécessite ttyd et tmux installés sur la machine qui héberge le site.

# Debian / Ubuntu / Kali
sudo apt install tmux

# ttyd : paquet selon distro, ou binaire depuis
# https://github.com/tsl0922/ttyd/releases
sudo wget -O /usr/local/bin/ttyd https://github.com/tsl0922/ttyd/releases/download/1.7.7/ttyd.x86_64
sudo chmod +x /usr/local/bin/ttyd

scripts/ttyd-shells.sh start   # 6 instances par type (bash, zsh, pwsh)
scripts/ttyd-shells.sh status
scripts/ttyd-shells.sh stop

Chaque instance ttyd est liée à 127.0.0.1 uniquement -- jamais exposée sur le réseau, même si le site l'est.

🪟 Windows (WSL2 · Kali)

Sous Windows, les shells tournent dans WSL2 (ici Kali Linux). scripts/wsl/ttyd-shells.sh vérifie l'environnement WSL (dépendances, version de ttyd, fins de ligne, dossier privé des sockets) puis lance le même script que sous Linux -- même protection par jeton. Le lanceur scripts\wsl\start-shells.cmd (double-clic) démarre les shells et reste ouvert : garde cette fenêtre tant que tu les utilises (sinon WSL arrête ttyd et le proxy), et arrête avec Ctrl+C -- ou par scripts\wsl\stop-shells.cmd.

# PowerShell (admin), une seule fois :
wsl --install -d kali-linux

# Dans Kali (WSL) :
sudo apt update && sudo apt install -y ttyd tmux python3

# Depuis Windows : double-clic sur scripts\wsl\start-shells.cmd
# (garde la fenêtre ouverte ; Ctrl+C ou stop-shells.cmd pour arrêter)
# -- ou, dans WSL, à la racine du dépôt :
scripts/wsl/ttyd-shells.sh run      # bloquant, garde les shells en vie
scripts/wsl/ttyd-shells.sh status
scripts/wsl/ttyd-shells.sh stop

Le site s'ouvre depuis Windows : index.html directement dans Chrome / Edge, ou en http pour Firefox (python3 -m http.server 8000 --bind 127.0.0.1 dans WSL, voir Python 3). Le réseau WSL2 par défaut (NAT) suffit -- aucun .wslconfig à configurer. Pense à exclure le dossier du dépôt de ton antivirus (des fichiers de référence comme config/lolbas.js peuvent être signalés). Si tu as cloné le dépôt depuis Windows avant l'ajout du .gitattributes, le script signale les fins de ligne CRLF et donne la commande de correction.

🔒 Basic auth via nginx

Le plus simple pour un accès à quelques personnes -- un identifiant/mot de passe demandé par le navigateur avant même de charger la page.

htpasswd -c /etc/nginx/.htpasswd toncompte

# Dans le bloc server { } de nginx.conf :
location / {
    auth_basic           "NeonFlare";
    auth_basic_user_file /etc/nginx/.htpasswd;
    try_files $uri $uri/ =404;
}

🛡️ Authelia, Tailscale, ou équivalent

Pour aller au-delà du basic auth (SSO, 2FA, accès limité à ton propre réseau) : Authelia devant un reverse proxy, ou Tailscale pour ne rendre l'instance joignable que depuis ton propre VPN -- NeonFlare n'a besoin de rien de spécial de son côté, seulement d'être servi derrière l'un ou l'autre.