Tutoriales de VPS
Datos ausentes tras recrear Docker Compose: volúmenes y recuperación
Si el contenedor recreado muestra un sitio vacío, revisa el host Docker, el proyecto y sus montajes. Localiza y respalda el volumen antiguo antes de distinguir un montaje erróneo de datos borrados.

Tras actualizar Docker Compose, el sitio vuelve al instalador y parecen haber desaparecido cuentas, artículos o archivos. No lo inicialices otra vez todavía. El contenedor nuevo puede estar usando un volumen vacío mientras los datos originales siguen en el VPS.
En un host con Docker Engine, sigue este orden: confirma el daemon, inspecciona el montaje real, identifica el almacenamiento original y, después de hacer una copia recuperable, vuelve a conectarlo. Este proceso detecta montajes incorrectos; no garantiza recuperar volúmenes eliminados ni bases de datos dañadas. Sustituye todos los nombres de proyecto, servicio y volumen de ejemplo por los reales.
Pausa subidas, registros y tareas en segundo plano. Conserva las dos instancias y sus configuraciones. Si no sabes qué servicio es propietario de los datos, investiga antes de programar una parada; no borres contenedores para probar. Por ahora evita docker compose down -v, docker volume rm y cualquier limpieza de volúmenes.
La referencia de Compose down distingue ambas operaciones: down elimina contenedores y redes, pero conserva por defecto los volúmenes con nombre. Con -v también elimina los volúmenes declarados y los anónimos asociados, salvo los external. Aunque un volumen anónimo sobreviva, un up posterior no vuelve a conectarlo automáticamente.
| Síntoma | Primera comprobación | Posible siguiente paso |
|---|---|---|
| Instalación nueva después de cambiar de directorio | Nombre del proyecto y del volumen | Localizar el volumen del proyecto anterior |
| Directorio de archivos vacío | Source real del bind mount | Reconectar la ruta absoluta original |
| Base de datos nueva tras actualizar | Directorio de datos, versión y dirección de conexión | Comparar documentación y base de datos original |
| Se ejecutó una orden de eliminación de volúmenes | Volúmenes restantes, copias y snapshots | Restaurar una copia o detener escrituras y pedir ayuda |
Desde el directorio original, utiliza los mismos -p, -f y --env-file que el despliegue o el panel. Aquí shop es solo el nombre de ejemplo:
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
El equipo local, un contexto remoto, Docker rootless y el daemon del sistema pueden tener almacenamientos diferentes. Comprueba la conexión antes de interpretar una lista vacía como eliminación. config expande variables: revisa dirección y nombre de la base de datos, pero no publiques resultados que contengan contraseñas.
Una conexión a otra base de datos también puede mostrar un sitio vacío con el volumen correcto. Si dudas del origen de la configuración, consulta cambios de variables en Compose que no se aplican.
Copia el nombre real desde ps -a o desde el panel e inspecciona .Mounts:
docker inspect shop-app-1 --format '{{json .Mounts}}'
docker volume ls
docker volume inspect shop_data
docker ps -a --filter volume=shop_data
Compara cuatro campos con el contenedor anterior, su configuración y los requisitos de la imagen: si Type es volume o bind; el volumen real Name; su Source; y la ruta interna Destination. Fechas y etiquetas de Compose aportan pistas, pero nombres parecidos no prueban que los datos sean los correctos.
Los datos escritos solo en la capa modificable del contenedor desaparecen cuando se elimina ese contenedor al recrearlo. Si el original sigue existiendo, consérvalo y prepara una copia consistente antes de extraerlos. No arranques varias instancias de base de datos sobre el mismo directorio.
Según la precedencia del nombre de proyecto, -p prevalece sobre COMPOSE_PROJECT_NAME, seguido de name y finalmente los valores derivados del directorio. El nombre de la carpeta actual no basta.
Este ejemplo es una demostración independiente, no un archivo de recuperación para producción. BusyBox es un servicio de ejemplo y /data un directorio de demostración:
services:
app:
image: busybox:1.37
command: ["sleep", "86400"]
volumes:
- data:/data
volumes:
data: {}
Con el proyecto shop, el volumen predeterminado es shop_data; al usar shopnew pasa a ser shopnew_data. Ambos archivos pueden declarar data y referirse a volúmenes reales distintos. El nuevo volumen vacío puede provocar la inicialización.
Cuando identifiques el volumen original, conserva imagen, variables y ruta interna en la configuración de producción. Cambia únicamente su declaración:
volumes:
data:
external: true
name: shop_data
La documentación de name y external explica que name utiliza el nombre exacto sin prefijo de proyecto. external: true exige que exista; si falta, el arranque falla en lugar de crear otro vacío. Ninguna opción comprueba el contenido ni constituye una copia de seguridad.
Antes del cambio, crea una copia recuperable, detén todas las instancias anteriores capaces de escribir y revisa el config final. Arranca la aplicación original durante una ventana de mantenimiento y con una versión de base de datos compatible. No hagas una actualización mayor durante la recuperación ni reemplaces el servicio real con el ejemplo de BusyBox.
Mover el proyecto de /opt/shop a /opt/shop-new puede cambiar el destino de ./data. Con varios archivos Compose, revisa también el directorio del archivo base. La evidencia definitiva es Source en la inspección del contenedor.
La referencia de bind mounts advierte que un montaje oculta el contenido previo del destino. Algunas formas de sintaxis corta también crean un directorio vacío cuando falta el origen. Un directorio montado vacío no demuestra que el anterior se borrara.
Esta es otra demostración independiente: una ruta absoluta facilita comprobar el origen, y create_host_path: false impide arrancar si no existe:
services:
app:
image: busybox:1.37
command: ["sleep", "86400"]
volumes:
- type: bind
source: /srv/shop-data
target: /data
bind:
create_host_path: false
Verifica la existencia, las fechas y el tamaño del directorio antiguo. No copies uno vacío encima ni apliques chmod 777 de forma masiva. Si una actualización cambió la ruta de datos de la imagen, revisa su migración; la guía de PostgreSQL 18 explica su cambio específico de rutas.
Antes de reconectarlo, confirma que contiene los datos originales, ninguna otra instancia escribe, la imagen acepta ese formato y la copia se restaura en un entorno aislado. Comprimir sin más el directorio de una base de datos en ejecución no garantiza consistencia. Usa su herramienta nativa o una copia con parada documentada; consulta los simulacros de restauración.
Después, comprueba cuentas antiguas, varios registros históricos, archivos y tareas, y realiza una escritura y lectura nuevas. Si el sitio vacío ya recibió pedidos o archivos, conserva esos datos y planifica cómo combinarlos antes de sustituirlos.
Si no aparece el volumen original en el daemon correcto, o los datos estaban en la capa de un contenedor eliminado, revisa copias externas, respaldos de base de datos y snapshots. Sin copia, reduce las escrituras al disco de origen y evalúa recuperación profesional. Crear otro volumen con el mismo nombre no devuelve su contenido anterior.
La validación del artículo original se limitó al análisis estático de Compose: nombres de volumen con dos proyectos, referencia fija a un volumen external y desactivación de la creación automática del origen de un bind mount. No se probaron remontajes reales, arranque de una base restaurada ni recuperación de datos.