refactor: distribute Acaua as a Docker image instead of a desktop app
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
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
This commit is contained in:
1 parent
1b974bb90d
commit
8a80504c45
72 files changed
+2524
-6384
No files matched your search
+19
-29
@@ -2,46 +2,36 @@
|
||||
|
||||
[English](../support.md) · **Português**
|
||||
|
||||
O Acauã é pré-alfa. Não há contrato de suporte nem binário publicado ainda. O
|
||||
caminho mais rápido para obter ajuda é uma issue objetiva no repositório Gitea.
|
||||
O Acauã é distribuído como um motor de NDR containerizado. A forma mais rápida de
|
||||
obter assistência é abrir uma issue no repositório do Gitea.
|
||||
|
||||
## Antes de abrir uma issue
|
||||
|
||||
1. Rode `acaua doctor --json` e guarde a saída.
|
||||
1. Execute `acaua doctor --json` dentro do container (`docker exec acaua acaua doctor --json`) ou no host.
|
||||
2. Confirme a versão com `acaua --version`.
|
||||
3. Tente a menor entrada que reproduz o problema.
|
||||
4. Leia os [limites conhecidos](../../README.pt-BR.md#limites-conhecidos) e a
|
||||
[arquitetura](arquitetura.md).
|
||||
3. Tente reproduzir o problema com a menor captura de logs Zeek possível.
|
||||
4. Revise os [limites conhecidos](../../README.pt-BR.md#limites-conhecidos) e a [arquitetura](arquitetura.md).
|
||||
|
||||
## O que incluir
|
||||
|
||||
- Sistema operacional, arquitetura e versão do Acauã.
|
||||
- O comando exato e a saída completa do terminal.
|
||||
- Se a entrada é diretório de logs Zeek, fixture sintética ou captura.
|
||||
- Para problema de UI: build de navegador ou desktop, idioma e tema.
|
||||
- Para problema de atualização: saída de `acaua update` e se `curl` e `tar` estão
|
||||
no `PATH`.
|
||||
- Sistema operacional do host, arquitetura (`uname -m`) e versão/tag do Acauã.
|
||||
- O comando exato ou definição do Docker Compose.
|
||||
- Logs completos do container (`docker compose logs acaua`).
|
||||
- Amostras anonimizadas de logs Zeek que demonstrem a falha.
|
||||
|
||||
Não anexe capturas de produção nem credenciais. Redija endereços, hostnames e
|
||||
payloads antes de compartilhar.
|
||||
Não anexe capturas de tráfego de produção nem credenciais. Anonimize endereços IP,
|
||||
hostnames e payloads sensíveis antes de compartilhar.
|
||||
|
||||
## Problemas de segurança
|
||||
## Questões de segurança
|
||||
|
||||
Não inclua detalhes de exploração em issue pública. Siga o
|
||||
[SECURITY.pt-BR.md](../../SECURITY.pt-BR.md) e peça um canal privado primeiro.
|
||||
Não inclua detalhes de exploração em uma issue pública. Siga a política em
|
||||
[SECURITY.pt-BR.md](../../SECURITY.pt-BR.md) e solicite um canal privado de comunicação.
|
||||
|
||||
## Situações comuns
|
||||
|
||||
| Sintoma | O que checar |
|
||||
| Sintoma | O que verificar |
|
||||
|---|---|
|
||||
| `analyze` devolve zero registros | Esperado em `0.1.0`; o parser é stub |
|
||||
| `serve` inacessível de outra máquina | Ele escuta em loopback por padrão |
|
||||
| `update` falha | `curl`, `tar`, permissão de escrita e assets da release |
|
||||
| Build do desktop falha | Dependências de sistema do Tauri para a plataforma |
|
||||
| UI aparece em português | `Auto` segue o idioma do sistema; escolha English nas configurações |
|
||||
|
||||
## Escopo
|
||||
|
||||
O suporte cobre o código e a documentação do Acauã. Não cobre configuração de
|
||||
Zeek ou Suricata, legalidade de captura de rede ou pacotes de distribuição de
|
||||
terceiros. Use somente em redes próprias ou com autorização para monitorar.
|
||||
| Container não sobe | Confirme linkagem de `libduckdb.so` via `docker logs` e verifique permissões nos volumes nomeados |
|
||||
| `serve` inacessível a partir de outro host | O serviço escuta em loopback (`127.0.0.1:8787`) por padrão; verifique o proxy reverso |
|
||||
| `update` falha | Verifique conectividade de rede com a API de Releases do Gitea ou permissões de pull do registry |
|
||||
| UI web exibe português | `Auto` segue o idioma do navegador; escolha inglês nas configurações |
|
||||
Reference in new issue
Block a user