Installation FR

Installation (FR)

🇬🇧 English version: Installation

macOS (Apple Silicon) — recommandé

1. Téléchargez Snitch-1.0.0-macos-arm64.zip (212 Mo) depuis la page des releases.
2. Décompressez et glissez Snitch.app dans /Applications.
3. La build n'est pas signée (pas de certificat Apple Developer). macOS la bloque à la première ouverture :
   • Clic droit sur l'app → Ouvrir → confirmer Ouvrir, ou
   • Réglages Système → Confidentialité et sécurité → Ouvrir quand même.
4. La capture réelle exige des privilèges élevés — l'app demande votre mot de passe (sudo) une fois au démarrage de la capture. C'est inhérent à libpcap/BPF, comme Wireshark ou Little Snitch.

Envie de jeter un œil sans rien installer ? Le mode démo (SNITCH_DEMO=1) simule du trafic synthétique — aucun privilège requis. Voir le Guide d'utilisation.

Linux — Docker

Le déploiement Docker est pensé pour Linux : la capture fonctionne via network_mode: host, le conteneur voit le vrai trafic de l'hôte.

git clone https://github.com/aixisstudio/Snitch.git snitch
cd snitch
sudo docker compose up --build

Récupérez ensuite le jeton API (affiché une fois dans les logs du backend, ou cat data/api_token.txt) et ouvrez http://localhost:8000/?token=JETON dans votre navigateur.

En arrière-plan : sudo docker compose up -d --build

Limites Docker

• L'attribution par processus est limitée aux processus du conteneur (les PID hôtes ne sont pas partagés par défaut).
• Le scanner LAN peut être indisponible selon la configuration réseau.
• ⚠️ Docker Desktop sur macOS/Windows tourne dans une VM et ne peut pas capturer le trafic de l'hôte — utilisez l'app native sur ces plateformes.

Windows — compiler depuis les sources

Prérequis : Python 3.11+, Node.js 18+, Npcap installé, et un terminal Administrateur (la capture de paquets bruts l'exige).

# Backend — API sur http://127.0.0.1:8000
cd backend
pip install -r requirements.txt
python run_backend.py   # affiche le jeton API une fois

# Frontend (autre terminal) — UI sur http://localhost:5173/?token=JETON
cd frontend
npm install
npm run dev

# Electron (optionnel, terminal admin) — jeton injecté automatiquement
cd electron
npm install
set VITE_DEV=1
npx electron .

Compiler l'installateur macOS vous-même

# 1 — Compiler le backend (PyInstaller)
cd backend
pip install pyinstaller
pyinstaller backend.spec --distpath ../dist/backend

# 2 — Construire le frontend
cd frontend
npm run build

# 3 — Construire l'app Electron
cd electron
npm run build:dir

Résultat : dist/installer/mac-arm64/Snitch.app.

Où vivent vos données

Chemin	Contenu
~/Library/Application Support/Snitch/ (macOS) ou data/	Base SQLite (snitch.db), logs, api_token.txt, bases GeoIP extraites

Tout reste sur votre machine — voir Sécurité & confidentialité.