Tutoriais de VPS
NetBox na VPS: inventário, Docker, HTTPS e recuperação
Implante NetBox com template Docker coerente, banco e filas privados. Configure inventário, permissões, tokens, SMTP e recuperação testada de banco e arquivos.

NetBox relaciona sites, tenants, racks, equipamentos, interfaces, VLANs, prefixos IP e histórico numa interface/API comum. Substitui planilhas dispersas para laboratórios, escritórios, VPSs e equipes de rede. Registra infraestrutura planejada; não descobre nem aplica automaticamente toda configuração.
Este guia Ubuntu 24.04/Docker cobre banco, fila/cache compatível com Redis, HTTPS, permissões, tarefas e recuperação. Teste num domínio separado antes de inserir inventário real.
| Escopo | CPU | RAM | Disco | Nota |
|---|---|---|---|---|
| Laboratório | 2 vCPU | 4 GB | 40 GB SSD | Poucos equipamentos/plugins |
| Equipe pequena | 4 vCPU | 8 GB | 80 GB NVMe | SMTP e backups independentes |
| Vários sites | 4-8 vCPU | 16 GB+ | 160 GB NVMe+ | Monitorar crescimento/separar banco |
Configure A/AAAA de netbox.example.com. Mantenha 5432/6379 privadas e conte logs, mídia e backups no planejamento. São referências, sem garantias.
sudo apt update
sudo apt install -y ca-certificates curl git openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/netbox
sudo chown -R "$USER":"$USER" /opt/netbox
cd /opt/netbox
Revise instalador privilegiado ou use pacotes suportados. Evite latest; fixe aplicação, banco, cache e plugins compatíveis com digests.
git clone https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
cp env/netbox.env .env
Selecione commit de release revisado e confira ls/git log -1. O template revisado em 16 de novembro de 2026 usa NetBox v4.7-5.1.2, PostgreSQL 18 e Valkey separado para fila/cache com nomes redis. Preserve estrutura/armazenamento dessa release, sem misturar exemplos antigos. Veja netbox-docker.
A cópia .env não vira automaticamente env_file. O template lê env/netbox.env, env/postgres.env, env/redis.env e env/redis-cache.env: edite esses arquivos. .env raiz interpola VERSION e variáveis Compose. Proteja todos os segredos fora do Git.
Esboço original das variáveis:
DB_NAME=netbox
DB_USER=netbox
DB_PASSWORD=change-a-long-database-password
REDIS_PASSWORD=change-a-long-redis-password
SECRET_KEY=replace-with-a-random-secret-key
SUPERUSER_NAME=admin
[email protected]
SUPERUSER_PASSWORD=change-a-long-admin-password
Gere valores independentes:
openssl rand -base64 48
openssl rand -hex 32
chmod 600 .env
Combine DB_PASSWORD/POSTGRES_PASSWORD em aplicação/banco, REDIS_PASSWORD em aplicação/fila e outro par REDIS_CACHE_PASSWORD/REDIS_PASSWORD para redis-cache. Substitua SECRET_KEY e peppers de tokens atuais por valores privados estáveis. Defina hostname, origem HTTPS e CORS restritivo; remova senhas padrão e CORS global. Use createsuperuser interativo: SKIP_SUPERUSER=true no template atual impede criação automática só pelas variáveis SUPERUSER.
Crie docker-compose.override.yml raiz para Caddy do host:
services:
netbox:
ports:
- "127.0.0.1:8080:8080"
O override oficial de exemplo publica 8000 amplamente; não copie sem ajustes para proxy 8080. Fixe imagens e confira configuração mesclada:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
Config renderizado pode revelar segredos: inspecione em privado ou use config --quiet só para sintaxe. Aguarde inicialização/migração e confira netbox, netbox-worker, netbox-housekeeping se existir, postgres e redis:
docker compose logs --tail=200 netbox
docker compose logs --tail=200 netbox-worker
docker compose logs --tail=200 postgres
Em reinícios, confira env reais além de .env e valide SECRET_KEY. Não apague volumes.
docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser
docker compose exec netbox /opt/netbox/netbox/manage.py check
- Crie sites para datacenters, escritórios e regiões cloud.
- Crie tenants para atribuir propriedade; o rótulo não isola acesso automaticamente.
- Padronize fabricantes, tipos, papéis e plataformas.
- Modele prefixos, faixas, VLANs e VRFs com propriedade clara.
- Registre racks, dispositivos, interfaces, enlaces e energia.
Mapeie primeiro um site e confira relações antes de importar CSV/API completo.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
netbox.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:8080
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://netbox.example.com
Uma entrada deve ocupar 80/443. Teste DNS/renovação e use HSTS/includeSubDomains só com HTTPS nos domínios cobertos. Veja Caddy. Para CSRF/Host/redirects, confira ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS e protocolo do proxy confiável.
Teste e-mail interno antes de convidar a equipe. Configure SPF/DKIM/DMARC com provedor e confira relógio, DNS, TLS, portas e restrições de saída.
- Administradores gerenciam equipamentos/interfaces/prefixos/VLANs necessários.
- Auditores só leem objetos e histórico.
- Automação usa usuário/token próprio, sem reutilizar administrador.
- Integrações recebem permissões por objeto, expiração suportada e rotação.
Teste cada papel: tenant não equivale a permissão. Use HTTPS e armazenamento de segredos para Ansible/Terraform/CMDB/monitoramento, sem tokens no histórico ou logs CI.
Web, worker e agendamento de manutenção aplicável precisam funcionar. O diagnóstico original inclui serviço housekeeping antigo:
docker compose ps
docker compose logs --tail=200 netbox-worker
docker compose logs --tail=200 netbox-housekeeping
Confira config --services: o template atual não tem netbox-housekeeping. Execute essa linha somente se sua versão o define e configure manutenção/tarefas conforme a release. Confirme que um trabalho real termina.
Para imports/e-mails pendentes, confira fila, OOM e locks. Não esvazie tarefas; monitore tendências de memória/disco.
Inclua PostgreSQL, media, scripts/relatórios, plugins, env reais, .env, Compose, chaves/peppers e digests. O esboço original exige parar escritas e tratar falhas:
mkdir -p /opt/netbox/backups
docker compose exec -T postgres pg_dump -U "$DB_USER" "$DB_NAME" | gzip > /opt/netbox/backups/netbox-$(date +%F).sql.gz
docker compose cp netbox:/opt/netbox/netbox/media /opt/netbox/backups/media-$(date +%F)
cp .env docker-compose.yml /opt/netbox/backups/
docker compose config > /opt/netbox/backups/compose-$(date +%F).yaml
.env não é exportado automaticamente ao shell. Use valores conhecidos ou ambiente do contêiner PostgreSQL. Aplique pipefail, nomes únicos, permissões privadas e verificação gzip/hash; não aceite dump vazio. Inclua todos os env/configuração e o nome Compose real. Pare escritas web/worker ao alinhar banco/mídia; reinicie deliberadamente depois de validar.
Guarde backups externos criptografados e teste restauração. Num projeto isolado da mesma versão, desative notificações/automação externa, restaure banco/arquivos e confira migração, login, inventário, API, anexos e tarefas.
- Registre commit, digests, plugins e
docker compose configprivado. - Valide backup consistente de banco/mídia/configuração.
- Teste release e plugins compatíveis em isolamento.
- Pare escritas, atualize e aplique
manage.py migratecorrespondente. - Teste interface, API, busca, permissões, arquivos e tarefas antes de abrir acesso.
git fetch --tags
git checkout <tested-commit>
docker compose pull
docker compose up -d
docker compose exec netbox /opt/netbox/netbox/manage.py migrate
docker compose exec netbox /opt/netbox/netbox/manage.py check
Não conecte aplicação antiga a banco migrado. Restaure versão, banco, mídia e configuração anteriores e valide antes de mudar proxy/DNS.
Confira docker compose ps, logs e 8080 privada. Preserve postgres/redis ou altere todas as referências.
Valide ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS e X-Forwarded-Proto: https do proxy confiável.
Meça CPU/RAM/I/O do banco e fila, reduza lotes e confira índices/plugins. Evite reconstrução completa em picos.
Confira WAL, logs, mídia, imagens e backups. Valide cópia externa antes de excluir; preserve anexos únicos e recuperação.
- Aplicação, banco, fila/cache e worker saudáveis; manutenção realmente executada.
- HTTPS, renovação,
ALLOWED_HOSTSe CSRF testados. - Papéis mínimos e tokens funcionam; exija MFA com provedor de identidade ou integração compatível verificada.
- SMTP, reset e notificações chegam a conta de teste.
- Banco, mídia,
.env, env/configuração e plugins têm backup externo. - Restauração isolada documentada e testada.
- Versões fixadas; API/busca/arquivos/tarefas conferidos após atualizar.
Modele um site confiável e depois amplie automação.
Leituras: