Ubuntu Jellyfin添加外部存储的详细设置方法

Ubuntu系统下如何为Jellyfin添加外部存储

一 准备与识别外部存储

• 连接外接硬盘后，先确认设备名称和分区信息：
  • 查看块设备列表：lsblk
  • 查看文件系统类型与 UUID：lsblk -f
• 常见设备路径示例：/dev/sdb1、/dev/sdc1。请提前记录目标分区的 UUID 和文件系统类型（如 ext4、ntfs、exfat），后续在 Ubuntu 中配置 Jellyfin 外部存储挂载和开机自动挂载时都会用到。

二 挂载外部硬盘到本地目录

• 创建挂载点目录（示例：/mnt/udisk0）：
  • sudo mkdir -p /mnt/udisk0
• 手动挂载示例（以 ext4 分区为例）：
  • sudo mount /dev/sdb1 /mnt/udisk0
• 图形界面方式（更适合 Ubuntu 桌面版用户）：
  • 打开“文件”→“其他位置”，找到外接硬盘后点击“挂载”。
• 说明：
  • 如果分区格式是 NTFS/exFAT，请先安装对应支持工具（如 ntfs-3g），然后再执行挂载操作。
  • 挂载完成后，即可通过 /mnt/udisk0 访问该外部存储目录，后续也能作为 Jellyfin 媒体库路径使用。

三 配置自动挂载（推荐用 UUID）

• 先获取分区的 UUID：
  • sudo blkid
• 编辑 /etc/fstab，在文件末尾加入如下内容（示例为 ext4）：
  • UUID=你的UUID /mnt/udisk0 ext4 defaults 0 2
• 如果外部硬盘是 NTFS 格式，可使用：
  • UUID=你的UUID /mnt/udisk0 ntfs defaults 0 0
• 保存后测试配置是否生效：
  • sudo mount -a（没有报错一般表示配置成功；系统重启后会自动挂载）
• 提示：
  • 使用 UUID 配置挂载，比直接写设备名更稳妥，可避免设备路径变化（如 /dev/sdb→**/dev/sdc**）造成 Ubuntu 开机挂载失败。

四、在Jellyfin中如何添加媒体库目录

• 本机安装版（APT）或二进制安装版：
  • 访问 http://服务器IP:8096 → 完成初始化设置 →“添加媒体库”
  • 在“文件夹”中选择已经挂载好的目录（如 /mnt/udisk0/Movies、/mnt/udisk0/TV），根据电影、剧集等分类分别添加，保存后即可触发媒体刮削与扫描。
• Docker 部署（示例命令）：
  • 创建目录：sudo mkdir -p /mnt/udisk0/jellyfin/{config,cache}
  • 启动容器（将媒体目录映射为 /media）：
    • docker run -d --name jellyfin -p 8096:8096
      -v /mnt/udisk0/jellyfin/config:/config
      -v /mnt/udisk0/jellyfin/cache:/cache
      -v /mnt/udisk0:/media
      jellyfin/jellyfin
  • 在 Jellyfin 网页后台添加媒体库时，选择 /media 下对应的子目录即可，例如 /media/Movies。
• 说明：
  • 如果你使用的是 Docker 部署方式，必须通过 -v 宿主机路径:容器路径 将 Ubuntu 外部硬盘目录映射到容器内部，否则 Jellyfin 无法识别和读取外部存储中的媒体文件。

五 权限与常见问题处理

• 权限不足（宿主机目录对 Jellyfin 无读写权限）：
  • 先检查挂载点和目录权限：ls -ld /mnt/udisk0
  • 调整属主（示例为将挂载目录属主修改为当前用户，Jellyfin 容器通常以 jellyfin 用户运行，可根据实际环境灵活调整）：
    • sudo chown -R $USER:$USER /mnt/udisk0
    • 或者在宿主机中将目录加入 jellyfin 组，并设置合适的权限值（如 775/770），之后重启 Jellyfin 服务。
• NTFS 挂载失败或读写异常：
  • 安装支持工具：sudo apt install ntfs-3g
  • 如果提示“NTFS is inconsistent”，通常需要回到 Windows 系统，对该硬盘执行：chkdsk /f X:，修复完成并重启后再重新挂载。
• 网络共享作为外部存储（可选）：
  • NFS：安装客户端 sudo apt install nfs-common，挂载示例如下：
    • sudo mount -t nfs 192.168.1.10:/volume1/share /mnt/nfsvol
    • 在 /etc/fstab 中加入：192.168.1.10:/volume1/share /mnt/nfsvol nfs defaults,_netdev 0 0
  • SMB/CIFS：安装 sudo apt install cifs-utils，并在 /etc/fstab 中加入：
    • //192.168.1.20/media /mnt/nas cifs username=用户,password=密码,file_mode=0777,dir_mode=0777 0 0
  • 配置完成后，即可在 Jellyfin 中添加 /mnt/nfsvol 或 /mnt/nas 下的媒体文件夹，作为远程媒体库使用。