Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Copia de seguridad y restauración

Esta guía documenta cómo realizar copias de seguridad y luego restaurar los datos de tu instancia de Jellyfin.

Por qué es importante hacer copias de seguridad

Las copias de seguridad son importantes en general para todos los datos digitales. Existen innumerables errores e incidencias que pueden surgir y causar pérdida de datos, especialmente cuando actualizas versiones principales (por ejemplo, de Jellyfin 10.9.x a Jellyfin 10.10.x).

Además, Jellyfin no tiene mecanismo de reversión a versiones anteriores. Esto es crucial entenderlo; una vez que tu instancia de Jellyfin se inicia con una nueva versión, todas las migraciones pendientes se aplican inmediatamente, y tus datos de Jellyfin dejarán de funcionar con la versión anterior. La única forma de restaurar tu instancia activa a la versión anterior es mediante una copia de seguridad. Por tanto, las copias de seguridad son críticas si deseas probar versiones Inestables, o antes de actualizar a la última versión. De hecho, al probar versiones Inestables, es mejor hacer copias de seguridad con mucha más frecuencia, quizás usando un cron job o mecanismo automático similar, para garantizar que tus datos puedan recuperarse si encuentras un problema grave.

Las copias de seguridad también pueden ser útiles si encuentras un error. Por ejemplo, si un error en la nueva versión corrompe algún aspecto de los datos de Jellyfin, restaurar desde una copia de seguridad significa que puedes volver rápidamente a datos válidos y aplicar correcciones para evitar que se repita. Sin una copia de seguridad, estarías completamente perdido en esta situación.

Finalmente, errores administrativos, problemas de funcionamiento normal (ej. llenar un disco), o corrupción general de bits pueden causar daños o incidencias que requieran restaurar una copia de seguridad. Siempre es mejor tener una que no tenerla.

Existen dos formas de realizar copias de seguridad de tus datos de Jellyfin. Una es mediante su sistema integrado de Copia de seguridad/Restauración y la otra es manualmente.

Copia de seguridad integrada

El sistema de copia de seguridad integrado de Jellyfin puede crear un respaldo mientras tu sistema está en línea y funcionando, a diferencia del proceso manual que requiere detener Jellyfin previamente. Sin embargo, en la versión 10.11 aún recomendamos realizar el proceso de copia de seguridad durante períodos de baja actividad y cuando no haya escaneos activos.

Crear una copia de seguridad integrada

Para crear un nuevo respaldo, ingresa al Panel de control de Jellyfin, abre la pestaña Backups y haz clic en el botón Create Backup. El cuadro emergente te pedirá seleccionar qué datos deseas respaldar.

• Base de datos. Siempre activada. Contendrá todos los datos de jellyfin.db o del proveedor de base de datos utilizado.

• Metadatos. El contenido de la carpeta de metadatos y, dependiendo de tus opciones seleccionadas, puede incluir imágenes de metadatos.

• Subtítulos. Todos los subtítulos extraídos, incluidos los descargados.

• Trickplay. Todos los datos de Trickplay que no se almacenan junto a los medios.

El sistema de copia de seguridad verificará al menos 5GB de espacio libre en la carpeta de respaldos donde se escriben las copias. Sin embargo, esto puede no ser suficiente si también respaldas Subtítulos y Trickplay, así que asegúrate de tener suficiente espacio libre allí. La carpeta de respaldos se encuentra dentro de tu directorio de datos de Jellyfin, por defecto:

• Docker oficial: <volume path>/config/data/backups donde <volume path> es la fuente de tu volumen /config; esto se establece en tu docker-compose.yml o en las opciones -v de docker run.

• LinuxServer.io Docker: <volume path>/config/data/data/backups donde <volume path> es donde se origina tu volumen /config; esto se establece en tu docker-compose.yml o en las opciones -v de docker run.

• Paquetes Debian/Ubuntu: /var/lib/jellyfin/data/backups.

• Paquetes RPMFusion Fedora/CentOS: /var/lib/jellyfin/data/backups.

• Instalación de Windows para usuario: %LOCALAPPDATA%\Jellyfin\data\backups (C:\Users\<Username>\AppData\Local\Jellyfin\data\backups)

• Instalación de Windows como servicio: %PROGRAMDATA%\Jellyfin\Server\data\backups (C:\ProgramData\Jellyfin\Server\data\backups)

• Instalador MacOS (.dmg): Los datos se almacenan en una de estas rutas; respalda la(s) que existan: ~/.config/jellyfin/data/backups, ~/.local/share/jellyfin/data/backups, ~/Library/Application Support/Jellyfin/data/backups:

• Instalaciones portátiles:

  • Linux: Los datos se almacenan en ~/.local/share/jellyfin/data/backups.
  • Windows: Los datos y configuración están en C:\Users\<Username>\AppData\Local\jellyfin\data\backups, usando %LOCALAPPDATA%.
  • MacOS: Los datos se almacenan en estas rutas; respalda la(s) que existan: ~/.config/jellyfin/data/backups, ~/.local/share/jellyfin/data/backups, ~/Library/Application Support/Jellyfin/data/backups.

Después de hacer clic en el botón Create, todos los datos se escribirán en un nuevo archivo zip.

Restaurar desde una copia de seguridad integrada

Para restaurar desde un respaldo, puedes usar la interfaz web navegando a la misma vista que en el paso anterior y haciendo clic en el botón de restauración en la lista de copias de seguridad, o puedes iniciar jellyfin con el argumento --restore-archive PATH_TO_BACKUP_ZIP. Ten en cuenta que cuando inicias una restauración desde la interfaz web, tu servidor se reiniciará inmediatamente para que este proceso tenga lugar y no estará disponible durante ese tiempo.

Copia de seguridad manual

Realizar una copia de seguridad manual implica básicamente que copies tú mismo todos los datos que Jellyfin requiere.

Crear una copia de seguridad manual

1. Detén el servidor Jellyfin en ejecución. Esto es extremadamente importante, ya que de lo contrario la base de datos estará bloqueada y podría no ser recuperable al restaurar. Ten en cuenta que esto interrumpirá cualquier reproducción en curso.

   • Cualquier plataforma: En el panel de control de Jellyfin, haz clic en "Apagar". Esto debería detener el proceso limpiamente en todas las plataformas, pero si no funciona, prueba uno de los siguientes métodos.
   • Docker: docker stop jellyfin
   • Paquetes Debian/Ubuntu: sudo systemctl stop jellyfin o sudo service jellyfin stop
   • Instalador Windows: Haz clic derecho en la aplicación de bandeja y selecciona "Salir"; o en el Administrador de tareas, busca el proceso Jellyfin y termínalo.
   • Instalador MacOS (.dmg): En el Monitor de Actividad, busca el proceso Jellyfin y termínalo.
   • Instalaciones portátiles (todas las plataformas): Detén el programa en ejecución jellyfin o jellyfin.exe, independientemente de cómo se inició.

2. Copia tus directorios de datos y configuración a un destino de tu elección. El nombre que le des a las copias depende de ti; personalmente, prefiero usar nombres de directorio con fecha y versión, ej. jellyfin.2024-05-01_10.8.13. La ubicación de estos archivos también depende de la plataforma; generalmente siguen la Especificación de Directorios XDG en plataformas compatibles. Para más detalles, consulta la documentación de configuración.

   NOTA: Estas son ubicaciones predeterminadas; si has cambiado tus rutas de datos o configuración, usa esas en su lugar.

   • Docker oficial: El directorio de datos es donde se origina tu volumen /config; se define en tu docker-compose.yml o en las opciones -v de docker run. Este directorio incluye también la configuración.
   • Docker LinuxServer.io: El directorio de configuración es donde se origina tu volumen /config; se define en tu docker-compose.yml o en las opciones -v de docker run. Este directorio incluye también los datos.
   • Paquetes Debian/Ubuntu: El directorio de datos es /var/lib/jellyfin y el de configuración es /etc/jellyfin; se definen en /etc/default/jellyfin.
   • Paquetes RPMFusion Fedora/CentOS: El directorio de datos es /var/lib/jellyfin y el de configuración es /etc/jellyfin; se definen en /etc/sysconfig/jellyfin.
   • Instalador/Tray de Windows (.exe): El directorio de datos es %PROGRAMDATA%\Jellyfin\Server (C:\ProgramData\Jellyfin\Server) o %LOCALAPPDATA%\Jellyfin (C:\Users\<Username>\AppData\Local\Jellyfin). Este directorio incluye también la configuración.
   • Instalador MacOS (.dmg): Los datos se almacenan en estas rutas; haz copia de las que existan: ~/.config/jellyfin/, ~/.local/share/jellyfin/, ~/Library/Application Support/Jellyfin/.
   • Instalaciones portátiles:
     • Linux: Los directorios de datos y configuración son ~/.local/share/jellyfin.
     • Windows: El directorio de datos es %LOCALAPPDATA%\jellyfin (C:\Users\<Username>\AppData\Local\jellyfin). Este directorio incluye también la configuración.
     • MacOS: Los datos se almacenan en estas rutas; haz copia de las que existan: ~/.config/jellyfin/, ~/.local/share/jellyfin/, ~/Library/Application Support/Jellyfin/.

   Como ejemplo, en Debian puedes ejecutar estos comandos para copiar ambos directorios en un único destino:

   TIMESTAMP=$(date +%Y%m%d%H%M%S)
   VERSION=10.9.10
   sudo mkdir -p /media/backups/jellyfin.${TIMESTAMP}_${VERSION}  # Or change the path wherever in your system makes sense to you
   sudo cp -a /var/lib/jellyfin /media/backups/jellyfin.${TIMESTAMP}_${VERSION}/data
   sudo cp -a /etc/jellyfin /media/backups/jellyfin.${TIMESTAMP}_${VERSION}/config

3. Inicia Jellyfin nuevamente, ya sea después de actualizar o en la versión actual. Ahora tienes una copia segura de tus datos en la ruta elegida en el paso 2.

Restaurar desde una copia de seguridad manual

Este proceso asume que seguiste los pasos anteriores para hacer la copia de seguridad.

1. Detén el proceso del servidor Jellyfin en ejecución.

2. Mueve tus directorios actuales de datos y configuración a otro lugar (por ejemplo, añadiendo .bak al nombre). Por ejemplo: sudo mv /var/lib/jellyfin /var/lib/jellyfin.bak y sudo mv /etc/jellyfin /etc/jellyfin.bak.

3. Copia - no muevas ni renombres - tu copia de seguridad al nombre original. Por ejemplo: sudo cp -a /media/backups/jellyfin.2024-10-27_10.9.11/data /var/lib/jellyfin y sudo cp -a /media/backups/jellyfin.2024-10-27_10.9.11/config /etc/jellyfin.

4. Si es necesario, ahora degrada Jellyfin a la misma versión de tu copia de seguridad.

5. Inicie Jellyfin nuevamente. Debería iniciarse correctamente con los datos antiguos, asumiendo que las versiones son correctas. Si ha realizado un downgrade, esto puede ocurrir automáticamente.