跳到主要内容

服务端配置

当前默认 config.yml：

native:
  backend: ""
  os: ""
  arch: ""
  download-proxy: ""
  mpv-ytdl-path: ""

youtube:
  cookies-file: ""
  cookies-from-browser: ""

native.backend​

  • 可选：mpv、vlc。
  • 空字符串表示 MPV。
  • 修改后重新加载/重启插件所需路径，并用诊断确认实际后端。

native.os 与 native.arch​

两者同时为空时按服务端 JVM 自动检测。

native.os可用 native.arch
windowsx86、x64、arm64
macosx64、arm64
linuxx86、x64、arm32、arm64
androidVLC 后端的 arm64-v8a

只在自动检测不符合实际容器/宿主机时覆盖。不要把宿主机架构和容器内 JVM 架构混为一谈。

native.download-proxy​

用于原生运行库下载和流播放的 HTTP(S) 代理，例如：

native:
  download-proxy: "http://127.0.0.1:7890"

这是 VideoPlayer 运行时配置，与构建文档站时使用的本机 npm 代理没有关系。代理包含用户名/密码时保护配置文件和日志。

native.mpv-ytdl-path​

可选的 yt-dlp 可执行文件路径。留空时依次尝试 VideoPlayer 管理版本、系统 PATH 或允许的自动安装路径。

Linux 示例：

native:
  mpv-ytdl-path: "/usr/bin/yt-dlp"

Windows YAML 中包含反斜杠时使用引号，并确认服务端账户可以执行该文件。

  • youtube.cookies-file：Cookie 文件路径。
  • youtube.cookies-from-browser：浏览器资料来源。

两项为空时不注入 Cookie。服务器上通常使用受控 Cookie 文件；不要让服务端读取管理员日常浏览器的完整资料目录。

修改后的检查​

  1. 保存 YAML，确认缩进没有 Tab。
  2. 重新加载前备份当前配置。
  3. 检查控制台是否成功识别 backend/os/arch。
  4. 用 /videoplayer diagnostics 检查后端和 yt-dlp。
  5. 用无敏感参数的测试 URL 验证播放。
最后于 更新