UbuntuJellyfin如何添加外部存储

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

一 准备与识别外部存储

• 连接硬盘后查看设备名与分区：
  • 查看块设备：lsblk
  • 查看文件系统与 UUID：lsblk -f
• 常见路径示例：/dev/sdb1、/dev/sdc1。请记录目标分区的 UUID 与文件系统类型（如 ext4、ntfs、exfat），后续用于自动挂载与权限配置。

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

• 创建挂载点（示例：/mnt/udisk0）：
  • sudo mkdir -p /mnt/udisk0
• 手动挂载示例（以 ext4 为例）：
  • sudo mount /dev/sdb1 /mnt/udisk0
• 图形界面方式（适合桌面版）：
  • 打开“文件”→“其他位置”，选择外接硬盘，点击“挂载”。
• 说明：
  • 若分区为 NTFS/exFAT，请先安装相应工具（如 ntfs-3g），再执行挂载。
  • 挂载成功后，外部存储即可在 /mnt/udisk0 访问。

三 配置自动挂载（推荐用 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**）导致挂载失败。

四、在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
  • 在网页端“添加媒体库”时选择 /media 下的相应子目录（如 /media/Movies）。
• 说明：
  • 若使用 Docker，务必将外部存储目录以 -v 宿主机路径:容器路径 的方式映射进容器，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 下的媒体目录。