Cómo respaldar un contenedor Docker de Valkey (2026)
Respaldar Valkey con seguridad se resume en una regla: volcar, no copiar. `valkey-cli SAVE # then capture the resulting dump.rdb` produce un volcado consistente y restaurable desde el contenedor en ejecución, que restic cifra después fuera del servidor. un SAVE/BGSAVE bifurca una instantánea RDB a un instante preciso en disco: respaldas el dump.rdb terminado (más el AOF si está activado), no el estado volátil en memoria. Todo lo que copie /data en caliente arriesga un respaldo irrecuperable.
Qué detecta Dockstash
| Claves de entorno detectadas | VALKEY_PASSWORD, VALKEY_ARGS, REDIS_PASSWORD |
|---|---|
| Puerto por defecto | 6379 |
| Rutas de datos vivas (nunca copiadas en caliente) | /data, /data/dump.rdb, /data/appendonly.aof |
| Imágenes de ejemplo | valkey/valkey:8, valkey/valkey:7, valkey/valkey |
Respalda Valkey con Dockstash, paso a paso
Crea tu cuenta de Dockstash y abre el panel
Regístrate gratis en app.dockstash.com/register. El asistente de configuración único te pide tu VPS de almacenamiento (la máquina que guardará los respaldos cifrados) y genera una contraseña de cifrado — guárdala de inmediato en un gestor de contraseñas: se muestra exactamente una vez.
Añade el proyecto Docker que ejecuta Valkey
En la pantalla Projects, Dockstash detecta automáticamente cada carpeta de proyecto Compose del servidor (por defecto bajo /var/www). Elige el proyecto que contiene tu servicio Valkey. Aún no se respalda nada — solo le indicas a Dockstash dónde vive el proyecto.
Comprueba que Valkey fue detectado
Abre el proyecto y mira la pestaña Plan. Dockstash lee docker-compose.yml, reconoce la imagen valkey/valkey y añade una capa con la estrategia correcta de guardar-y-capturar — más el nombre del contenedor resuelto y las claves encontradas (VALKEY_PASSWORD, VALKEY_ARGS y la antigua REDIS_PASSWORD). Puedes activar o desactivar archivos, bases y configuraciones de proxy antes de guardar.
Opcional: comprueba la instantánea a mano
Si quieres una prueba antes de automatizar, dispara el mismo guardado que Dockstash: ejecuta valkey-cli BGSAVE en el contenedor. Valkey responde « Background saving started », bifurca y escribe un dump.rdb a instante preciso en /data — la misma persistencia RDB heredada de Redis. Ese archivo terminado es lo que se respalda, nunca el estado vivo en memoria.
docker exec <valkey-container> valkey-cli BGSAVEConfirma tu destino de almacenamiento
Los respaldos se guardan como instantáneas restic cifradas en tu propio VPS de almacenamiento, vía SSH. Si completaste el asistente, ya está configurado; puedes cambiar host, usuario, puerto o la clave SSH en cualquier momento en Settings → Storage.
Define una programación de respaldo
En la pestaña Schedule elige diario, semanal o una expresión cron personalizada (validada al escribir). Para un Valkey usado como almacén principal (colas, sesiones), diario es un suelo razonable y cada hora es habitual. Añade un prune semanal con tu política de retención.
Ejecuta el primer respaldo ahora
Haz clic en Backup Now en la tarjeta del proyecto. Dockstash dispara un guardado en segundo plano, espera el dump.rdb terminado y lo respalda — junto con appendonly.aof cuando la persistencia AOF está activa — directamente en restic. Sigue la salida en vivo en el panel de logs.
Confirma que la instantánea existe
Al terminar la ejecución, la tarjeta del proyecto muestra la nueva hora del último respaldo, el número de instantáneas y el tamaño del repositorio. Abre la pantalla Snapshots: el punto de restauración aparece en la línea de tiempo — tu prueba de que el respaldo llegó fuera del servidor.
El comando de volcado
valkey-cli SAVE # then capture the resulting dump.rdbEl comando de restauración
place dump.rdb in the data dir and start valkey-serverun SAVE/BGSAVE bifurca una instantánea RDB a un instante preciso en disco: respaldas el dump.rdb terminado (más el AOF si está activado), no el estado volátil en memoria.
Restaura un respaldo de Valkey y prueba que funciona
Un respaldo de Valkey solo es real una vez restaurado. Las restauraciones de Dockstash nunca sobrescriben tu instancia viva por defecto — primero restauras a una ubicación nueva, verificas los datos y promocionas deliberadamente.
Elige un punto de restauración
Abre Snapshots, selecciona el proyecto y recorre la línea de tiempo. Cada fila contiene un dump.rdb completo a instante preciso (más el AOF si está activado) y los archivos del proyecto de la misma ejecución.
Restaura a una nueva ubicación
Haz clic en Restore y mantén el modo por defecto « Restore to new location ». Escribe el nombre del proyecto para confirmar — una acción deliberada con confirmación tecleada. El volcado y los archivos aterrizan en la ruta de destino que elijas, sin tocar el proyecto vivo.
Verifica los datos restaurados
Coloca el dump.rdb restaurado en el directorio de datos de un contenedor Valkey de prueba y arráncalo — Valkey carga el RDB al inicio. Ejecuta valkey-cli PING: debes recibir PONG; luego sondea las claves de tu aplicación con DBSIZE y algunos GET.
docker exec <valkey-container> valkey-cli PINGPromociona cuando estés conforme
Cuando los datos restaurados estén validados, apunta tu aplicación a ellos (o repite la restauración en modo « Overwrite existing » — un opt-in explícito). Mejor aún: deja que el simulacro de restauración semanal produzca esta prueba automáticamente, para que una restauración nunca sea tu primer ensayo.
Trampas a evitar
- Como con Redis, nunca captures un dump.rdb a mitad de reescritura — dispara SAVE/BGSAVE primero y respalda el archivo terminado.
- valkey-cli es el binario cliente; en algunas imágenes de compatibilidad redis-cli es un enlace simbólico — Dockstash detecta el que esté presente.
- Activa y captura el AOF cuando necesites las escrituras más frescas; el RDB solo puede ir por detrás.
Problemas comunes al respaldar Valkey
- Síntoma
- El dump.rdb restaurado no carga: error de archivo truncado o lectura corta.
- Causa
- El RDB se copió mientras Valkey aún lo reescribía — el mismo riesgo de mitad-de-reescritura que Redis, pues Valkey conserva el modelo de persistencia RDB idéntico.
- Solución
- Dispara siempre SAVE o BGSAVE y espera a que termine antes de capturar dump.rdb. Dockstash hace exactamente eso.
- Síntoma
- Una prueba manual con redis-cli funciona pero valkey-cli responde « not found » (o al revés).
- Causa
- El binario cliente varía según la imagen: las imágenes oficiales valkey/valkey traen valkey-cli, mientras algunas imágenes de compatibilidad enlazan redis-cli.
- Solución
- Usa el binario que traiga la imagen — protocolo y comandos son iguales. Dockstash detecta automáticamente el cliente presente; el respaldo funciona en ambos casos.
- Síntoma
- Colocaste el dump.rdb restaurado en /data pero el Valkey en marcha sigue sirviendo datos viejos.
- Causa
- Como Redis, Valkey solo lee el RDB al arrancar — no hay intercambio en caliente. Y con appendonly activo, el AOF tiene prioridad al inicio y el RDB se ignora.
- Solución
- Para el contenedor, coloca el dump.rdb restaurado (y el AOF si procede) en el directorio de datos y arranca de nuevo. Si solo restauraste un RDB en un montaje con AOF, pon temporalmente appendonly no para el primer arranque y reactívalo después.
- Síntoma
- Una restauración funciona pero faltan las escrituras más recientes.
- Causa
- La persistencia AOF está activa y appendonly.aof contenía escrituras más nuevas que la instantánea RDB.
- Solución
- Respalda ambos archivos. Dockstash captura /data/dump.rdb y appendonly.aof juntos en la misma ejecución.
Hazlo en un clic con Dockstash
Dockstash ejecuta exactamente el volcado de arriba, lo entrega a restic fuera del servidor y prueba la restauración con un simulacro automáticamente — sin script que mantener.
Última actualización: July 2026
Preguntas frecuentes
¿En qué difiere respaldar Valkey de Redis?
En nada significativo. Valkey es un fork de Redis y conserva el mismo modelo de persistencia RDB y AOF. La única diferencia práctica es el nombre del binario cliente (valkey-cli), que Dockstash detecta automáticamente.
¿Puedo restaurar un RDB de Redis en Valkey?
Sí para las versiones actuales — el formato RDB es compartido desde el punto del fork. A medida que los proyectos diverjan, mantén las restauraciones en el mismo motor por prudencia.
¿Dockstash detecta Valkey automáticamente?
Sí. Se reconocen las imágenes valkey/valkey y el binario valkey-cli, y se captan tanto VALKEY_PASSWORD como la antigua REDIS_PASSWORD.
¿Debo capturar también el AOF?
Si appendonly está activo y no puedes perder los últimos segundos de escrituras, sí. Dockstash respalda el RDB y los archivos AOF.
¿Con qué frecuencia debo respaldar Valkey?
Ajusta la programación al contenido. Para colas y sesiones, cada hora es habitual; para datos más lentos, diario basta. En el plan Free los respaldos son manuales (Backup Now); Pro permite hasta cada hora, Business cualquier expresión cron.
¿Dónde viven realmente los respaldos?
En tu propio VPS de almacenamiento, como instantáneas restic cifradas enviadas por SSH. Dockstash nunca guarda tus datos en una nube de terceros — lo apuntas a una máquina que controlas, y el repositorio está cifrado con una contraseña que solo tú tienes.
¿Cómo sé que un respaldo de Valkey realmente se restaura?
Programa un simulacro de restauración. Dockstash restaura la última instantánea en un espacio aislado, compara cada archivo byte a byte con la fuente y verifica el volcado capturado — luego estampa una insignia de éxito/fallo en el proyecto.