jellyfin在ubuntu上的存储管理

Jellyfin在Ubuntu上的存储管理指南

一、媒体库存储路径配置

Jellyfin的核心存储需求是媒体库目录（存放电影、电视剧、音乐等媒体文件）。配置时需通过Web界面完成，步骤如下：

1. 登录Jellyfin管理界面（http://<服务器IP>:8096），点击左侧菜单栏媒体库；
2. 点击添加媒体库，选择媒体类型（电影/电视剧/音乐等），输入显示名称（如“家庭电影”）；
3. 点击文件夹+，浏览并选择Ubuntu上的目标目录（如/mnt/hdd/media），点击下一步完成配置。
   需确保Jellyfin服务用户（默认jellyfin）对目标目录有读写权限，可通过以下命令设置：

sudo chmod 755 -R /mnt/hdd/media  # 赋予读写执行权限
sudo chown jellyfin:jellyfin /mnt/hdd/media  # 修改所有者为jellyfin

二、Docker安装下的存储卷管理

若通过Docker部署Jellyfin，需通过**卷映射（Volume Mapping）**将容器内的数据目录与主机目录关联，确保数据持久化。常用卷配置如下：

• 配置目录：映射到主机的高速存储（如SSD），存放Jellyfin的设置、元数据等；
• 缓存目录：同样映射到高速存储，用于临时文件（如缩略图、预览视频）；
• 媒体目录：映射到容量大的存储设备（如HDD），存放实际媒体文件。
  示例docker-compose.yml配置：

version: '3'
services:
  jellyfin:
    image: jellyfin/jellyfin
    container_name: jellyfin
    user: "0:0"  # 以root用户运行，避免权限问题
    volumes:
      - /mnt/ssd/jellyfin/config:/config  # 配置目录（SSD）
      - /mnt/ssd/jellyfin/cache:/cache    # 缓存目录（SSD）
      - /mnt/hdd/media:/media             # 媒体目录（HDD）
    network_mode: host

需提前创建主机目录（如/mnt/ssd/jellyfin/config、/mnt/hdd/media），并确保目录权限正确。

三、存储设备挂载与权限

若使用外部存储（如HDD、NAS），需先挂载到Ubuntu系统，再配置Jellyfin访问：

1. 挂载HDD到Ubuntu：
   • 创建挂载点：sudo mkdir /mnt/hdd；
   • 挂载设备：sudo mount /dev/sdb1 /mnt/hdd（/dev/sdb1为HDD分区，可通过lsblk查看）；
   • 设置开机自动挂载：编辑/etc/fstab，添加一行：/dev/sdb1 /mnt/hdd ext4 defaults 0 2（假设文件系统为ext4）。
2. 挂载NAS共享目录：
   • 安装NFS客户端：sudo apt install nfs-common；
   • 创建挂载点：sudo mkdir /mnt/nfsvol；
   • 挂载NAS共享：sudo mount -t nfs <NAS_IP>:/volume1/share /mnt/nfsvol（<NAS_IP>为NAS地址，/volume1/share为共享目录）；
   • 设置开机自动挂载：编辑/etc/fstab，添加一行：<NAS_IP>:/volume1/share /mnt/nfsvol nfs defaults 0 0。
     挂载后，将Jellyfin媒体库目录指向挂载点（如/mnt/nfsvol），并确保权限正确。

四、数据备份策略

为防止数据丢失，需定期备份Jellyfin的关键数据（配置、媒体库元数据、用户数据）：

1. Jellyfin自带备份功能：
   • 登录管理界面，点击系统→备份；
   • 选择完整备份（包含所有数据），设置备份位置（如本地/mnt/hdd/backup或外部USB驱动器）；
   • 点击开始备份，完成后可下载备份文件到本地。
2. 文件系统备份（rsync）：
   • 停止Jellyfin服务：sudo systemctl stop jellyfin；
   • 备份数据目录：sudo rsync -avz /var/lib/jellyfin /mnt/hdd/backup/jellyfin（/var/lib/jellyfin为Jellyfin默认数据目录）；
   • 恢复时反向操作：sudo rsync -avz /mnt/hdd/backup/jellyfin /var/lib/jellyfin，然后重启服务。
3. Docker容器备份：
   • 备份配置：docker cp jellyfin:/config /mnt/hdd/backup/config；
   • 恢复时，重新创建容器并挂载备份的配置目录：docker run -d --name jellyfin -p 8096:8096 -v /mnt/hdd/backup/config:/config -v /mnt/hdd/media:/media jellyfin/jellyfin。

五、存储优化技巧

1. 分离存储路径：将配置、缓存放在SSD（提升访问速度），媒体文件放在HDD（降低成本），通过Docker卷或符号链接实现；
2. 使用符号链接整合目录：若媒体文件分散在不同分区，可通过符号链接整合到Jellyfin媒体库目录，例如：

   ln -s /mnt/hdd/movies /mnt/ssd/media/movies  # 将HDD的movies目录链接到SSD的媒体目录下
   

3. 定期清理缓存：Jellyfin的缓存目录（如/cache）会积累临时文件，定期清理可释放空间：

   sudo rm -rf /mnt/ssd/jellyfin/cache/*  # 清空缓存
   

4. 监控存储空间：使用df -h命令查看磁盘使用情况，设置阈值提醒（如通过cron任务每天检查）。