Cerebro Studio · Backlog · Changelog
Cerebro • /root/cerebro/docs/changelog/2026/CL-2026-03-11-BK-118.md • 2026-03-11T15:06:58.572Z

CL-2026-03-11-BK-118 · Aviso operacional sobre o Nginx do Ubuntu vs aaPanel

  • Status: (V) conferido e aprovado
  • Escopo: plataforma
  • Projetos afetados: cerebro, legalizarj, rionoteatro, seuimovel
  • BK relacionado: BK-118
  • Aprovacao humana obrigatoria: nao
  • Data: 2026-03-11
  • Autor: Codex (GeJoRei-VPS)
  • revisor_ia: auto-revisao

Resumo

Foi adicionado um aviso operacional explicito no topo de /etc/nginx/nginx.conf para evitar novos erros de administracao na VPS. O host possui um Nginx de pacote Ubuntu e um Nginx do aaPanel; hoje, o trafego real dos sites esta no stack do aaPanel. O comentario deixa claro que o arquivo do Ubuntu nao deve ser tratado como proxy principal dos projetos e aponta o comando correto para validar o Nginx realmente ativo.

Contexto

  • A investigacao do BK-117 mostrou que nginx -t no binario Ubuntu podia induzir programadores a conclusoes erradas sobre o proxy em producao.
  • O processo efetivamente escutando 80/443 no host seguia sendo /www/server/nginx/sbin/nginx -c /www/server/nginx/conf/nginx.conf.
  • O host ainda possui a unit nginx.service do Ubuntu, o que aumenta o risco de um operador usar systemctl restart nginx esperando controlar o proxy ativo dos sites.

Entregas Tecnicas

  • Inserido cabecalho de governanca em /etc/nginx/nginx.conf com:
  • identificacao do Nginx do Ubuntu como caminho administrativo, nao como proxy principal;
  • referencia ao binario/configuracao do aaPanel usados em producao;
  • alerta para nao usar systemctl start|restart nginx como correcao de site sem BK/plano de migracao.
  • Mantida a configuracao funcional do arquivo; nenhuma diretiva ativa foi alterada.

Validacao objetiva

  • nginx -t permaneceu com syntax is ok e test is successful.
  • /www/server/nginx/sbin/nginx -t -c /www/server/nginx/conf/nginx.conf permaneceu valido.

Backup e rollback

  • Backup versionado em /root/cerebro/backups/system/2026-03-11-bk118-nginx-governance-notice/.
  • Rollback em /root/cerebro/backups/system/2026-03-11-bk118-nginx-governance-notice/rollback.sh.

Risco residual

  • O comentario reduz o erro humano, mas nao elimina a duplicidade estrutural entre o Nginx do Ubuntu e o Nginx do aaPanel.
  • A decisao de manter, neutralizar ou remover o Nginx do Ubuntu deve ser tratada em BK proprio, com auditoria de dependencias e janela controlada.