Lucas RayanandClaude Sonnet 5
8a80504c45
Release / Plan (reuse the published image?) (push) Successful in 3s
CI / Docker image (build and smoke test) (push) Skipped
CI / Format and clippy (push) Successful in 4m32s
CI / Dependency audit (push) Successful in 11s
CI / Tests (Linux) (push) Successful in 9m15s
Release / ci (push) Successful in 9m18s
Release / Build image (arm64) (push) Failing after 7m7s
Release / Build image (amd64) (push) Failing after 13m53s
Release / Publish tags (push) Skipped
Release / Gitea release (push) Skipped
Acaua is a collective SOC daemon consuming only Zeek log files, not a single-user tool needing local hardware like its siblings. Drop the Tauri desktop shell, installers and self-update entirely; the server and its web dashboard ship as a container, updated by pulling a new image tag. Link against the official prebuilt libduckdb instead of compiling it from source via the bundled feature, cutting image build time from 15+ minutes to about 3. Fix a real bug found along the way: as PID 1 in a container, the daemon ignored SIGTERM and was always killed after the stop timeout; it now shuts down gracefully. Also corrects the Pillar 1 beaconing score: the period estimate had a harmonic alias (a perfectly periodic 4h series resolved to 600s), and the old score formula flagged pure random traffic as suspicious (p95 = 0.839 on Poisson noise). The new formula was validated against 300 samples per scenario. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VAyr8d7HuAdUGB6aA5xmDD
2.3 KiB
2.3 KiB
Terminal
English · Português
O binário acaua atua tanto como utilitário de linha de comando quanto como daemon de segundo plano.
Esta página descreve os comandos disponíveis no motor.
acaua <command> [options]
Comandos:
serve Inicia a API e o dashboard web embutido
analyze Analisa um diretório de logs do Zeek
doctor Verifica o ambiente local
update Checa por releases disponíveis
acaua serve
Inicia a API HTTP e o dashboard web embutido.
acaua serve --bind 127.0.0.1:8787 --data-dir .acaua
| Opção | Padrão | Significado |
|---|---|---|
--bind |
127.0.0.1:8787 |
Endereço de escuta |
--data-dir |
.acaua |
Diretório de dados e arquivos de execução |
O bind padrão restringe-se a loopback. Expô-lo em uma rede exige um proxy reverso com autenticação. A API está documentada em arquitetura.md.
acaua analyze
acaua analyze /var/log/zeek/current
acaua analyze /var/log/zeek/current --json
Valida o diretório alvo, ingere tráfego do conn.log em partições Parquet e
executa os algoritmos de detecção de ameaças.
acaua doctor
acaua doctor
acaua doctor --json
Executa checagens de ambiente:
zeek: verificazeek --versionou detecta execução em container (ACAUA_RUNTIME=container).curl: confirma disponibilidade de download HTTP.duckdb: confirma linkagem dinâmica contra alibduckdb.soem tempo de execução.research: valida o isolamento do workspace de pesquisa.
acaua update
acaua update
Consulta a API de Releases do Gitea, compara a última tag com a versão em
execução e imprime instruções de atualização (docker compose pull && docker compose up -d
quando em container).
Códigos de saída
| Código | Significado |
|---|---|
0 |
Sucesso |
1 |
Erro em tempo de execução (caminho inválido, erro de consulta, I/O) |
2 |
Uso inválido de linha de comando (clap) |
Ambiente
| Variável | Significado |
|---|---|
ACAUA_RUNTIME |
Definida como container em imagens Docker para adaptar checagens |
DUCKDB_LIB_DIR |
Caminho do diretório contendo libduckdb.so em compilação nativa |
LD_LIBRARY_PATH |
Caminho de busca de bibliotecas compartilhadas para libduckdb.so |