群晖DS220+基于youtube-upload实现YouTube自动上传的配置排障

• Web应用类型OAuth凭证的适配错误
  你最初选用Web应用类型的客户端凭证，本身和CLI类本地上传工具的使用场景不匹配。这类凭证要求重定向URI是公网可访问的、与Google后台配置完全一致的服务地址，Google完成授权后会通过302跳转将授权码传递到该地址。在SSH无图形界面的环境下，浏览器位于你的本地设备，授权流程回调的localhost指向的是本地电脑而非群晖的临时服务端口，根本无法形成完整链路，因此会直接跳转Google报错页面，完全卡滞。
  另外Google从2022年起已全面下线oob（urn:ietf:wg:oauth:2.0:oob）的授权方式，即使在json配置中写入该地址，新创建的应用也无法通过该方式获取授权码，这是授权页面不显示验证码的核心原因。
• 已安装应用凭证替换后的IOError报错根源
  提示找不到/var/services/homes/usrname/.youtube-upload-credentials.json并非凭证配置错误，本质是两个常见的群晖环境权限/路径问题：
  1. 群晖未开启用户主目录服务，对应执行命令的用户家目录路径根本不存在
  2. 执行上传命令的用户与配置中写死的usrname不匹配，或是当前用户对家目录没有写入权限，导致程序无法自动创建缓存凭证的文件，触发IOError。

• 重新生成合规的OAuth凭证
  在Google云控制台创建OAuth客户端时，直接选择桌面应用类型，不要选择Web、安卓、iOS等其他类型。该类型的凭证无需手动配置重定向URI，Google会自动生成适配本地CLI工具的默认回调规则，下载对应的json文件替换现有client_secrets.json即可。
• 打通无GUI环境的授权流程
  因为群晖本身无图形界面，无法直接在本地浏览器完成授权回调，可在同网络下的带图形界面的电脑上，使用完全相同的client_secrets.json文件执行一次上传测试命令：
  1. 命令启动后会输出Google授权链接，在本地浏览器打开该链接，登录对应YouTube账号完成授权
  2. 授权完成后本地电脑上会自动生成缓存凭证文件（路径为本地用户家目录下的.youtube-upload-credentials.json）
  3. 提前在群晖对应执行用户的环境里，执行echo $HOME确认实际家目录路径，开启群晖控制面板的「用户主目录服务」，创建与本地路径一致的凭证文件路径，将本地生成的凭证文件拷贝到该路径下，设置文件权限为600（仅所属用户可读写）
• 调整执行命令的逻辑
  凭证缓存完成后，后续执行上传时无需重复携带--client-secrets参数，程序会自动从家目录读取缓存的授权信息，避免重复触发授权流程。如果仍报权限相关错误，不要用root用户执行上传命令，切换回普通用户执行即可，避免程序误将凭证缓存路径写到/root目录下。
• 配置自动触发脚本
  使用inotifywait工具监控目标存储文件夹，检测到新的mp4文件落地后，等待10秒左右确认文件拷贝完成，再调用上传命令执行流程，上传完成后将文件移动到归档目录，避免重复触发上传。

如果上述流程调试仍有障碍，可选择两个更稳定的替代路径：

• 直接使用对应工具的Docker镜像运行，将client_secrets.json挂载到容器内，首次授权时映射本地端口完成凭证缓存，后续可实现无交互自动上传，无需手动在群晖上适配python依赖版本
• 基于YouTube Data API v3的官方Python封装开发轻量化上传脚本，直接实现文件夹监控、断点续传、错误重试、日志记录的逻辑，完全摆脱第三方上传工具的版本兼容问题，适配群晖的运行环境。

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