群晖DSM上Plex媒体库无法识别youtube-dl自动下载视频问题

先梳理下你的核心问题：手动复制到Plex媒体文件夹的视频能被正常识别，但通过定时任务用youtube-dl下载的视频，哪怕调整了执行用户、手动修改了文件权限，依然无法被Plex媒体库读取。结合我的经验，你可能遗漏了以下几个关键环节：

1. 确认Plex的自动扫描机制是否生效 #

Plex默认会监控媒体文件夹的文件变化来自动扫描新增内容，但群晖定时任务在特定用户身份下执行时，可能无法触发Plex的文件系统通知机制（比如部分NAS的inotify服务对非交互式任务支持有限）。

• 检查配置：打开Plex Web管理界面 → 进入对应媒体库 → 点击右上角「...」→ 「管理库」→ 「编辑」→ 切换到「高级」标签，确认「自动扫描媒体库」处于勾选状态。
• 临时补救：可以在脚本末尾添加触发Plex扫描的命令，比如调用Plex API强制刷新：

  curl -X POST 'http://localhost:32400/library/sections/{你的库ID}/refresh' -H 'X-Plex-Token: {你的Plex令牌}'
  

  （库ID可在Plex库编辑页面的URL中找到，Plex令牌可在账户设置的「通用」选项里生成）

2. 修正youtube-dl的脚本参数错误 #

你的脚本里存在两个明显的参数问题，可能导致下载的文件不符合Plex识别逻辑：

• 参数格式错误：-format应该是--format（或简写-f），你写的-format是无效参数，可能导致下载的文件格式不是预期的MP4，甚至文件损坏。
• Playlist URL拼接错误：你写的https://www.youtube.com/playlist?list=PLK--playlist-start 1格式混乱，正确写法是https://www.youtube.com/playlist?list=PLXXXXXX（替换成真实的playlist ID），后面单独跟--playlist-start 1 --playlist-end 1参数。
• 可选优化：给下载的文件指定规范命名，避免特殊字符干扰Plex识别，比如：

  youtube-dl https://www.youtube.com/playlist?list=PLXXXXXX --playlist-start 1 --playlist-end 1 --format mp4 -o "%(title)s.%(ext)s"
  

修正后的完整脚本示例：

echo "start downloading"
cd /volume1/myfolder
# 下载指定范围内的视频，指定MP4格式和规范文件名
youtube-dl https://www.youtube.com/playlist?list=PLXXXXXX --playlist-start 1 --playlist-end 1 --format mp4 -o "%(title)s.%(ext)s"
# 自动给下载的文件设置正确权限
DOWNLOADED_FILE=$(youtube-dl --get-filename https://www.youtube.com/playlist?list=PLXXXXXX --playlist-start 1 --playlist-end 1 --format mp4 -o "%(title)s.%(ext)s")
chown http:http "/volume1/myfolder/$DOWNLOADED_FILE"
chmod 644 "/volume1/myfolder/$DOWNLOADED_FILE"

3. 检查群晖ACL权限是否覆盖了传统权限 #

虽然你手动执行了chown和chmod 777，但群晖DSM的ACL权限可能会覆盖Linux传统权限：

• 操作步骤：打开群晖「文件管理器」→ 右键点击媒体文件夹/volume1/myfolder → 「属性」→ 「权限」→ 确保http用户拥有「读取」和「列出文件夹内容」的权限，且勾选「应用到该文件夹、子文件夹及文件」。

4. 强制刷新Plex元数据与清理缓存 #

有时候Plex会缓存旧的库信息，即使文件存在也不会显示：

• 刷新元数据：在Plex Web界面中，找到对应媒体库 → 点击右上角「...」→ 选择「刷新元数据」。
• 清理缓存：进入Plex「设置」→ 「管理」→ 「缓存」→ 点击「清理缓存」，然后重启群晖上的Plex服务。

5. 验证下载文件的编码是否符合Plex要求 #

虽然你能在PC或群晖播放器打开视频，但Plex对编码有特定兼容要求（比如优先支持H.264视频编码+AAC音频编码）。可以用MediaInfo工具查看下载文件的编码信息，如果编码不兼容，可在youtube-dl中指定兼容格式：

youtube-dl --format "bestvideo[ext=mp4][vcodec^=avc1]+bestaudio[ext=m4a][acodec^=mp4a]/best[ext=mp4]"

内容的提问来源于stack exchange，提问作者Luis L