ZION TERMINAL

Meu setup de terminal para uma Orange Pi CM4 usada como cyberdeck de administração de infraestrutura. Não é um desktop: é um terminal dedicado a acessar servidores por SSH, operar pela rede Tailscale, diagnosticar rede e acompanhar os recursos da placa. Tudo em português, sem ambiente gráfico.

Roda em Debian 12 (bookworm) na Orange Pi CM4 (RK3566), mas a maior parte é bash puro e deve funcionar em qualquer Debian/Armbian recente.

Instalação

git clone https://github.com/runawaydevil/zion-terminal.git
cd zion-terminal
./install.sh

O install.sh copia o projeto para /opt/zion-terminal, instala o comando zion em /usr/local/bin, liga o MOTD e os aliases no shell, configura o tmux e habilita o timer de coleta de métricas. Ele pede sudo quando precisa e pode ser rodado de novo sem estragar nada.

Depois abra uma sessão nova (ou source ~/.bashrc) e digite zion.

Comandos

O comando central é zion. Sozinho abre o painel; com um subcomando executa uma função direta. Todos aceitam --help.

zion            painel interativo
zion status     resumo rápido (CPU, RAM, disco, temperatura, rede)
zion saude      saúde detalhada com estados OK/ATENÇÃO/CRÍTICO
zion doctor     autoteste (POST) do sistema
zion link       resumo de conectividade
zion rede       diagnóstico de rede
zion tailscale  estado e diagnóstico do Tailscale
zion radar      latência dos peers (direto x DERP)
zion mapa       topologia do tailnet
zion ssh        servidores (lê ~/.ssh/config, com favoritos)
zion modo       perfis: campo / manutencao / emergencia / normal
zion panico     war-room em tmux
zion tmux       sessão persistente
zion atualizar  atualização segura (kernel fica em hold)
zion backup     backup das configurações
zion qr         QR de acesso para o celular
zion manual     manual de campo offline
zion tema       troca o tema (ice / amber / green)
zion matrix     chuva digital

Aliases prontos: zz zstatus znet ztail zssh zdoctor zlink zmodo ztemp ztmux.

Estrutura

bin/zion                     comando principal (vai para /usr/local/bin)
opt/zion-terminal/
  bin/                       subcomandos zion-*
  lib/zion-ui.sh             biblioteca de interface (cabeçalhos, caixas, estados)
  config/                    tema, prompt (bashrc-zion.sh), tmux, ssh
  assets/ascii/              símbolo »Z» e a arte do logo
  docs/                      documentação
etc/profile.d/               MOTD e aliases no login
etc/systemd/system/          zion-collect (timer de métricas)

Temas e personalização

Três temas, trocáveis a quente com zion tema ice|amber|green. O tema vale para o prompt, o MOTD, o painel e a barra do tmux.

Para desligar coisas sem desinstalar:

touch ~/.zion-sem-prompt   # volta ao prompt padrão do bash
touch ~/.zion-sem-motd     # sem MOTD no login
touch ~/.zion-sem-tmux     # sem auto-resume do tmux no console local
export ZION_NO_ANIM=1      # sem animações
export NO_COLOR=1          # sem cores

O que não vai no repositório

Dados locais ficam de fora (ver .gitignore): logs, backups, favoritos de SSH, tema escolhido e o tmux-resurrect (clonado na instalação). O ~/.ssh/config e as chaves nunca entram aqui.

Desinstalação

./uninstall.sh --dry-run   # mostra o que seria removido
./uninstall.sh             # remove de verdade

Restaura o MOTD, o prompt e o tmux anteriores e tira os ganchos do shell. Preserva ~/.ssh/config, chaves e backups.