Operación

Restauración

Restaure una copia de seguridad completa en un bind mount o en un volumen con nombre.

La restauración sustituye los datos activos. Detenga NasDash, conserve una copia verificada del estado actual, identifique el formato del archivo y use primero la misma versión de la aplicación. Mantenga la configuración secreta y el UID:GID. La interfaz no restaura copias.

Copia NasDash o archivo de la interfaz

Un archivo .tar.gz de la interfaz contiene nasdash-backup.json y data/. Extráigalo primero en un directorio privado nuevo; una copia CLI ya tiene ese formato. Desde un clon con Node.js 22, restaure en el directorio real montado en el host. --force autoriza sustituirlo; el destino existente se renombra a un directorio vecino .pre-restore-*. Consérvelo hasta validar. Se necesita --target si los datos activos difieren del directorio predeterminado del clon.

# Interface archive only: extract into a NEW directory
umask 077
mkdir ./backups/nasdash-snapshot
tar -xzf ./backups/nasdash-interface-backup.tar.gz -C ./backups/nasdash-snapshot
docker compose stop nasdash
npm run data:restore -- --from ./backups/nasdash-snapshot --target ./data --force
# Grant the actual runtime UID:GID access to restored files before starting
docker compose start nasdash

Archivo directo del montaje

Un archivo directo creado con tar -C data . contiene los archivos directamente. La herramienta de copias no lo acepta. Detenga NasDash, renombre el directorio actual, cree un destino nuevo y extraiga el archivo allí. No lo superponga a un directorio existente: podrían quedar archivos o claves antiguos. Restablezca propietario y ACL para la identidad real y arranque NasDash.

Volumen con nombre

Prefiera un volumen nuevo vacío y conserve el anterior para volver atrás. Este ejemplo supone que nasdash-data-restore es nuevo y vacío y que verificó el archivo directo. Para un archivo de la interfaz, copie solo el contenido de data/ extraído. Cambie el montaje Compose al volumen restaurado después de preparar los permisos. No elimine el volumen original antes de validar.

docker compose -f docker-compose.named-volume.yml stop nasdash
docker run --rm \
  --volume nasdash-data-restore:/target \
  --volume "$PWD/backups:/backup:ro" \
  alpine sh -c 'tar -xzf /backup/nasdash-data-backup.tar.gz -C /target'

Compruebe /api/health, el acceso del administrador y de los lectores configurados, las páginas, servicios, topología, logos y cada integración. En modo público, verifique el acceso anónimo según los permisos del lector guardado. Conserve los datos anteriores y la copia hasta que la instancia restaurada funcione. Los ajustes restaurados pueden reiniciar las copias programadas; revíselos también.