Primeros pasos

Elección de almacenamiento

Volumen con nombre, montaje de enlace y permisos UID/GID 1001:1001.

NasDash debe poder escribir en todo el /app/data. El ejemplo Compose predeterminado usa una carpeta del host. Un volumen con nombre es opcional.

Montaje de enlace (predeterminado)

Ventajas: los archivos son visibles para las instantáneas del host y las herramientas de copia de seguridad de carpetas. Las instalaciones existentes ya usan ./data.

volumes:
  - ./data:/app/data

Prepare el directorio antes del primer inicio:

# Fresh empty directory; default container UID:GID
mkdir -p data
sudo chown 1001:1001 data
sudo chmod 700 data

La imagen usa por defecto UID:GID 1001:1001; un usuario explícito de Compose lo sustituye. Para archivos existentes o ACL Synology, detenga NasDash, haga copia y permita a la identidad real acceder a datos y logos. No cambie propietarios recursivamente a ciegas. Consulte instalación y permisos.

Volumen con nombre (opcional)

Para una instalación nueva, use el archivo completo docker-compose.named-volume.yml del repositorio del producto. Su declaración de nivel superior asigna explícitamente el nombre nasdash-data al volumen. Siga usando ese archivo para gestionar la pila. La propiedad y los permisos siguen siendo importantes, especialmente con un UID:GID personalizado.

docker compose -f docker-compose.named-volume.yml up -d
docker compose -f docker-compose.named-volume.yml ps
docker compose -f docker-compose.named-volume.yml stop nasdash

Limitación: los archivos no son visibles directamente en el árbol de directorios del host Docker. Utilice un comando de copia de seguridad mediante un contenedor temporal. No lo use en una instalación ./data existente sin copiar los archivos primero.

No cambie de modelo implícitamente

Cambiar de ./data al volumen nasdash-data sin copiar los datos crea una instancia aparentemente nueva. Los datos antiguos no han desaparecido, pero ya no están montados.

Antes de migrar:

  1. Detenga NasDash.
  2. Copie toda la fuente.
  3. Incluya todos los archivos, claves y archivos ocultos.
  4. Permita acceso al UID:GID real.
  5. Arranque con el nuevo destino.
  6. Compruebe acceso, servicios, topología, logos e integraciones.