Ubuntu Jellyfin如何连接外部硬盘 - 问答

Ubuntu 下让 Jellyfin 使用外部硬盘的完整步骤

一准备工作

插入外置硬盘，确认设备与分区：
- 查看块设备：lsblk
- 查看文件系统与 UUID：lsblk -f 或 sudo blkid
创建挂载点（示例）：sudo mkdir -p /mnt/udisk0
建议始终使用分区的 UUID 进行挂载，避免因设备名变化（如 /dev/sda1 → /dev/sdb1）导致失败。

二挂载外部硬盘

手动挂载示例（按实际文件系统替换）：
- ext4：sudo mount -t ext4 /dev/sda1 /mnt/udisk0
- NTFS：sudo mount -t ntfs-3g /dev/sda1 /mnt/udisk0
设置开机自动挂载（使用 UUID 更稳妥）：
- 获取 UUID：sudo blkid /dev/sda1
- 编辑 /etc/fstab，在末尾添加一行：
  - ext4：UUID=你的UUID /mnt/udisk0 ext4 defaults 0 2
  - NTFS：UUID=你的UUID /mnt/udisk0 ntfs defaults 0 0
- 验证配置：sudo mount -a（无报错即生效）
权限与所有权（容器内以 jellyfin 用户运行时更稳妥）：
- 将挂载点属主设为 jellyfin（示例）：sudo chown -R jellyfin:jellyfin /mnt/udisk0
- 或在 fstab 中使用挂载选项（示例）：defaults,uid=1000,gid=100,umask=022（1000/100 为常见 jellyfin 用户/用户组 ID，按实际调整）。

三在 Jellyfin 中添加媒体库

本机安装：在 Jellyfin 管理后台的 控制台 → 媒体库 中添加文件夹，路径选择 /mnt/udisk0/电影、/mnt/udisk0/剧集 等。

Docker 运行：将媒体目录挂载到容器内，例如：

命令示例：

docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /mnt/udisk0/jellyfin/config:/config \
  -v /mnt/udisk0/Movies:/media/movies \
  -v /mnt/udisk0/TV:/media/tv \
  --restart unless-stopped \
  jellyfin/jellyfin:latest

说明：将 /mnt/udisk0/Movies 与 /mnt/udisk0/TV 映射到容器内，然后在媒体库中添加这两个路径。

四常见问题与排查

NTFS 报错 “The disk contains an unclean file system …” 或 “Mount is denied … already exclusively opened”：
- 修复文件系统：sudo ntfsfix /dev/sda1
- 若提示被占用，先卸载：sudo umount /mnt/udisk0，再重新挂载
- 若仍异常，建议在 Windows 对该盘符执行 chkdsk /f X: 后重启两次再接入 Ubuntu。
权限被拒绝或媒体库扫描不到文件：
- 确认挂载点属主为 jellyfin 用户（或设置 fstab 的 uid/gid/umask）
- 重启 Jellyfin 服务或容器后再触发扫描。
设备名变化导致开机未挂载：
- 使用 UUID 配置 /etc/fstab，避免依赖 /dev/sdX 名称。

0 赞

0 踩