进阶 docs.invidious.io 2026-10-13 23:01:14 · 29 阅读

第4章 Invidious 常见问题解答(FAQ):使用指南、数据隐私与实例运维

常见问题 目录 使用 Invidious 我可以在我的设备上使用 Invidious 吗? 你们打算开发 Android/iOS 应用程序吗? 我能在不同实例间同步我的账户吗? Invidious 会收集哪些数据? 哪些数据会共享给 YouTube? 常见错误/问题 媒体无法加载… 2.0 秒内无法从连接池中获取连接 (DB::PoolTimeout) DB::PoolRetryAttemptsExceeded 字幕无法工作! 360p/480p/1080p 清晰度选项在哪里? 运行自己的实例 你们提供预构建的二进制文件 (.deb、.rpm 等) 吗? 如何配置 [某项]? RSS 订阅/链接等的 URL 重定向到了 :3000,但我使用的是反向代理! 我的实例上的“热门”订阅/页面是空的! 我无法登录,也无法保存偏好设置 使用 Invidious 问:我可以在我的设备上使用 Invidious 吗? 答:只要你的设备配备了现代网页浏览器,当然可以!我们提供适用于手机/平板的响应式界面。
问:你们打算开发 Android/iOS 应用程序吗? 答:不。Invidious 是且将始终是一个浏览器应用程序。 如果你使用的是安卓手机/平板,可以查看 NewPipe 应用。
问:能否在多个实例之间同步我的账户? 答:简单来说:手动同步可以,自动同步不行。 手动同步的方法: 登录你的账户后进入导入/导出页面(在偏好设置页面,点击页面底部的"Import/export data"链接) 点击"Export Invidious data as JSON" 在另一个实例上打开同样的导入/导出页面 使用"Import Invidious JSON data" 点击导入 是的,我们知道这很麻烦。请继续往下读,了解我们为什么不实现自动同步。 我们不实现自动同步的原因: 简单说:我们没有时间和精力去开发和维护这个功能。 要实现自动同步,有 3 种方案: 1. 集中式数据库(类似 YouTube) 2. 联邦制(类似 Matrix、Mastodon 和 PeerTube) 3. 基于 API 的外部工具 集中式数据库违背了我们去中心化网络的初衷,所以直接排除(况且我们也不想承担托管大量用户数据的风险)。 联邦制是个不错的选择(在上述其他平台上都运作良好),但我们目前既没有时间也没有资源来实现它。 外部工具(在你本地电脑运行,或像 Firefox Sync 那样部署在自托管服务器上)也是可行的方案。和联邦制一样,我们没有资源去开发这样的方案。欢迎提交 PR 或提出外部工具的构想! 关于这个话题的更多细节,请参考以下 issue: https://github.com/iv-org/invidious/issues/2515
问:Invidious 会收集哪些数据? 答:Invidious 本身不会收集任何用户数据,但请注意,实例所有者可以记录你的 IP 地址(和互联网上任何其他服务器一样)。 默认情况下,服务器日志会记录被访问的 URL、对应的错误码(例如 URL 不存在时的 404)以及服务器响应所需的时间。 服务器日志大致如下: 2021-08-30 18:15:44 UTC [info] 200 GET /watch?v=GIAKHj9uJtM 781.21ms 2021-08-30 18:15:49 UTC [info] 200 GET /api/v1/search?q=Fly%20away 500.0ms 2021-08-30 18:15:49 UTC [info] 200 GET /vi/lJcqAzWFWLs/mqdefault.jpg 15.82ms 2021-08-30 18:15:49 UTC [info] 200 GET /vi/JoP_Tte7z7o/mqdefault.jpg 70.64ms 当你创建账户时,你的观看历史和订阅的频道列表会存储在服务器数据库中。你可以随时在账户页面导出、迁移或删除这些数据。
Q: 哪些数据会共享给 YouTube? A: 默认情况下,视频流直接来自 Google 的服务器(googlevideo.com),从而降低 Invidious 所需带宽,代价是 Google 可以看到你的 IP 地址,以及浏览器通常附带的一些数据(例如 User-Agent 字符串)。 如果你不想这样,可以进入偏好设置页勾选 Proxy videos 选项。开启后,Invidious 实例将作为你和 Google 服务器之间的中继(也叫代理),隐藏你的 IP 地址及浏览器发出的其他信息。
常见错误/问题 Q: 媒体无法加载…… A: 此问题可能出现在不同场景: 如果你是 Invidious 的部署者,请阅读 All the YouTube error messages explained with solutions 页面 如果你正在尝试观看一段音乐片段,YouTube 很可能封锁了视频流。建议在偏好设置中启用 Proxy videos(或在 URL 里加 &local=1)。也可以换用其他实例,因为这类内容经常受地域限制。 YouTube 经常会向 hd720、medium 和 small 画质发送损坏的视频数据。多次刷新页面(5–7 次)通常能解决。你也可以把偏好的视频画质设为 dash(或在 URL 里加 &quality=dash)。 偶发情况下,也可能是实例内部故障导致视频流拉取失败,刷新一次页面通常可恢复。 如果上述方案都无效,试试切换实例;仍不行的话,就只能回 YouTube 本体看了(抱歉,不方便之处请谅解)。
Q: Could not check out a connection in 2.0 seconds (DB::PoolTimeout) A: 请勿在 GitHub 上提 bug 报告,我们无能为力! 你正在使用的实例存在数据库问题。请改用公共实例列表里的其他实例。
Q: DB::PoolRetryAttemptsExceeded A: 你正在使用的实例数据库出现问题。请改用公共实例列表中的其他实例。 如果你是实例管理员,请先尝试重启 Invidious,然后尝试重启 PostgreSQL。如果问题仍未解决,请尝试增加允许的最大连接数。 某些发行版会将默认连接数设置得较低。 Q: 字幕无法使用! A: 字幕(也称“封闭式字幕”)在主流的 Invidious 实例上通常无法正常工作,这是由于来自 Google 服务器的 URL 频率限制所致。 要解决这个问题,请尝试使用不太热门的公共实例,或自行托管 Invidious。 请查阅以下 Issue 以获取更多详情: https://github.com/iv-org/invidious/issues/2567
Q: 哪里可以找到 360p/480p/1080p 画质选项? A: 这些画质选项仅在启用 DASH 时可用。 要启用 DASH,请进入偏好设置,将首选视频画质设为“DASH”。 请注意,DASH 需要 Javascript,且可能会被实例管理员禁用。因此,如果你无法使用该选项,请尝试切换到其他实例。 默认情况下,DASH 是未启用的,以便允许在没有 Javascript 的情况下播放视频,同时节省带宽(DASH 必须通过代理才能正常工作,这会占用大量实例带宽)。
运行你自己的实例 Q: 你们提供预编译的二进制文件(.deb、.rpm 等)吗? A: 由于 Invidious 采用滚动发布模式,我们目前不提供这些文件。请改为获取最新克隆或从 master 分支拉取最新提交。
Q: 如何配置 [某项]? A: 请阅读示例配置文件(config/config.example.yml)。 所有支持的配置选项都在其中有文档说明。
Q: RSS 订阅/链接等 URL 重定向到 :3000,但我有反向代理! A: 请确保根据你的环境正确设置以下参数: - https_only:如果你的实例通过 HTTPS 提供服务 - domain:如果你有重定向到该实例的域名 - external_port:如果你的实例通过不同于监听端口的端口访问(例如,你的实例监听在 :3000,但通过反向代理在 :443 上可用,则将 external_port 设为 443)
Q:我实例上的“热门”页面怎么是空的! A:“热门”内容是根据你实例上已注册用户的观看热度生成的。如果没有人注册账号(比如关闭了注册),热门页面自然就是空的。
Q:我既无法登录,也无法保存偏好设置! A:请仔细检查你的配置!domain 配置项的值会用于会话(SID)和偏好设置(PREFS)的 Cookie。如果设置不对,Cookie 就会失效,浏览器会静默忽略它们。 如果你是通过 IP 地址访问 Invidious 实例的(比如 192.168.1.205),那就把 domain 配置项留空! 常见的错误写法包括: - 直接填 IP 地址(比如 192.168.1.205) - 在域名前加了协议(https://example.com) - 在域名后带了端口(example.com:3000) - 域名拼写错误(写成 .cm 而不是 .com)

评论 (0)