Criar o CT no Proxmox¶

Receita do container LXC onde o sistema roda. Os valores de VMID, storage, IP e gateway abaixo são exemplos: ajuste para a sua rede.

Requisitos¶

Item	Valor	Por quê
Sistema	Debian 12 (bookworm)	Ver ADR 0003
Tipo	LXC não privilegiado	Mais seguro
Features	`nesting=1,keyctl=1`	Obrigatório para Docker dentro do LXC
CPU / RAM	4 vCPU · 8 GB + 2 GB de swap	Web, worker SNMP e banco (ponto de partida)
Disco	80 GB	Banco, imagens Docker e backups locais
Rede	IP fixo	O proxy reverso aponta para ele
Início automático	`onboot 1`

Requisitos de rede: o CT precisa alcançar a gerência das OLTs (SNMP UDP 161, SSH 22 ou Telnet 23) e, a partir da F4, receber traps (UDP 162) e syslog (UDP 514). As OLTs precisam liberar o IP do CT: ver Acesso às OLTs.

1. Criar (shell do host Proxmox)¶

pveam update
pveam available | grep debian-12
pveam download local debian-12-standard_12.12-1_amd64.tar.zst   # use a versão listada

# Exemplo: VMID 200, storage local-lvm, IP 192.168.0.10
pct create 200 local:vztmpl/debian-12-standard_12.12-1_amd64.tar.zst \
  --hostname noc-ftth \
  --cores 4 --memory 8192 --swap 2048 \
  --rootfs local-lvm:80 \
  --net0 name=eth0,bridge=vmbr0,ip=192.168.0.10/24,gw=192.168.0.1 \
  --unprivileged 1 \
  --features nesting=1,keyctl=1 \
  --onboot 1

pct start 200
pct enter 200

2. Preparar o Debian 12 (dentro do CT)¶

apt update && apt full-upgrade -y

Se o upgrade perguntar sobre o sshd_config alterado, escolha manter a versão local. O template do Proxmox altera esse arquivo, e trocar pela versão do pacote pode bloquear o login do root por SSH.

apt install -y ca-certificates curl gnupg git ufw snmp
timedatectl set-timezone America/Sao_Paulo   # ajuste para o seu fuso

# Docker Engine + Compose (repositório oficial)
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian bookworm stable" \
  > /etc/apt/sources.list.d/docker.list
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
docker run --rm hello-world && docker compose version

# Firewall
ufw allow 22/tcp
ufw allow 80/tcp
ufw enable

Docker e ufw

Portas publicadas pelo Docker passam por fora do ufw. O sistema publica só a porta 80.

Firewall do Proxmox

Se o firewall do Proxmox estiver ativo para o CT, libere a entrada 22 e 80 também nas regras do CT.

3. Conferir¶

cat /etc/os-release | head -2                                   # Debian 12
docker compose version
snmpget -v2c -c COMMUNITY_LEITURA IP_DA_OLT 1.3.6.1.2.1.1.1.0   # descrição da OLT

Próximo passo: Instalação.