Что нового
- Обновлены промпты для улучшения качества анализа (для снижения FN)
Требования
- Docker
- Ollama с LLM (любая модель, например llama3.2:latest)
- 8+ GB RAM
Начало работы
-
Скачиваем архив с файлами из Assets (wavescan-1.0.1.zip)
-
Распаковываем архив и переходим в папку
-
Переименовываем
.env.exampleв.env
Обязательно отредактируйте следующие переменные:
OLLAMA_URLиOLLAMA_MODEL- ваша локальная модель OllamaPOSTGRES_PASSWORD- пароль для базы данныхPASSWORD_SALT- соль для хэширования паролей
Опционально можно отредактировать:
VITE_SBER_SPEECH_API_KEY- ключ от SberSpeech (для активации голосового ввода)CLI_TZ_OFFSET_HOURS- ваш часовой пояс
- Запускаем Docker
docker compose up -dЖдем, пока все образы сами подтянутся с DockerHub
- Переходим на сайт (порт указывается в
.env, по умолчанию -3000)
http://localhost:{FRONTEND_PORT}/Готово!
Для выключения:
docker compose downРегистрация пользователя
- Для подключения к консоли пишем (название контейнера указывается в
.env, команду нужно писать в корневой папке, по умолчанию -cyberlog-backend)
docker exec -it {BACKEND_CONTAINER_NAME} python app.py interactive- Регистрируем нового пользователя
register- Управление правами администратора и просмотр пользователей
users
set_admin <login> on
set_admin <login> offРаздел «Конфиг» в веб-интерфейсе доступен только пользователям с is_admin = true.
Подключение внешнего источника логов
Wavescan принимает внешние логи через общий Docker-том (файлы .log/.txt) или через Push API. Для потоковых источников проще всего писать в общий том — Vector автоматически подхватит файлы из него.
- В
.envпроверьте параметры общего тома и пути:
PIPELINE_EXTERNAL_LOGS_VOLUME_NAME=cyberlog_external_logs
PIPELINE_EXTERNAL_LOGS_DIR=/app/shared/external
PIPELINE_EXTERNAL_APPEND_FILE=/app/shared/external/external_stream.log- В своей программе:
- смонтируйте тот же Docker-том (например, в
/var/log/goldenили/data/external) - пишите логи в
.logили.txt(append-only), чтобы Vector прочитал их из общего тома
Альтернатива: отправляйте логи через Push API: POST /api/pipeline/logs/upload или POST /api/pipeline/logs/text. Подробности: log_ai_agent/pipeline/README_INGEST_API.md.