3.9 KiB
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* (слетит после перезагрузки) |