DocumentaçãoRODAR UM NÓ DE FEDERAÇÃO

RODAR UM NÓ DE FEDERAÇÃO

Opere um nó soberano.

Um nó de federação participa do gossip de imunidade entre dispositivos sem nunca ver dados brutos do usuário. Opcional — mas quanto mais nós, mais descentralizada a rede.

01

O que um nó faz

Um nó recebe difusões de padrões hasheados de dispositivos em sua região, executa o protocolo de quórum com nós pares e retransmite os padrões confirmados aos dispositivos conectados. Ele nunca recebe nem armazena qualquer coisa que identifique um usuário.

Privacidade por construção
A camada de protocolo carrega apenas hashes SHA-256 e faixas amplas de região. Não há caminho de código para um nó receber um IP, um e-mail ou uma coordenada de GPS. Isso é imposto por um teste automatizado que falha o build se a fronteira for violada.
02

Requisitos de hardware

Um nó é um daemon Rust mais uma instância PostgreSQL 16. Mínimo:

  • 4 vCPU, 16 GB de RAM, 200 GB de SSD
  • Conectividade confiável, porta pública alcançável (8443 por padrão)
  • YubiHSM 2 ou equivalente para a chave de identidade de par (recomendado)
  • Sincronizado por tempo (NTP) — o protocolo de quórum é sensível a desvio de relógio
03

Instalar

shell# 1. PostgreSQL 16 (skipped if you already have one)
sudo apt-get install -y postgresql-16

# 2. The federation daemon
curl -L -o lydos-fed-2026.06.r1.tar.gz \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/lydos-fed.tar.gz
curl -L -o release.manifest.json \
  https://git.lydos.ailydian.com/lydos/sovereign-federation/releases/2026.06.r1/release.manifest.json

# 3. Verify the bundle (the same protocol as the phone image)
./verify-bundle.sh --bundle lydos-fed-2026.06.r1.tar.gz --manifest release.manifest.json
# expects: signatures 3 / 3, hash match

# 4. Install
sudo tar -xzf lydos-fed-2026.06.r1.tar.gz -C /opt/lydos-fed
sudo /opt/lydos-fed/install.sh
04

Cerimônia da chave de identidade de par

A chave de identidade de par do nó assina toda difusão que ele emite. Gere-a dentro do YubiHSM sob uma cerimônia de oficiais M-de-N. Três oficiais, dois entre três para assinar novas chaves. Documente a cerimônia em seu log interno.

shell/opt/lydos-fed/bin/lydos-fed key generate --hsm yubihsm \
  --slot 1 --label fed-peer-2026.06 \
  --officers 2-of-3
Aviso de chave quente
Não gere esta chave em uma estação de trabalho. A metade privada nunca deve aparecer em nenhuma memória de processo que você não controle. O HSM impõe isso.
05

Entrar no registro de pares

shell# Submit your node's public identity to the registry
/opt/lydos-fed/bin/lydos-fed join \
  --registry https://registry.lydos.ailydian.com \
  --pubkey-path /opt/lydos-fed/keys/fed-peer-2026.06.pub

O registro assina sua entrada e a retransmite. Outros nós entrarão em contato e completarão o handshake. A integração típica leva de 10 a 30 minutos.

06

Monitoramento

O daemon expõe métricas Prometheus em /metrics e um snapshot de saúde em JSON em /health. Integre ao seu dashboard existente ou consulte diretamente.

shellcurl https://your-node.example/health
# {
#   "version": "2026.06.r1",
#   "peers_online": "11/11",
#   "quorum": "ok",
#   "audit_chain_head": "3571a6c8…",
#   "uptime_seconds": 123456
# }
07

Backup e restauração

O volume do PostgreSQL é o único componente com estado que você precisa fazer backup. As chaves vivem no HSM e são reconstruíveis apenas por cerimônia. A configuração do daemon é reproduzível a partir de /etc/lydos-fed.

Restaurar é rápido
Um nó novo entra na federação, pede aos pares a cabeça atual da cadeia e se atualiza. A maior atualização que observamos em produção foi de 18 minutos, do início a frio até estar no quórum.