Created 2026-10-17

0 stars
Code

3.9 KiB

Установка и запуск (macOS/Linux)

1. Клонируем и ставим Rust

git clone --depth 1 https://github.com/stamparm/maltrail.git
cd maltrail

# cargo в macOS из коробки нет — ставим тулчейн
curl https://sh.rustup.rs -sSf | sh -s -- -y
. "$HOME/.cargo/env"
cargo --version    # проверка

2. Собираем сенсор

cargo build --release --manifest-path sensor/Cargo.toml
# бинарник: sensor/target/release/maltrail-sensor

3. Правим maltrail.conf

# Порт 8338 может быть занят на IPv6 (::1) чужим процессом —
# браузер по localhost попадёт НЕ на наш сервер и покажет демо-страницу.
# Проверка: lsof -nP -iTCP:8338 -sTCP:LISTEN
HTTP_PORT 8339

# По умолчанию логи идут в /var/log/maltrail — на маке без sudo не создать.
# Проще писать логи внутрь проекта:
LOG_DIR /Users/<user>/projects/maltrail/log/maltrail

# на macOS нет интерфейса 'any' — называем реальный (Wi-Fi = en0)
MONITOR_INTERFACE en0

# свой белый список (например, собственный прокси,
# который эвристика beaconing считает подозрительным)
USER_WHITELIST data/user_whitelist.txt

4. Каталоги и белый список

mkdir -p log/maltrail
printf '# own infrastructure\n222.22.222.222\n' > data/user_whitelist.txt

5. Самотест сенсора

# Покажет ВСЕ проблемы до запуска — не пропускайте.
# Ругань "not root" на этом этапе нормальна — лечится sudo на шаге 7.
sensor/target/release/maltrail-sensor -T

6. Запускаем сервер

# Сервер читает конфиг ТОЛЬКО при старте.
# Поменяли maltrail.conf — перезапускайте, иначе дашборд будет пустым.
python3 server.py

7. Запускаем сенсор

# sudo обязателен — захват пакетов через /dev/bpf* доступен только root.
# Белый список читается при старте: добавили запись = перезапустили сенсор.
sudo sensor/target/release/maltrail-sensor
# первый старт построит trails.csv (~2 млн индикаторов, пара минут), потом "running..."

8. Открываем интерфейс

Открываем http://localhost:8339 — логин по умолчанию admin / changeme! (сменить в конфиге, хранится как sha256).

Траблшутинг

Симптом Причина Лечение
«Maltrail (demo)» в заголовке, нет кнопки входа порт на IPv6 слушает чужой процесс lsof -nP -iTCP:<порт> -sTCP:LISTEN, сменить HTTP_PORT, жёстко обновить страницу (Cmd+Shift+R)
Логин есть, данных нет сервер стартовал до правки LOG_DIR перезапуск server.py
capture privileges: not root сенсор без sudo sudo sensor/target/release/maltrail-sensor
Срабатывает на свой прокси/VPN эвристика beaconing добавить IP в data/user_whitelist.txt, перезапустить сенсор
Хочется запускать сенсор без sudo нет доступа к /dev/bpf* sudo chgrp admin /dev/bpf* && sudo chmod g+rw /dev/bpf* (слетит после перезагрузки)