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）或二进制安装版：
- 访问 https://服务器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
- docker run -d --name jellyfin -p 8096:8096
- 在 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 下的媒体文件夹，作为远程媒体库使用。
- NFS：安装客户端 sudo apt install nfs-common，挂载示例如下：
