
Show HN: Snitch – see every connection your computer makes
Track every hidden flow. / Traquez chaque flux masqué.
以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。
Track every hidden flow. / Traquez chaque flux masqué.
⭐ If Snitch helps you, a star means a lot! / Si Snitch vous aide, une étoile compte beaucoup ! ⭐
Snitch is a real-time network traffic visualizer. See every connection your computer makes — who it talks to, where they are, and which app is responsible.
The entire interface is available in English and French: use the EN / FR toggle in the top-right toolbar.
vs Little Snitch / Lulu — those are macOS firewalls that block connections; Snitch visualizes and explains traffic, is cross-platform, free and open-source.
vs GlassWire — Snitch is free, open-source (AGPL), requires no account and makes zero outbound calls; even geolocation is offline.
vs Wireshark — Snitch gives a live, high-level overview anyone can read, instead of raw packet dissection.
vs cloud-based monitors — everything runs on 127.0.0.1 behind a token; your traffic data never leaves the machine.
Features
Feature Description
Force Graph Live node graph — your machine at the center, every connection as a node
World Map Geolocated IPs with animated arcs on an interactive globe
15/30/60-min Timeline Sliding history stored locally in SQLite (24 h retention)
Anomaly Detection Flags port scans, beaconing, potential exfiltration
Process Attribution Know which app generates which traffic (top 5 per connection)
LAN Scanner Passive discovery via the system ARP table (no broadcast scans)
Privacy Score Real-time score of your outgoing traffic exposure
Per-app View Per-process destinations, volumes and 60-min history
Alert Suppression Persisted "ignore host/type" rules, manageable in the UI
Settings Panel Language, retention, filters, consent-gated GeoIP download, diagnostics
Tracker Detection Suffix-matched domain lists shipped as editable data files (backend/classifier/lists/)
Bandwidth Monitor Live MB/s sparkline
EN / FR UI Full bilingual interface, one click to switch
Download
Platform Package
macOS (Apple Silicon) brew install --cask aixisstudio/tap/snitch — or Snitch-1.0.5-macos-arm64.zip
Linux sudo docker compose up --build — see Docker (Linux)
Windows snitch-backend-windows-latest.tar.gz (backend, requires Npcap) — or build from source, see Build the installer
Or grab the latest release: github.com/aixisstudio/Snitch/releases
macOS first run / Premier lancement macOS — Snitch is ad-hoc signed, not notarized (no paid Apple Developer ID). The brew install --cask above removes the quarantine flag for you. For the manual zip: right-click → Open, or run xattr -dr com.apple.quarantine /Applications/Snitch.app. On first launch Snitch asks for your admin password once — packet capture requires it, same as tcpdump/Wireshark; the UI itself stays unprivileged.
FR — Snitch est signé ad-hoc, pas notarisé (pas de Developer ID payant). Le brew install --cask ci-dessus retire le drapeau de quarantaine pour vous. Pour le zip manuel : clic droit → Ouvrir, ou xattr -dr com.apple.quarantine /Applications/Snitch.app. Au premier lancement, Snitch demande le mot de passe admin une fois — la capture de paquets l'exige, comme tcpdump/Wireshark ; l'UI reste non privilégiée.
Layer Technology
Packet capture ctypes → libpcap — Npcap (Windows) / libpcap (Linux/macOS) — own parser (IPv4/IPv6/TCP/UDP/DNS/TLS-SNI)
Backend API FastAPI — WebSockets — SQLite
Frontend React 19 — Vite — D3.js v7 — TopoJSON
Desktop wrapper Electron 44
Geolocation Offline only — DB-IP Lite (CC BY 4.0) bundled gzip'd in backend/data/geo/, decompressed on first run; MaxMind GeoLite2 .mmdb also supported
Security & privacy
API token — every REST endpoint and the WebSocket require a token. Electron generates it per launch; in Docker/browser it's printed once in the backend logs and stored in data/api_token.txt. Open the UI with http://localhost:8000/?token=<TOKEN> (or enter it when prompted).
Loopback-only by default — the API binds 127.0.0.1 in every mode. Set SNITCH_BIND=0.0.0.0 only if you explicitly want LAN access (token auth still applies).
CORS/WebSocket origin allowlist — only localhost:5173, the backend's own origin and Electron file:// pages may connect.
Geolocation is offline-only — there is no online lookup. DB-IP Lite (CC BY 4.0) ships gzip'd in backend/data/geo/ and is auto-extracted into <data_dir>/geo/ on first launch — geo works out of the box, zero network calls. You may still drop newer GeoLite2-City.mmdb/GeoLite2-ASN.mmdb (MaxMind) into <data_dir>/geo/, or download a fresh DB-IP Lite from the Settings panel (explicit consent, the only possible outbound call).
All data stays local — snitch.db (24 h sliding window, configurable via retention_hours setting) and data/logs/snitch.log never leave the machine. No telemetry. The only possible outbound call is the opt-in DB-IP Lite download (Settings → "Download DB-IP Lite"), which requires an explicit click.
Settings persist — port filters, excluded processes, the IP whitelist, language and retention are stored in SQLite and restored on restart.
Alert suppression — each alert has an "Ignore this type/host" action; suppression rules are persisted (alert_suppressions table), applied before alerts are emitted or logged, and survivable across restarts via POST /alerts/ignore / DELETE /alerts/ignore / GET /alerts/ignore.
History — per-minute per-host and per-process byte/packet aggregates are kept in SQLite (host_history, process_history) for the retention window, powering the per-application view and GET /history/host/{ip} / GET /history/process/{name}.
Diagnostics — GET /diagnostics returns a JSON snapshot of the runtime (capture state, geo DB status, interface, versions, paths) with no secrets; the Settings panel can export it or open the log directory (Electron).
LAN devices are discovered passively from the system ARP table — no active broadcast scanning. Device names are learned from what devices broadcast themselves: mDNS *.local (Apple/Linux), LLMNR & NetBIOS names (Windows), DHCP hostname options, plus the full offline IEEE OUI vendor table, and your gateway is auto-detected as the router.
See docs/threat-model.md for the full threat model.
Docker (Linux)
The Docker deployment is for Linux users who want to run Snitch without installing anything beyond Docker. Packet capture works via network_mode: host — the container sees real host traffic.
Note: Docker Desktop on Mac/Windows runs inside a VM and cannot capture traffic from the host. Use the Electron app on those platforms.
Clone and enter the repo / Cloner puis entrer dans le dépôt
git clone <your-repo-url> snitch cd snitch
Optional: place your MaxMind GeoLite2-City.mmdb in data/ for offline geolocation
Optionnel : placez votre GeoLite2-City.mmdb dans data/ pour la géolocalisation hors ligne
mkdir -p data
Build and run (requires Docker + root/sudo for raw socket capture)
Construire et lancer (Docker + root/sudo requis pour la capture)
sudo docker compose up --build
Get the API token (printed once at startup, or cat data/api_token.txt), then open http://localhost:8000/?token=TOKEN in your browser.
To run in the background: sudo docker compose up -d --build
Demo mode / Mode démo — run the backend with SNITCH_DEMO=1 to feed synthetic traffic through the real pipeline: no root, no libpcap, no real packets touched. Ideal for screenshots, tests and previews. Lancez le backend avec SNITCH_DEMO=1 pour injecter un trafic synthétique dans le pipeline réel — ni root ni libpcap ni paquets réels.
Backend (admin terminal) — API at http://127.0.0.1:8000
cd backend pip install -r requirements.txt python run_backend.py # prints the API token once
Frontend (separate terminal) — UI at http://localhost:5173/?token=TOKEN
cd frontend npm install npm run dev
Electron (optional, admin terminal) — token is injected automatically
cd electron npm install set VITE_DEV=1 # Windows
VITE_DEV=1 # macOS/Linux shell
npx electron .
Tests:
cd backend && pip install -r requirements-dev.txt && python -m pytest tests/ -v cd frontend && npm test
Build the installer
1 — Compile backend (PyInstaller)
cd backend pip install -r requirements.txt pyinstaller pyinstaller backend.spec --distpath ../dist/backend
2 — Build frontend
cd ../frontend npm ci npm run build
3 — Build Electron installer (the icon is generated automatically)
cd ../electron npm ci npm run build # NSIS installer -> dist/installer/Snitch Setup <version>.exe
npm run build:dir # unpacked app only -> dist/installer/win-unpacked/
Project structure
snitch/ ├── backend/ Python FastAPI + libpcap capture engine (ctypes, own parser) ├── frontend/ React + D3.js UI (EN/FR) ├── electron/ Electron wrapper (main, splash, preload) ├── data/ Runtime data (SQLite DB, .mmdb geo DBs in geo/) └── dist/ Compiled output (backend exe, installer)
Français
Snitch est un visualiseur de trafic réseau en temps réel. Voyez chaque connexion que votre ordinateur établit — à qui il parle, où se trouvent les serveurs, et quelle application est responsable.
Toute l'interface est disponible en français et en anglais : utilisez le sélecteur EN / FR dans la barre d'outils en haut à droite.
vs Little Snitch / Lulu — ce sont des pare-feux macOS qui bloquent les connexions ; Snitch visualise et explique le trafic, est multiplateforme, gratuit et open-source.
vs GlassWire — Snitch est gratuit, open-source (AGPL), sans compte et n'effectue aucun appel sortant ; même la géolocalisation est hors ligne.
vs Wireshark — Snitch offre une vue d'ensemble en direct lisible par tous, plutôt qu'une dissection brute de paquets.
vs les moniteurs cloud — tout tourne sur 127.0.0.1 derrière un jeton ; vos données de trafic ne quittent jamais la machine.
Fonctionnalités
Fonctionnalité Description
Graphe de force Graphe de nœuds en direct — votre machine au centre, chaque connexion comme nœud
Carte du monde IPs géolocalisées avec arcs animés sur un globe interactif
Timeline 15/30/60 min Historique glissant stocké localement dans SQLite (rétention 24 h)
Détection d'anomalies Signale scans de ports, beaconing, exfiltration potentielle
Attribution processus Sachez quelle app génère quel trafic (top 5 par connexion)
Scanner LAN Découverte passive via la table ARP système (aucun scan broadcast)
Score de confidentialité Score en temps réel de l'exposition de votre trafic sortant
Vue par application Destinations, volumes et historique 60 min par processus
Suppression d'alertes Règles « ignorer hôte/type » persistées, gérables dans l'UI
Panneau Réglages Langue, rétention, filtres, téléchargement GeoIP sous consentement, diagnostic
Détection de trackers Listes de domaines par suffixe, livrées en fichiers de données éditables (backend/classifier/lists/)
Moniteur de débit Sparkline MB/s en direct
UI FR / EN Interface entièrement bilingue, bascule en un clic
Téléchargement
Plateforme Paquet
macOS (Apple Silicon) brew install --cask aixisstudio/tap/snitch — ou Snitch-1.0.5-macos-arm64.zip
Linux sudo docker compose up --build — voir Docker (Linux)
Windows snitch-backend-windows-latest.tar.gz (backend, nécessite Npcap) — ou build depuis les sources, voir Développement
Ou récupérez la dernière release : github.com/aixisstudio/Snitch/releases
Premier lancement macOS — Snitch est signé ad-hoc, pas notarisé. Le brew install --cask retire la quarantaine pour vous. Pour le zip manuel : clic droit → Ouvrir, ou xattr -dr com.apple.quarantine /Applications/Snitch.app. Premier lancement : mot de passe admin demandé une fois (la capture de paquets l'exige, comme tcpdump/Wireshark).
Couche Technologie
Capture de paquets ctypes → libpcap — Npcap (Windows) / libpcap (Linux/macOS) — parseur maison (IPv4/IPv6/TCP/UDP/DNS/SNI-TLS)
API backend FastAPI — WebSockets — SQLite
Frontend React 19 — Vite — D3.js v7 — TopoJSON
Conteneur bureau Electron 44
Géolocalisation Hors ligne uniquement — DB-IP Lite (CC BY 4.0) embarquée gzipée dans backend/data/geo/, décompressée au premier lancement ; MaxMind GeoLite2 .mmdb aussi pris en charge
Sécurité & conf
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。