Tutoriales de VPS
Snipe-IT en un VPS: Docker, activos, acceso y recuperación
Despliega Snipe-IT con Docker, MariaDB y Caddy. Configura almacenamiento, APP_KEY, SMTP, importación y etiquetas QR; prueba permisos, scheduler y restauración antes de actualizar.

Snipe-IT organiza activos, licencias, accesorios, consumibles y asignaciones de equipos. Una instalación propia permite administrar etiquetas, adjuntos e historial de custodia, aunque sigues confiando en el proveedor del VPS. También debes mantener base, correo, tareas programadas, copias y actualizaciones.
Usaremos Ubuntu 24.04, Docker Compose, MariaDB y Caddy para un equipo pequeño. Fija una versión soportada y utiliza su plantilla de variables y requisitos de base correspondientes.
| Recurso | Laboratorio | Referencia para un equipo pequeño |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU o más |
| RAM | 2 GB | 4 GB o más |
| Disco | 30 GB SSD | 60 GB SSD o más |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Dominio | snipe.example.com | Subdominio de inventario |
Son referencias, sin garantía de capacidad. Importaciones, informes y adjuntos pueden superar las necesidades de la web. Revisa free -h, df -h y docker stats; consulta dimensionamiento. Configura A/AAAA funcionales y solo administración necesaria y 80/443 públicos. Mantén MariaDB privada; considera restringir todo el inventario a la VPN de la organización.
sudo apt update
sudo apt install -y ca-certificates curl openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/snipeit
sudo chown -R "$USER":"$USER" /opt/snipeit
cd /opt/snipeit
openssl rand -base64 32
Revisa el instalador ejecutado como root o usa paquetes soportados. El grupo Docker concede acceso potente al anfitrión. Usa contraseñas únicas. Para esta configuración Laravel, antepone base64: al valor Base64 de 32 bytes generado para APP_KEY; sustituye el marcador. Conserva esa clave en .env protegido y en las copias, sin regenerarla al recrear contenedores.
Docker secrets solo funciona si la imagen sabe leerlo; crear un secreto no sustituye automáticamente una variable de entorno.
Este esquema muestra puerto web privado y almacenamiento persistente. Comprueba base, imagen y healthcheck para la versión elegida:
services:
db:
image: mariadb:10.11
restart: unless-stopped
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_DATABASE: snipeit
MYSQL_USER: snipeit
MYSQL_PASSWORD: change-a-long-password
MYSQL_ROOT_PASSWORD: change-a-root-password
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 15
snipeit:
image: snipe/snipe-it:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
APP_ENV: production
APP_DEBUG: "false"
APP_KEY: base64:replace-with-a-generated-key
APP_URL: https://snipe.example.com
DB_HOST: db
DB_DATABASE: snipeit
DB_USERNAME: snipeit
DB_PASSWORD: change-a-long-password
MAIL_MAILER: smtp
ports:
- "127.0.0.1:8080:80"
volumes:
- snipeit_data:/var/lib/snipeit
volumes:
db_data:
snipeit_data:
Reemplaza credenciales y clave, fija imagen sin latest y usa la plantilla oficial de variables. Mantén APP_DEBUG=false. APP_URL es la URL HTTPS final; DB_HOST=db identifica el servicio, no localhost dentro del contenedor. El ejemplo oficial conserva /var/lib/snipeit: protege ese montaje real.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 snipeit
Comprueba nombres de servicios y procesos de inicio. Sigue inicialización, scheduler y colas de tu versión; una página disponible no demuestra funcionamiento de avisos. Protege la configuración expandida, que puede mostrar secretos.
ssh -L 8080:127.0.0.1:8080 root@SERVER_IP
Abre http://127.0.0.1:8080 por el túnel desde tu ordenador. El HTTP temporal no sustituye el dominio HTTPS al comprobar enlaces y cookies.
- Configura nombre, zona horaria y formato de fechas.
- Crea contraseña administrativa fuerte y MFA compatible.
- Define empresas, departamentos, ubicaciones y estados.
- Decide etiquetas, tratamiento de números de serie y tamaño de impresión.
- Crea usuarios normales y un rol de auditoría restringido.
- Limita tipos de adjuntos y tamaños de subida.
Mantén estables las etiquetas. Separa año de compra, categoría y secuencia donde convenga; distingue etiqueta, modelo y serie. Prueba una muestra antes de importar todo.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
snipe.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://snipe.example.com
Una puerta de entrada ocupa 80/443 y reenvía a 8080 privado. Configura APP_TRUSTED_PROXIES con la dirección real del proxy vista por el contenedor; no confíes en cabeceras de cualquier origen. Comprueba APP_URL y cookies HTTPS. HSTS/includeSubDomains exige HTTPS en los nombres afectados. Consulta Caddy.
- Usa remitente y nombre propios.
- Configura SPF, DKIM y DMARC con el proveedor.
- Verifica PTR del IP SMTP real; normalmente el proveedor de relay lo gestiona.
- Prueba invitaciones, recuperación de contraseña y avisos programados por separado.
- Inspecciona rebotes y spam sin publicar contraseñas SMTP.
Usa un servicio adecuado para avisos de sistema, separado de remitentes de marketing con mala reputación. Configura MAIL_HOST, MAIL_PORT, credenciales y remitente de tu versión y conserva verificación de certificados. Una prueba inmediata no verifica el scheduler.
Prepara columnas CSV y formato de serie. Resuelve etiquetas vacías/duplicadas y series ambiguas, importa por lotes y comprueba ubicación, usuario, garantía y estado. Haz copia antes de una importación grande: repetirla no siempre es idempotente.
El QR contiene identificador o URL del activo, nunca contraseñas ni tokens administrativos. Prueba etiquetas impresas con un móvil y verifica HTTPS y permisos de login.
- Da a personal de inventario/IT solo permisos necesarios de creación, entrega y devolución.
- Implementa y prueba el acceso por departamento: la etiqueta de departamento no impone aislamiento por sí sola.
- Asigna a auditoría los permisos de lectura compatibles necesarios.
- Verifica qué activos e información ven los empleados normales.
- Separa tokens por integración y define rotación, caducidad cuando se admita y revocación.
Prueba roles y aislamiento por empresa con cuentas no administrativas antes de prometer separación organizativa. Si usas LDAP o SSO compatible, conserva un administrador local protegido y prueba acceso durante una caída del proveedor de identidad.
Este patrón de cron del anfitrión solo corresponde si la imagen no ejecuta ya el scheduler:
* * * * * cd /opt/snipeit && docker compose exec -T snipeit php artisan schedule:run >> /dev/null 2>&1
Inspecciona procesos de la imagen y prueba manualmente con usuario/directorio reales. Elige un único responsable del horario; no dupliques tareas del contenedor. Conserva registros y alertas en lugar de descartar resultados. Verifica zona horaria, garantías y opciones de notificación. Informes/importaciones largos necesitan control de solapamiento y vigilancia de CPU/base. Si cambias la cola síncrona predeterminada por un backend asíncrono, añade su worker requerido.
Necesitas MariaDB, adjuntos/datos persistentes, configuración y APP_KEY original. El ejemplo antiguo supone cliente y prefijo de volumen concretos:
mkdir -p /opt/snipeit/backups
docker compose exec -T db mysqldump -usnipeit -p"YOUR_DB_PASSWORD" snipeit | gzip > /opt/snipeit/backups/snipeit-$(date +%F).sql.gz
docker run --rm -v snipeit_snipeit_data:/data -v /opt/snipeit/backups:/backup alpine sh -c 'tar czf /backup/snipeit-data-$(date +%F).tgz -C /data .'
cp .env docker-compose.yml /opt/snipeit/backups/
Comprueba montajes con Compose/inspect. MariaDB actual puede incluir mariadb-dump en lugar de mysqldump: usa el cliente disponible y credenciales protegidas. Activa pipefail y verifica exportación. Pausa escrituras y scheduler para copias coherentes de base/archivos y guarda configuración activa. No uses down -v al conservar datos.
Cifra copias externas. Restaura la misma versión en una máquina limpia y prueba login, ajustes cifrados, adjuntos, QR, entrega/devolución, auditoría y correo. Evita avisos reales durante la prueba. Consulta restauración probada.
docker compose config > /opt/snipeit/backups/compose-$(date +%F).yaml
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 snipeit
Registra versiones anterior/nueva, copia y prueba migraciones. Evita latest automático. Revertir una base migrada puede exigir restaurar su copia y APP_KEY correspondientes; una imagen anterior no deshace cambios de esquema.
docker compose ps
docker compose logs --tail=200 snipeit
sudo journalctl -u caddy -n 100 --no-pager
ss -lntp | grep -E ':8080|:80|:443'
Comprueba 8080 privado, upstream Caddy, inicio, APP_URL, proxy de confianza y cookies.
Revisa ejecución/usuario del scheduler, acceso Docker, conexión SMTP/TLS, DNS y rebotes, fechas del activo, zona horaria y opciones. Distingue correo inmediato de tareas programadas.
Comprueba límites PHP/aplicación y límites de cuerpo expresamente configurados en proxy/CDN, disco y propietario del almacenamiento. Caddy no impone un tamaño universal. Da solo permisos necesarios, sin almacenamiento escribible por cualquiera. La VPN puede mantener el inventario fuera de internet público.
- Dominio, HTTPS, administrador y QR funcionan.
- SMTP, invitaciones, recuperación y recordatorios probados.
- Base y puertos internos de administración privados.
- Etiquetas, ubicaciones, usuarios y permisos verificados.
- Configuración, APP_KEY, base y adjuntos con copia externa.
- Restauración completada en una instancia separada.
- Versión, migración y reversión documentadas.
Define datos y permisos antes de importar cientos de equipos. Así el historial de compra, asignación, reparación y devolución será útil para inventarios y auditorías.