Tutoriais de VPS
Snipe-IT na VPS: Docker, ativos, acesso e recuperação
Implante Snipe-IT com Docker, MariaDB e Caddy. Configure armazenamento, APP_KEY, SMTP, importação e etiquetas QR; teste permissões, scheduler e restauração antes de atualizar.

O Snipe-IT organiza ativos, licenças, acessórios, consumíveis e atribuições de equipamentos. Uma instalação própria permite administrar etiquetas, anexos e histórico de custódia, embora ainda haja confiança no provedor da VPS. Você também mantém banco, e-mail, tarefas agendadas, backups e atualizações.
Usaremos Ubuntu 24.04, Docker Compose, MariaDB e Caddy para uma equipe pequena. Fixe uma versão suportada e use o modelo de variáveis e os requisitos de banco correspondentes.
| Recurso | Laboratório | Referência para equipe pequena |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU ou mais |
| RAM | 2 GB | 4 GB ou mais |
| Disco | 30 GB SSD | 60 GB SSD ou mais |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Domínio | snipe.example.com | Subdomínio de inventário |
São referências, sem garantia de capacidade. Importações, relatórios e anexos podem superar as necessidades da web. Confira free -h, df -h e docker stats; veja dimensionamento. Configure A/AAAA funcionais e somente administração necessária e 80/443 públicos. Mantenha MariaDB privada; considere restringir todo o inventário à VPN da organização.
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
Revise o instalador executado como root ou use pacotes suportados. O grupo Docker concede acesso poderoso ao anfitrião. Use senhas únicas. Nesta configuração Laravel, acrescente base64: ao valor Base64 de 32 bytes gerado para APP_KEY, substituindo o marcador. Preserve a chave no .env protegido e nos backups; não a regenere ao recriar contêineres.
Docker secrets só funciona quando a imagem sabe consumi-lo; criar um segredo não substitui uma variável automaticamente.
O esboço mostra porta web privada e armazenamento persistente. Confira banco, imagem e healthcheck para a versão escolhida:
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:
Substitua credenciais/chave, fixe a imagem sem latest e use o modelo oficial de variáveis. Mantenha APP_DEBUG=false. APP_URL é a URL HTTPS final; DB_HOST=db identifica o serviço, não localhost dentro do contêiner. O exemplo oficial preserva /var/lib/snipeit: proteja essa montagem real.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 snipeit
Confira nomes e processos de inicialização. Siga os requisitos de instalação, scheduler e filas da versão; a página funcionar não comprova lembretes. Proteja a configuração expandida, que pode mostrar segredos.
ssh -L 8080:127.0.0.1:8080 root@SERVER_IP
Abra http://127.0.0.1:8080 pelo túnel no computador de administração. HTTP temporário não substitui o domínio HTTPS ao testar links e cookies.
- Configure nome, fuso e formato de datas.
- Crie senha administrativa forte e MFA suportado.
- Defina empresas, departamentos, locais e status.
- Escolha etiquetas, tratamento de números de série e tamanho de impressão.
- Crie usuários comuns e papel de auditoria restrito.
- Limite tipos de anexos e tamanhos de upload.
Mantenha etiquetas estáveis. Separe ano de compra, categoria e sequência quando útil; diferencie etiqueta, modelo e série. Teste uma amostra antes da importação completa.
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
Use um gateway em 80/443, encaminhando para 8080 privada. Configure APP_TRUSTED_PROXIES com o endereço real do proxy visto pelo contêiner; não confie em cabeçalhos de qualquer origem. Confira APP_URL e cookies HTTPS. HSTS/includeSubDomains exige HTTPS nos nomes afetados. Veja Caddy.
- Use remetente e nome próprios.
- Configure SPF, DKIM e DMARC com o provedor.
- Verifique PTR do IP SMTP real; normalmente o provedor de relay gerencia isso.
- Teste convites, recuperação de senha e avisos agendados separadamente.
- Examine devoluções e spam sem publicar senhas SMTP.
Use serviço apropriado para avisos de sistema, separado de remetentes de marketing com má reputação. Configure MAIL_HOST, MAIL_PORT, credenciais e remetente da versão, preservando verificação de certificados. Um teste imediato não valida o scheduler.
Prepare colunas CSV e formato de série. Resolva etiquetas vazias/duplicadas e séries ambíguas, importe em lotes e confira local, usuário, garantia e status. Faça backup antes de uma importação grande; repeti-la não é necessariamente idempotente.
O QR deve conter identificador ou URL do ativo, nunca senhas ou tokens administrativos. Teste etiquetas impressas no celular e confira HTTPS e permissões de login.
- Dê à equipe de inventário/IT apenas permissões necessárias de criação, entrega e devolução.
- Implemente e teste acesso por departamento; o rótulo do departamento não impõe isolamento sozinho.
- Dê à auditoria as permissões de leitura suportadas necessárias.
- Verifique quais ativos e informações empregados comuns conseguem visualizar.
- Separe tokens por integração e defina rotação, expiração quando suportada e revogação.
Teste papéis e isolamento por empresa com contas sem administração antes de prometer separação organizacional. Com LDAP ou SSO suportado, preserve administrador local protegido e teste acesso durante falha do provedor de identidade.
O padrão de cron no anfitrião só se aplica quando a imagem não executa o scheduler:
* * * * * cd /opt/snipeit && docker compose exec -T snipeit php artisan schedule:run >> /dev/null 2>&1
Inspecione processos da imagem e teste manualmente com usuário/diretório reais. Escolha um responsável pela agenda; não duplique tarefas do contêiner. Preserve logs e alertas, em vez de descartar resultados. Confira fuso, garantias e opções de notificação. Relatórios/importações longos precisam de controle de sobreposição e monitoramento de CPU/banco. Se trocar a fila síncrona padrão por backend assíncrono, adicione o worker necessário.
A recuperação exige MariaDB, anexos/dados persistentes, configuração e APP_KEY original. O exemplo antigo pressupõe cliente e prefixo de volume específicos:
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/
Confira montagens com Compose/inspect. MariaDB atual pode incluir mariadb-dump em vez de mysqldump; use cliente disponível e credenciais protegidas. Ative pipefail e valide a exportação. Pause escritas e scheduler para cópias coerentes de banco/arquivos, salvando configuração ativa. Não use down -v ao preservar dados.
Criptografe cópias externas. Restaure a mesma versão em máquina limpa e teste login, ajustes criptografados, anexos, QR, entrega/devolução, auditoria e e-mail. Evite notificações reais no teste. Veja recuperação testada.
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
Registre versões antiga/nova, faça backup e teste migrações. Evite latest automático. Reverter banco migrado pode exigir restaurar backup e APP_KEY correspondentes; uma imagem antiga não desfaz alterações 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'
Confira 8080 privada, upstream do Caddy, inicialização, APP_URL, proxy confiável e cookies.
Examine execução/usuário do scheduler, acesso Docker, SMTP/TLS, DNS e devoluções, datas do ativo, fuso e opções. Diferencie e-mail imediato de tarefas programadas.
Confira limites PHP/aplicação e limites de corpo explicitamente configurados no proxy/CDN, disco e dono do armazenamento. Caddy não impõe tamanho universal. Dê só permissões necessárias, sem armazenamento gravável por qualquer pessoa. A VPN pode manter o inventário fora da internet pública.
- Domínio, HTTPS, administrador e QR funcionando.
- SMTP, convites, recuperação de senha e lembretes testados.
- Banco e portas internas de administração privados.
- Etiquetas, locais, usuários e permissões verificados.
- Configuração, APP_KEY, banco e anexos com cópia externa.
- Restauração concluída em instância separada.
- Versão, migração e reversão documentadas.
Defina dados e permissões antes de importar centenas de equipamentos. Assim, compra, atribuição, reparo e devolução ficam rastreáveis para inventários e auditorias.