Skip to content

Real-time network monitor + outbound firewall — see & block every connection. Privacy-first, local-first, Rust fleet agent, SIEM exports, 8 languages. / Moniteur réseau temps réel + pare-feu sortant, agent de flotte Rust, exports SIEM. 100 % local.

18.3 KB
Raw Blame

Snitch

Отслеживай каждое скрытое соединение.

English | Français | Español | Deutsch | Русский | 日本語 | Português | 中文

⭐ Если Snitch полезен — звезда много значит! ⭐

License: AGPL v3 Platform: macOS Platform: Windows Platform: Linux GitHub release GitHub stars

Snitch live graph — LAN perimeter, geolocated hosts, alerts


Snitch — визуализатор сетевого трафика в реальном времени. Видно каждое соединение компьютера: с кем он говорит, где находится собеседник и какое приложение отвечает.

Весь интерфейс доступен на English, Français, Español, Deutsch, Русский, 日本語, Português (BR) и 简体中文: переключатель языка в панели инструментов.

Зачем Snitch?

  • vs Little Snitch / Lulu — та же идея (видимость по приложениям + правила блокировки), но Snitch кроссплатформен, бесплатен и открыт. Блокировка оркестрируется через нативный фаервол ОС (netsh / iptables / pf) — Snitch никогда не фильтрует в user-space.
  • vs GlassWire — Snitch бесплатен, open source (AGPL), без аккаунта и не делает исходящих вызовов без opt-in; даже геолокация офлайн.
  • vs Wireshark — Snitch даёт живой высокоуровневый обзор вместо сырой диссекции пакетов.
  • vs облачные мониторы — всё работает на 127.0.0.1 за токеном; данные трафика не покидают машину.

Возможности

Функция Описание
Force-граф Живой граф узлов — машина в центре, каждое соединение — узел
Карта мира Геолокализованные IP с анимированными дугами на интерактивном глобусе
Таймлайн 15/30/60 мин Скользящая история локально в SQLite (хранение 24 ч)
Детекция аномалий Сканирование портов, beaconing (C2 через равные интервалы), потенциальная эксфильтрация
Продвинутая детекция Эвристика DNS-туннеля, незашифрованные порты, отклонение от странового профиля приложения
Оркестрация фаервола Правила блокировки (IP/CIDR/домен/процесс/порт) применяются к фаерволу ОС — netsh/iptables/pf, персистентность, счётчики блокировок
Режим lockdown Паническая кнопка — помечает и блокирует весь исходящий публичный трафик, LAN остаётся
Реагирование на инциденты Убить / приостановить процесс, заблокировать IP — в один клик из деталей соединения
Threat intelligence Opt-in проверки репутации (AbuseIPDB / AlienVault OTX / VirusTotal) с вашим API-ключом — выключено по умолчанию, результаты кэшируются
Аудит безопасности Встроенный отчёт харденинга — оценка, находки, рекомендации простым языком
Форензик-экспорт Пакет расследования в один клик — дерево процессов + SHA-256 бинарника, история и связанные тревоги (JSON/CSV/STIX)
Webhook-оповещения Opt-in пересылка warning/critical-тревог в Discord, Slack, Telegram или любой endpoint
Атрибуция процессов Какая программа генерирует какой трафик (топ-5 на соединение)
LAN-сканер Пассивное обнаружение по системной ARP-таблице (без broadcast-сканов)
Privacy Score Живая оценка экспозиции исходящего трафика
Вид по приложениям Назначения, объёмы и история 60 мин по процессам
Подавление тревог Персистентные правила «игнорировать хост/тип», управляемые в UI
Панель настроек Язык, хранение, фильтры, загрузка GeoIP с согласия, диагностика
Детекция трекеров Списки доменов по суффиксам в редактируемых файлах (backend/classifier/lists/)
Монитор полосы Живой спарклайн MB/s
UI на 8 языках EN · FR · ES · DE · RU · JA · PT-BR · ZH-CN — переключение в один клик, локали в frontend/src/locales/
Светлая/тёмная тема По умолчанию следует системе, ручное переключение сохраняется
Автообновление Десктоп-приложение проверяет GitHub Releases (отключается в настройках; SNITCH_NO_UPDATE=1)
QUIC / HTTP/3 Потоки UDP/443 помечаются честно — SNI в QUIC зашифрован и не читается
Watchlist Закрепите IP/домены — отдельная тревога при первом контакте
Тревога пика отправки Потолок МБ/мин на процесс с настраиваемым порогом
Выбор интерфейса Какой адаптер слушать — без переменных окружения
Контекст Wi-Fi Текущий SSID в панели инструментов
Экспорт Граф + тревоги в JSON/CSV в один клик

Скачать

Платформа Пакет
macOS (Apple Silicon) brew install --cask aixisstudio/tap/snitch — или Snitch.app zip/dmg из последнего релиза
Linux Snitch AppImage / .deb / .rpm / .snap из последнего релиза — или sudo docker compose up --build, см. Docker (Linux)
Headless (любая ОС) brew install aixisstudio/tap/snitch → демон snitchd (серверы/ВМ, без GUI)
Windows Snitch Setup .exe — установщик NSIS в один клик (нативное приложение, UAC при запуске, проверка Npcap встроена) из последнего релиза. Облегчённая альтернатива: Snitch-Lite-Setup (бэкенд + UI в браузере). Требуется Npcap
Все (1 клик) Pinokio — ставит зависимости, запускает бэкенд, открывает UI

Или возьмите последний релиз: github.com/aixisstudio/Snitch/releases

Первый запуск на macOS — Snitch подписан ad-hoc, без нотаризации (нет платного Apple Developer ID). brew install --cask снимает карантин за вас. Для ручного zip: правый клик → Открыть, или xattr -dr com.apple.quarantine /Applications/Snitch.app. При первом запуске Snitch один раз спросит пароль администратора — захват пакетов этого требует, как tcpdump/Wireshark; UI остаётся без привилегий.

Подпись кода Windows — сборки Windows будут подписываться Authenticode бесплатным open-source сертификатом SignPath Foundation через SignPath.io (заявка подана, ожидает одобрения). До первой подписанной сборки SmartScreen может предупреждать — Подробнее → Выполнить в любом случае.

Стек

Слой Технология
Захват пакетов ctypes → libpcap — Npcap (Windows) / libpcap (Linux/macOS) — собственный парсер (IPv4/IPv6/TCP/UDP/DNS/TLS-SNI)
Backend API FastAPI — WebSockets — SQLite
Frontend React 19 — Vite — D3.js v7 — TopoJSON
Десктоп-обёртка Electron 44
Геолокация Только офлайн — DB-IP Lite (CC BY 4.0) идёт gzip'нутой в backend/data/geo/, распаковывается при первом запуске; поддерживаются и .mmdb MaxMind GeoLite2

Безопасность и приватность

  • API-токен — каждый REST-endpoint и WebSocket требуют токен. Electron генерирует его при запуске; в Docker/браузере печатается один раз в логах и сохраняется в data/api_token.txt. Откройте UI: http://localhost:8000/?token=<ТОКЕН>.
  • Только loopback по умолчанию — API слушает 127.0.0.1 во всех режимах. SNITCH_BIND=0.0.0.0 — только для явного LAN-доступа (токен обязателен).
  • Allowlist CORS/Origin для WebSocket — подключаться могут только localhost:5173, собственный origin бэкенда и file://-страницы Electron.
  • Геолокация 100 % офлайн — никаких онлайн-запросов. DB-IP Lite (CC BY 4.0) распаковывается в <data_dir>/geo/; можно положить свежие .mmdb MaxMind или скачать DB-IP Lite в настройках (явное согласие; остальные opt-in вызовы — threat intel, webhooks, обновления — в PRIVACY.md).
  • Все данные локальны — snitch.db (скользящее окно 24 ч, retention_hours) и data/logs/snitch.log не покидают машину. Никакой телеметрии. Каждый исходящий вызов — opt-in.
  • Настройки сохраняются — фильтры портов, исключённые процессы, белый список IP, правила фаервола, язык и хранение — в SQLite, восстанавливаются при рестарте.
  • Правила фаервола best-effort — бэкенд управляет фаерволом ОС (netsh advfirewall, iptables, якоря pf); без привилегий правило сохраняется и матчится для видимости (тревоги BLOCKED_ATTEMPT) с честной меткой «не применено». Lockdown сохраняет loopback + LAN.
  • Threat intel и webhooks — opt-in — выключены по умолчанию; включение провайдера или webhook добавляет исходящие вызовы (см. PRIVACY.md).
  • Подавление тревог — у каждой тревоги есть «Игнорировать тип/хост»; правила персистентны (alert_suppressions), управляются через POST|DELETE|GET /alerts/ignore.
  • История — поминутные агрегаты по хостам и процессам в SQLite (host_history, process_history), питают вид по приложениям и GET /history/*.
  • Диагностика — GET /diagnostics возвращает JSON-снимок среды без секретов; экспортируется из настроек.
  • LAN-устройства обнаруживаются пассивно по ARP-таблице — без активных сканов. Имена — из того, что устройства сами вещают: mDNS *.local, LLMNR/NetBIOS, hostname DHCP, полная офлайн-таблица IEEE OUI; шлюз определяется как роутер.
  • См. docs/threat-model.md для модели угроз и docs/FIREWALL.md для security-набора.

Docker (Linux)

Docker-развёртывание — для пользователей Linux, запускающих Snitch без установки чего-либо ещё. Захват работает через network_mode: host — контейнер видит реальный трафик хоста.

Готовый образ — без клонирования и сборки:

sudo docker run --network host --cap-add NET_ADMIN --cap-add NET_RAW \
  -v snitch-data:/app/data ghcr.io/aixisstudio/snitch

Примечание: Docker Desktop на Mac/Windows работает внутри VM и не может захватывать трафик хоста. Используйте приложение Electron.

Токен API — выводится один раз при запуске или cat data/api_token.txt, затем откройте http://localhost:8000/?token=ТОКЕН в браузере. В фоне: sudo docker compose up -d --build

Ограничения Docker: атрибуция процессов — только процессы контейнера; LAN-сканер может быть недоступен в некоторых сетях.

Разработка

Требования: Python 3.11+, Node.js 18+, Npcap (только Windows), терминал администратора для бэкенда.

Демо-режим — SNITCH_DEMO=1 прогоняет синтетический трафик через настоящий pipeline: ни root, ни libpcap, ни реальных пакетов. Идеально для скриншотов и тестов.

cd backend && pip install -r requirements.txt && python run_backend.py
cd frontend && npm install && npm run dev   # http://localhost:5173/?token=ТОКЕН
cd electron && npm install && VITE_DEV=1 npx electron .

Тесты:

cd backend && pip install -r requirements-dev.txt && python -m pytest tests/ -v
cd frontend && npm test

Структура проекта

snitch/
├── backend/       FastAPI + захват libpcap (ctypes, собственный парсер)
├── frontend/      UI на React + D3.js (8 языков)
├── electron/      Обёртка Electron (main, splash, preload)
├── data/          Данные выполнения (SQLite, .mmdb в geo/)
└── dist/          Сборка (exe бэкенда, установщик)

Enterprise и флот

Snitch работает и headless для SOC-развёртываний — всё через файлы и бесплатно:

  • Security-as-Code — один snitch.toml (или $SNITCH_CONFIG) переопределяет все настройки; флоты через Ansible (deploy/ansible/), Puppet, Salt или GPO.
  • Rust-агент — демон без зависимостей (agent/) шлёт сокеты в POST /ingest/events с атрибуцией /proc→PID в Linux; POST /ingest/enroll выдаёт одноразовые sagt_… токены (хэшированные, отзываемые).
  • SIEM-нативно — syslog CEF или RFC 3164, универсальные webhook и GET /forensics/export?format=ecs (NDJSON Elastic Common Schema) питают Wazuh, Splunk, Graylog, Loki и Elastic. Импорт Sigma (POST /alerts/rules/sigma), экспорт YARA-L (GET /alerts/rules/yaral).
  • Вид флота — GET /remote/fleet объединяет аудиты всех пиров; Helm-чарт (deploy/helm/snitch) запускает коллектор в кластере.
  • Бесплатные TI-фиды — POST /firewall/blocklist импортирует доменные (StevenBlack) и IP-списки (Blocklist.de, URLhaus/Feodo); ti_feeds планирует автообновления.

Пошаговые рецепты: docs/INTEGRATIONS.md.

Лицензия

AGPL v3 — см. LICENSE. Свободно использовать, изучать и изменять; производные должны оставаться open source под AGPL v3.

История звёзд

Star History Chart