all repos — zion-terminal @ main

dotfiles

opt/zion-terminal/docs/README.md (view raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
# ZION TERMINAL

Cyberdeck criado por Pablo Murad em 2026.

Terminal portátil dedicado à administração de infraestrutura, construído sobre uma
**Orange Pi CM4** (Rockchip RK3566, Debian 12). Não é um desktop de uso geral: é um
**field terminal** — rápido, enxuto, confiável e com identidade própria.

## Objetivo

Acessar servidores por SSH, administrar a rede Tailscale, diagnosticar rede,
acompanhar CPU/RAM/disco/temperatura, executar manutenção, usar Git e manter
sessões persistentes — tudo em terminal, em português, com baixo consumo.

## Hardware

- Orange Pi CM4 — Rockchip RK3566, 4× Cortex-A55 @1.8GHz, 8 GB RAM, arm64.
- Tela local 400×1280 (girada para paisagem via `fbcon=rotate:1`).
- Rede: Ethernet + Tailscale (VPN essencial). Wi-Fi desligado.

## Comandos principais

| Comando | O que faz |
|---------|-----------|
| `zion` | Abre o painel (dashboard) |
| `zion status` | Resumo rápido (CPU/RAM/disco/temp/rede/Tailscale) |
| `zion saude` | Saúde detalhada com níveis normal/atenção/crítico |
| `zion rede` | Diagnóstico de rede |
| `zion tailscale` | Estado e diagnóstico do Tailscale |
| `zion ssh` | Menu de servidores (lê `~/.ssh/config`) |
| `zion doctor` | Autoteste (POST) verde/vermelho |
| `zion radar` / `zion mapa` | Latência dos peers / topologia do tailnet |
| `zion panico` | War-room: painéis tmux de monitoramento |
| `zion qr` | QR code de acesso para o celular |
| `zion manual` | Manual de campo offline |
| `zion anotar "nota"` | Logbook de operações |
| `zion servir [dir]` | Compartilha arquivos só no Tailscale |
| `zion travar` | Trava o terminal (vlock) |
| `zion observar HOST` | Monitora um host remoto via SSH |
| `zion tema [ice/amber/green]` | Troca o tema de cores |
| `zion matrix` | Chuva digital (Matrix) |
| `zion atualizar` / `zion backup` / `zion logs` / `zion info` | Manutenção |
| `zion desligar` / `zion reiniciar` | Energia (com confirmação) |

Aliases: `zz zstatus znet ztail zssh zlogs zupdate ztemp zdisco zservicos ztmux zmatrix zdoctor`.

Digite `zion --help` para a lista completa.

## Estrutura

```
/opt/zion-terminal/
├── bin/       comandos e biblioteca (zion-*, zion-lib.sh)
├── config/    tema, ssh_config, tmux.conf, bashrc-zion.sh
├── assets/    banners ASCII, tmux-resurrect
├── docs/      esta documentação
├── logs/      logs do ZION + metricas.csv (ring-buffer)
├── backups/   backups datados
└── VERSION / CREATOR
```

## Manutenção, backup e recuperação

- Atualizar: `zion atualizar` (kernel/BSP ficam em *hold*, não são tocados).
- Backup: `zion backup` (sem chaves privadas por padrão) → `/opt/zion-terminal/backups/`.
- Restaurar: `zion backup --restaurar <arquivo>`.
- Remover tudo: `sudo /opt/zion-terminal/bin/zion-uninstall` (restaura MOTD/PAM/shell).

Veja também: `comandos.md`, `tailscale.md`, `ssh.md`, `tmux.md`, `motd.md`,
`backup.md`, `restauracao.md`, `seguranca.md`, `solucao-de-problemas.md`,
`otimizacoes-boot.md`, `alteracoes-realizadas.md`, `relatorio-final.md`.