Jellyfin 的添加媒体库默认只认本机路径。你把电影放在 NAS 的网络文件共享文件夹里，它扫不到。添加解决办法不是网络文件把文件拷来拷去，而是添加让 Jellyfin 直接挂载那个网络文件夹，把它当成自己硬盘上的网络文件一块目录。

我自己的添加环境是 Ubuntu 22.04 跑 Jellyfin，片源全放在群晖的网络文件 /volume1/video 里。下面这套流程同样适用于 Windows 和 Docker，添加只是网络文件挂载方式不同。

先搞清楚 Jellyfin 以哪个用户身份运行

这一步很多人跳过，添加结果挂载好了 Jellyfin 却读不到。网络文件Linux 下执行：

ps aux | grep jellyfin

看第一列的添加用户名。apt 安装通常是网络文件 jellyfin，Docker 里可能是添加 root 或你指定的 PUID。记住它，后面挂载参数要对上。

用 cifs 挂载 SMB 共享

群晖、Windows 共享走 SMB 协议，Linux 端用 cifs-utils。先装：

sudo apt install cifs-utils

建一个挂载点，比如 /mnt/nas_video。然后别急着写 fstab，先手动挂一次测试：

sudo mount -t cifs //192.168.1.10/video /mnt/nas_video -o username=youruser,password=yourpass,uid=1000,gid=1000,iocharset=utf8,vers=3.0

几个参数值得说。uid 和 gid 填 Jellyfin 运行用户的 ID，用 id jellyfin 查。vers 按 NAS 支持的协议填，群晖新系统用 3.0，老设备可能要降到 2.0 甚至 1.0。iocharset=utf8 是中文文件名不乱码的关键。

挂载成功后 ls /mnt/nas_video 能看到文件，说明通了。这一步失败的话，八成是密码里有特殊字符，改用 credentials 文件更稳。

写进 fstab 让它开机自动挂

手动挂载重启就没了。把凭据单独存一个文件，权限设 600：

sudo nano /etc/cifs-credentials

内容两行：

username=youruser password=yourpass

然后 sudo chmod 600 /etc/cifs-credentials。接着编辑 /etc/fstab，加一行：

//192.168.1.10/video /mnt/nas_video cifs credentials=/etc/cifs-credentials,uid=1000,gid=1000,iocharset=utf8,vers=3.0,nofail 0 0

nofail 这个选项别省。NAS 偶尔关机或网络抽风时，没有它系统可能卡在启动阶段等挂载超时。

Windows 上的做法完全不同

Windows 版 Jellyfin 一般是作为服务运行的。你在资源管理器里映射的网络驱动器，服务账户看不到。正确姿势是用 net use 命令，并且带上 /persistent:yes：

net use Z: \\192.168.1.10\video /user:youruser yourpass /persistent:yes

映射完在 Jellyfin 后台添加媒体库，路径填 Z:\。如果服务读不到，去服务属性里把登录账户改成有网络访问权限的本地账户。

Docker 部署的情况

Docker 里最简单——直接在 docker-compose.yml 里加 volume 映射，把宿主机挂载好的目录映射进容器：

volumes: - /mnt/nas_video:/media/nas_video:ro

只读挂载加 :ro，Jellyfin 不需要写权限，安全一些。容器里添加媒体库时路径用 /media/nas_video。

扫库前的一个小提醒

挂载好之后，Jellyfin 后台添加媒体库，文件夹路径填挂载点。扫描时如果进度条卡着不动，去 /var/log/jellyfin/ 看日志，通常是权限问题——挂载点的 uid/gid 和 Jellyfin 用户对不上。改 fstab 里的 uid/gid 再 sudo mount -a 重挂一次就行。

另外，网络文件夹的读取速度取决于你的内网带宽。千兆网跑 4K 原盘勉强够，但 Jellyfin 转码时如果同时读多个大文件，卡顿是难免的。有条件上 2.5G 或万兆，体验差别很明显。