Jellyseerr数据备份与恢复完全指南

Jellyseerr数据备份与恢复完全指南

jellyseerr Fork of overseerr for jellyfin support 项目地址: https://gitcode.com/gh_mirrors/je/jellyseerr

前言

作为一款优秀的媒体请求管理工具，Jellyseerr在日常使用中积累了大量的配置信息和用户数据。本文将详细介绍Jellyseerr的数据存储机制，并提供全面的备份与恢复方案，帮助用户确保数据安全。

Jellyseerr数据存储结构

配置数据

Jellyseerr的所有系统配置都存储在settings.json文件中，包括：

• 与Radarr、Sonarr等媒体管理工具的集成配置
• Jellyfin、Plex等媒体服务器的连接设置
• 各类通知渠道的配置信息
• 系统全局参数设置

用户数据

用户相关数据存储在数据库中，支持两种数据库引擎：

1. SQLite（默认嵌入式数据库）
2. PostgreSQL（专业级关系型数据库）

这些数据包括：

• 用户登录凭证
• 媒体请求记录
• 过滤名单数据
• 权限设置
• 请求历史记录

备份方案详解

SQLite数据库备份

方法一：文件级备份（推荐简单方案）

1. 停止Jellyseerr服务
2. 备份整个config目录
3. 主要备份文件：
   • db/db.sqlite3（核心数据库文件）
   • settings.json（配置文件）

方法二：在线备份（无需停止服务）

对于需要24/7运行的环境，可以使用SQLite命令行工具进行热备份：

sqlite3 db/db.sqlite3 ".backup '/tmp/jellyseerr_db.sqlite3.bak'"

此命令会创建一个数据库的完整副本，不会影响正在运行的服务。

PostgreSQL数据库备份

PostgreSQL数据库备份更加灵活，无需停止服务：

pg_dump -U <数据库用户名> -d <数据库名> -f /tmp/jellyseerr_db.sql

高级参数说明：

• -h：指定数据库服务器地址
• -p：指定数据库端口号
• --format=custom：使用二进制格式备份（体积更小）

恢复操作指南

SQLite数据库恢复

1. 确保目录结构如下：

   .
   ├── cache            # 缓存目录（可选）
   ├── db
   │   └── db.sqlite3   # 核心数据库文件
   ├── logs             # 日志目录（可选）
   └── settings.json    # 配置文件（建议恢复）
   

2. 将备份文件放置到对应位置
3. 启动Jellyseerr服务

PostgreSQL数据库恢复

1. 使用pg_restore命令恢复数据：

pg_restore -U <数据库用户名> -d <数据库名> /tmp/jellyseerr_db.sql

2. 可选恢复配置文件：

   .
   ├── cache            # 缓存目录（可选）
   ├── logs             # 日志目录（可选）
   └── settings.json    # 配置文件（建议恢复）
   

3. 启动Jellyseerr服务

最佳实践建议

1. 定期备份：建议设置自动化备份任务，至少每周备份一次
2. 多地存储：将备份文件保存在至少两个不同的物理位置
3. 版本管理：为重要配置更改创建手动备份点
4. 测试恢复：定期验证备份文件的可恢复性
5. 监控空间：确保备份存储有足够空间

常见问题解答

Q：备份时需要停止服务吗？ A：SQLite建议停止服务，PostgreSQL可以直接备份

Q：可以只备份数据库不备份配置吗？ A：可以，但恢复后需要重新配置系统参数

Q：备份文件可以压缩吗？ A：可以，SQLite备份后建议使用gzip压缩

Q：如何验证备份是否成功？ A：可以尝试在测试环境恢复备份数据

通过本文的详细指导，您应该能够全面掌握Jellyseerr的数据备份与恢复方法，确保您的媒体请求管理系统数据安全无忧。

jellyseerr Fork of overseerr for jellyfin support 项目地址: https://gitcode.com/gh_mirrors/je/jellyseerr