Implant Documentação 8de3f8d

implant check

Verifica conformidade do servidor e opcionalmente corrige problemas encontrados.

Uso 

implant check [OPTIONS]

Flags Especificas

Flag Descricao Padrao
-a, --auto-fix Corrigir problemas automaticamente —
--modules <M> Executar modulos especificos (separados por virgula) todos
--harden-network Aplicar tambem o pack estendido de hardening de rede (IPv6 + SYN flood + TIME_WAIT). Requer --auto-fix; sem ele e ignorado com aviso —
--timezone <TZ> Timezone para configurar no servidor America/Sao_Paulo
--locale <LOCALE> Locale do sistema (ex: pt_BR, en_US). Se omitido, deriva do timezone —
--cluster-mode <MODO> Modo de instalacao: docker (standalone) ou k3s (cluster) docker
--cluster-role <PAPEL> Papel do no no cluster K3s: server ou agent —
--cluster-token <TOKEN> Token para conectar ao cluster K3s (env: K3S_TOKEN) —
--cluster-url <URL> URL do servidor K3s para agents se conectarem (env: K3S_URL) —
--install-node Instalar Node.js via NVM para Claude Code. Requer --auto-fix; sem ele e ignorado com aviso —
--node-version <VER> Versao do Node.js para instalar 20
--install-claude-code Instalar Claude Code automaticamente apos Node.js —

Flags Globais

Estas flags estao disponiveis em todos os comandos do Implant:

Flag Descricao Padrao
-t, --token <TOKEN> Token de identificacao do servidor (env: PROTOCOLO_TOKEN) —
-v, --verbose Modo verbose (mais detalhes) —
--dry-run Modo dry-run (simula execucao sem aplicar mudancas) —
-c, --config <ARQUIVO> Arquivo de configuracao /etc/protocolo-implant/config.toml
-o, --output <FORMATO> Formato de saida: human, json, yaml human

Exemplos

Verificar sem corrigir 

implant check

Sem --auto-fix o check e estritamente leitura em todos os modulos: nada e instalado, baixado ou gravado no host.

Preview das correcoes 

implant check --auto-fix --dry-run

Aplicar correcoes 

implant check --auto-fix

Modulo especifico 

implant check --auto-fix --modules docker

Multiplos modulos 

implant check --auto-fix --modules fundamentals,hardening

Configurar timezone e locale 

implant check --auto-fix --timezone Europe/London --locale en_US

Incluir o pack estendido de hardening de rede 

implant check --auto-fix --harden-network

Modo cluster K3s 

implant check --auto-fix --cluster-mode k3s --cluster-role server

Instalar Node.js e Claude Code 

implant check --auto-fix --install-node --node-version 20 --install-claude-code

Saida em JSON 

implant check --output json

Debug completo 

RUST_LOG=debug implant check --auto-fix --verbose

Modulos Disponiveis

Modulo Descricao
fundamentals SSH, NTP, timezone, locale, swap, limites
hardening Fail2Ban, kernel hardening, servicos
docker Docker Engine, Compose, networks, log limits
network Verificacoes de rede
monitoring Logrotate, journald
traefik Access log do Traefik: permissao dos arquivos/logrotate e query string fora do log (aliases: accesslog, traefik-accesslog)
agent Agent de controle remoto
nodejs Node.js (aliases: node)

Os modulos fundamentals, hardening, network e monitoring tambem aceitam os nomes em portugues (fundamentos, seguranca, rede, monitoramento). Sem --modules, o check roda fundamentals, hardening, docker, network, monitoring e traefik, mais a verificacao do agente de controle remoto quando instalado.

Relatorio

O comando gera um relatorio com:

  • Total de verificacoes
  • Aprovadas / Falhadas / Corrigidas / Puladas
  • Status por modulo
  • Detalhes de cada verificacao falhada
  • Nivel de risco (risk: high, medium ou low) nos itens que tem severidade definida (omitido nos demais)

Alguns itens so reportam e nao sao corrigidos pelo --auto-fix — por exemplo PasswordAuthentication yes e PermitRootLogin yes efetivos no SSH (Fail de risco alto).

Codigos de Saida

Codigo Significado
0 Sucesso (todas verificacoes passaram)
1 Erro (verificacoes falharam ou erro de execucao)