Tutoriais de VPS
Dados sumiram após recriar o Docker Compose: volumes e recuperação
Se o contêiner recriado mostra um site vazio, confira host Docker, projeto e mounts reais. Localize e faça backup do volume antigo para distinguir mount incorreto de dados excluídos.

Depois de atualizar o Docker Compose, o site volta à tela de instalação e contas, artigos ou arquivos parecem ter desaparecido. Não inicialize tudo novamente ainda. O novo contêiner pode estar usando um volume vazio, enquanto os dados originais continuam no VPS.
Em um host com Docker Engine, siga esta sequência: confirme o daemon, inspecione o mount real, encontre o armazenamento original e, depois de um backup recuperável, reconecte-o. O procedimento identifica mounts incorretos; não garante recuperar volumes excluídos ou bancos corrompidos. Substitua todos os nomes de projeto, serviço e volume pelos reais antes de executar comandos.
Suspenda uploads, cadastros e tarefas em segundo plano. Preserve as duas instâncias e suas configurações. Se não sabe qual serviço é responsável pelos dados, investigue antes de agendar a parada; excluir contêineres para testar não ajuda. Evite docker compose down -v, docker volume rm e comandos de limpeza de volumes por enquanto.
A referência de Compose down distingue as operações: down remove contêineres e redes, mas mantém volumes nomeados por padrão. Com -v, também remove os volumes declarados e os anônimos associados, exceto os external. Mesmo quando um volume anônimo permanece, um up posterior não o reconecta automaticamente.
| Sintoma | Verifique primeiro | Possível próximo passo |
|---|---|---|
| Instalação nova após mudar de diretório | Nome do projeto e dos volumes | Encontrar o volume do projeto anterior |
| Diretório de arquivos vazio | Source real do bind mount | Reconectar o caminho absoluto original |
| Banco novo depois da atualização | Diretório de dados, versão e endereço do banco | Conferir a documentação e o banco original |
| Um comando excluiu volumes | Volumes restantes, backups e snapshots | Restaurar backup ou interromper gravações e buscar ajuda |
No diretório original, use os mesmos -p, -f e --env-file do script ou painel de implantação. Aqui shop é apenas um nome de exemplo:
docker context show
docker info --format '{{.Name}}'
docker compose ls -a
docker compose -p shop -f compose.yaml ps -a
docker compose -p shop -f compose.yaml config
Seu computador, um contexto Docker remoto, o Docker rootless e o daemon do sistema podem ter armazenamentos separados. Confirme a conexão antes de interpretar uma lista vazia como exclusão. config expande variáveis: confira endereço e nome do banco, mas não publique uma saída que contenha senhas.
Uma aplicação conectada a outro banco também pode parecer vazia com o volume correto. Se houver dúvida sobre a origem da configuração, veja variáveis do Compose que não refletem alterações.
Copie o nome real de ps -a ou do painel e inspecione .Mounts:
docker inspect shop-app-1 --format '{{json .Mounts}}'
docker volume ls
docker volume inspect shop_data
docker ps -a --filter volume=shop_data
Compare quatro campos com o contêiner antigo, a configuração original e os requisitos da imagem: se Type é volume ou bind; o volume real Name; seu Source; e o caminho interno Destination. Datas e labels do Compose ajudam, mas nomes parecidos não comprovam que sejam os dados corretos.
Dados gravados apenas na camada gravável do contêiner desaparecem quando ele é removido durante a recriação. Se o contêiner antigo ainda existe, preserve-o e planeje um backup consistente antes de extrair arquivos. Nunca inicie várias instâncias de banco sobre o mesmo diretório de dados.
Pelas regras de precedência do nome do projeto, -p prevalece sobre COMPOSE_PROJECT_NAME, seguido por name e pelos padrões derivados do diretório. Olhar apenas o nome da pasta atual não basta.
O exemplo abaixo é uma demonstração independente, não um arquivo de recuperação para produção. BusyBox serve como placeholder, e /data é um diretório de demonstração:
services:
app:
image: busybox:1.37
command: ["sleep", "86400"]
volumes:
- data:/data
volumes:
data: {}
Com o projeto shop, o volume padrão é shop_data. Ao mudar para shopnew, ele passa a ser shopnew_data. Ambos os arquivos podem declarar data enquanto apontam para volumes reais diferentes. O novo volume vazio pode acionar a inicialização.
Depois de identificar o volume antigo, mantenha imagem, variáveis e caminho interno na configuração de produção, alterando apenas a declaração correspondente:
volumes:
data:
external: true
name: shop_data
A documentação de name e external explica que name usa o nome exato, sem prefixo do projeto. external: true exige que o volume exista; se faltar, a inicialização falha em vez de criar um volume vazio. Nenhuma opção verifica o conteúdo ou funciona como backup.
Antes de alterar, faça um backup recuperável, pare todas as instâncias antigas que possam gravar e confira o config final. Inicie a aplicação original em uma janela de manutenção, com uma versão do banco compatível com os arquivos. Não aproveite a recuperação para atualizar a versão principal nem substitua o serviço real pelo exemplo BusyBox.
Mover o projeto de /opt/shop para /opt/shop-new pode mudar o destino de ./data. Com vários arquivos Compose, confira também o diretório do arquivo base. A evidência definitiva é Source na inspeção do contêiner.
A referência de bind mounts informa que um mount encobre o conteúdo original do destino. Algumas formas curtas também criam um diretório vazio quando a origem não existe. Um diretório montado vazio não comprova que o antigo foi excluído.
Esta é outra demonstração independente: o caminho absoluto facilita verificar a origem, e create_host_path: false impede a inicialização quando ela falta:
services:
app:
image: busybox:1.37
command: ["sleep", "86400"]
volumes:
- type: bind
source: /srv/shop-data
target: /data
bind:
create_host_path: false
Confira existência, datas e tamanho do diretório antigo. Não copie uma pasta vazia sobre ele nem aplique chmod 777 em massa. Se uma atualização mudou o caminho de dados da imagem, consulte as notas de migração; o guia do PostgreSQL 18 explica sua mudança específica.
Antes de reconectá-lo, confirme que contém os dados originais, nenhuma outra instância grava, a imagem aceita o formato e o backup restaura em um ambiente isolado. Compactar casualmente o diretório de um banco em execução não garante consistência. Use o backup nativo do banco ou uma parada documentada; consulte os exercícios de restauração.
Após recuperar, confira contas antigas, alguns registros históricos, uploads e tarefas, depois teste uma nova gravação e leitura. Se a instalação vazia já recebeu pedidos ou arquivos, preserve-os e planeje a conciliação antes de substituí-la.
Se o volume antigo não existe no daemon correto, ou os dados estavam apenas na camada de um contêiner excluído, procure backups externos, cópias do banco e snapshots. Sem backup, reduza gravações no disco de origem e avalie recuperação profissional. Criar um volume com o mesmo nome não traz o conteúdo anterior de volta.
A validação do artigo original se limitou à análise estática do Compose: nomes de volume em dois projetos, referência fixa a volume external e desativação da criação automática da origem de um bind mount. Não houve teste real de remontagem, inicialização de banco restaurado ou recuperação de dados.