Tutoriales de VPS
NetBox en un VPS: inventario, Docker, HTTPS y recuperación
Despliega NetBox con plantilla Docker coherente, base y colas privadas. Configura inventario, permisos, tokens, SMTP y recuperación probada de base y archivos.

NetBox relaciona sitios, tenants, racks, equipos, interfaces, VLAN, prefijos IP e historial mediante una interfaz y API comunes. Sustituye hojas dispersas para laboratorios, oficinas, VPS y equipos de red. Documenta infraestructura prevista; no descubre ni aplica automáticamente toda configuración.
Esta guía Ubuntu 24.04/Docker cubre base, cola/caché compatible Redis, HTTPS, permisos, tareas y recuperación. Ensaya en dominio de prueba antes de introducir inventario real.
| Ámbito | CPU | RAM | Disco | Nota |
|---|---|---|---|---|
| Laboratorio | 2 vCPU | 4 GB | 40 GB SSD | Pocos equipos y plugins |
| Equipo pequeño | 4 vCPU | 8 GB | 80 GB NVMe | SMTP y copias independientes |
| Varios sitios | 4-8 vCPU | 16 GB+ | 160 GB NVMe+ | Vigilar crecimiento/separar base |
Configura A/AAAA para netbox.example.com. Deja 5432/6379 privados y cuenta logs, medios y copias en capacidad. Son referencias, sin garantías.
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
Revisa instalador privilegiado o usa paquetes soportados. Evita latest; fija aplicación, base, caché y plugins compatibles con digests.
git clone https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
cp env/netbox.env .env
Selecciona un commit de release revisado y consulta ls/git log -1. La plantilla revisada el 16 de noviembre de 2026 usa NetBox v4.7-5.1.2, PostgreSQL 18 y Valkey separado para cola/caché con nombres redis. Conserva estructura/almacenamiento de esa release, sin mezclar fragmentos antiguos. Consulta netbox-docker.
La copia .env no se convierte automáticamente en env_file. La plantilla lee env/netbox.env, env/postgres.env, env/redis.env y env/redis-cache.env: modifica esos archivos. .env raíz interpola VERSION y variables de Compose. Protege todos los secretos fuera de Git.
Esquema original de variables:
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
Genera valores independientes:
openssl rand -base64 48
openssl rand -hex 32
chmod 600 .env
Coordina DB_PASSWORD/POSTGRES_PASSWORD en aplicación/base, REDIS_PASSWORD en aplicación/cola y otro par REDIS_CACHE_PASSWORD/REDIS_PASSWORD para redis-cache. Sustituye SECRET_KEY y peppers de tokens actuales por valores privados estables. Define hostname, origen HTTPS y CORS restrictivo; elimina contraseñas de ejemplo y CORS global. Usa createsuperuser interactivo: SKIP_SUPERUSER=true en plantilla actual impide creación automática solo por SUPERUSER variables.
Crea docker-compose.override.yml raíz para Caddy del host:
services:
netbox:
ports:
- "127.0.0.1:8080:8080"
El override oficial de ejemplo publica 8000 ampliamente; no lo copies sin cambios para proxy 8080. Fija imágenes y revisa configuración combinada:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
Config renderizado puede revelar secretos: inspecciona en privado o usa config --quiet solo para sintaxis. Espera inicialización/migración y revisa netbox, netbox-worker, netbox-housekeeping si existe, postgres y redis:
docker compose logs --tail=200 netbox
docker compose logs --tail=200 netbox-worker
docker compose logs --tail=200 postgres
Si reinicia, revisa env reales además de .env y comprueba SECRET_KEY. No borres volúmenes.
docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser
docker compose exec netbox /opt/netbox/netbox/manage.py check
- Crea sitios para centros de datos, oficinas y regiones cloud.
- Crea tenants para atribuir propiedad; la etiqueta no aísla acceso automáticamente.
- Unifica fabricantes, tipos, roles y plataformas.
- Modela prefijos, rangos, VLAN y VRF con propiedad clara.
- Registra racks, dispositivos, interfaces, enlaces y alimentación.
Mapea primero un sitio y verifica relaciones 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
Una entrada debe ocupar 80/443. Verifica DNS/renovación y usa HSTS/includeSubDomains solo con HTTPS en dominios cubiertos. Consulta Caddy. Para CSRF/Host/redirects, revisa ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS y protocolo del proxy confiable.
Prueba correo interno antes de invitar al equipo. Configura SPF/DKIM/DMARC con proveedor y revisa reloj, DNS, TLS, puertos y restricciones de salida.
- Administradores gestionan equipos/interfaces/prefijos/VLAN necesarios.
- Auditores solo leen objetos e historial.
- Automatización usa usuario/token propio, sin reutilizar administrador.
- Integraciones reciben permisos por objeto, caducidad admitida y rotación.
Prueba cada rol: tenant no equivale a permiso. Usa HTTPS y almacén de secretos para Ansible/Terraform/CMDB/monitorización, sin tokens en historial o logs CI.
Web, worker y programación de mantenimiento aplicable deben funcionar. El diagnóstico original incluye servicio housekeeping antiguo:
docker compose ps
docker compose logs --tail=200 netbox-worker
docker compose logs --tail=200 netbox-housekeeping
Consulta config --services: la plantilla actual no tiene netbox-housekeeping. Ejecuta esa línea solo si tu versión lo define y configura mantenimiento/tareas según la release. Comprueba que un trabajo real termine.
Para imports/correos pendientes, revisa cola, OOM y bloqueos. No vacíes tareas; monitoriza tendencias de memoria/disco.
Incluye PostgreSQL, media, scripts/reportes, plugins, env reales, .env, Compose, claves/peppers y digests. El esquema original requiere parar escrituras y controlar errores:
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 no se exporta automáticamente al shell. Usa valores conocidos o entorno del contenedor PostgreSQL. Aplica pipefail, nombres únicos, permisos privados y comprobación gzip/hash; no aceptes dump vacío. Incluye todos los env/configuración y el nombre Compose real. Detén escrituras web/worker mientras alineas base y medios; reinicia deliberadamente al validar.
Guarda copias externas cifradas y prueba restauración. En proyecto aislado de igual versión, desactiva notificaciones/automatización externa, restaura base/archivos y verifica migración, login, inventario, API, adjuntos y tareas.
- Registra commit, digests, plugins y
docker compose configprivado. - Valida copia consistente de base/medios/configuración.
- Ensaya release y plugins compatibles en aislamiento.
- Detén escrituras, actualiza y aplica
manage.py migratecorrespondiente. - Prueba interfaz, API, búsquedas, permisos, archivos y tareas antes de abrir acceso.
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
No conectes aplicación antigua a base migrada. Restaura versión, base, medios y configuración previos y valida antes de cambiar proxy/DNS.
Revisa docker compose ps, logs y 8080 privado. Conserva postgres/redis o cambia todas sus referencias.
Verifica ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS y X-Forwarded-Proto: https desde proxy confiable.
Mide CPU/RAM/I/O de base y cola, reduce lotes y revisa índices/plugins. Evita reconstrucción completa en horas pico.
Revisa WAL, logs, medios, imágenes y backups. Valida copia externa antes de borrar; conserva adjuntos únicos y recuperación.
- Aplicación, base, cola/caché y worker sanos; mantenimiento realmente ejecutado.
- HTTPS, renovación,
ALLOWED_HOSTSy CSRF probados. - Roles mínimos y tokens funcionan; exige MFA con proveedor de identidad o integración compatible verificada.
- SMTP, reset y notificaciones llegan a una cuenta de prueba.
- Base, medios,
.env, env/configuración y plugins tienen copia externa. - Restauración aislada documentada y probada.
- Versiones fijadas; API/búsquedas/archivos/tareas comprobados tras actualizar.
Modela un sitio fiable y después amplía automatización.
Lecturas: