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

第11章 YouTube 常见错误信息详解及解决方案

所有 YouTube 错误信息详解及解决方法 免责声明:如果你只是公共实例的普通用户,本文档不适用于你。请把这个页面转给你的 Invidious 实例维护者,或者换一个公共实例:https://instances.invidious.io 错误:非 200 状态码。YouTube API 返回了状态码 429 错误说明 YouTube 正在限制你发送到其服务器的流量。此错误可能持续出现 24 小时。 原因 通常与刷新订阅时产生了大量流量有关。 你修改了 channel_refresh_interval 参数,导致订阅刷新过于频繁,让 YouTube 不堪重负。 你订阅了太多频道。由于 Invidious 需要检查大量频道的新视频,YouTube 可能会将其判定为滥用行为。 你以其他方式发送了大量流量,比如调用了 Invidious API。 你的网络中有人在向 YouTube 发送大量流量。 解决方法 尽量保持 channel_refresh_interval 参数处于注释状态,让 Invidious 降低刷新订阅的频率。 退订一些频道。虽然这可能不太理想,但确实能减少发送到 YouTube 的数据量。 配置 pubsub:/installation/#post-install-configuration。这要求你的 Invidious 必须能通过公网域名在互联网上访问。
之后你可以尝试延长刷新间隔,比如设置为 channel_refresh_interval: 240m。
虽然 pubsub 能确保新视频上线时几乎即时收到通知,但这种方式能显著减少向 YouTube 服务器发起的刷新请求。因为 pubsub 是 YouTube 用于通知你的 Invidious 实例有新视频的方法。 更改你的公网 IP 地址。这可能无法永久解决问题,但能暂时缓解。 向社区求助:https://invidious.io/contact/。请勿直接联系团队,我们不会通过邮件提供帮助。仅在 Matrix 或 IRC 中提问。 Sign in to confirm you are not a bot - This helps protect our community(请登录以确认你不是机器人——这有助于保护我们的社区) 错误解析 YouTube 正在屏蔽 Invidious 与其服务器之间的通信。 原因 YouTube 部署了多种机制来检测非官方客户端的使用。你的 Invidious 实例可能已被其系统检测到。 你的 IP 地址被 YouTube 服务器列入黑名单。已知 YouTube 会封锁数据中心和 VPN 的 IP 地址。 解决方案 首先确保你正在运行最新版本的 Invidious,并且使用了 Invidious companion。请参阅更新后的安装指南。 之后,你可以尝试以下方案: 更改你的公网 IP 地址。重启路由器,或在 Invidious companion(而非 Invidious)中配置代理:https://github.com/iv-org/invidious-companion/blob/b0fcfa49e21b708adcdf9fbf15c82c75cf0002a4/config/config.example.toml#L33 如果托管 Invidious 的计算机支持 IPv6,可以尝试轮换你的 IPv6 公网地址,教程见此:“轮换 IPv6 地址以规避 YouTube 封锁” 向社区求助:https://invidious.io/contact/。请勿直接联系团队,我们不会通过邮件提供帮助。仅在 Matrix 或 IRC 中提问。 上述所有方案均不保证能让 Invidious 恢复正常工作。这些只是尝试解除 Invidious 实例在 YouTube 上被封锁状态的建议。报告问题时,务必详细说明对 Invidious 所做的任何修改。 PO Token 初始化耗时过长 消息解析 Invidious companion 正在尝试针对 YouTube 服务器创建一个有效的 PO Token,但失败了。 创建有效的 PO Token 通常应在 1 分钟内完成。 原因 YouTube 部署了多种机制来检测非官方客户端的使用。你的 Invidious 实例可能已被其系统检测到。 你的 IP 地址被 YouTube 服务器列入黑名单。已知 YouTube 会封锁数据中心和 VPN 的 IP 地址。 Player ID 发生了变化。YouTube 拥有用于加密视频的具体播放器。Invidious companion 无法解密新的播放器。 诊断步骤 使用浏览器访问 https://www.youtube.com,并配置 Invidious companion 所用的 IP 地址。如果服务器没有图形界面,可使用服务器上的 socks 代理(ssh -D)。 尝试播放视频。如果出现“Sign in to confirm you are not a bot - This helps protect our community”(请登录以确认你不是机器人——这有助于保护我们的社区)提示,说明你的 IP 被 YouTube 封锁了。 你也可以查看 Invidious companion 的日志以了解具体情况。如果使用 Docker Compose,运行命令: docker compose logs -f companion 解决方案 首先确保你正在运行最新版本的 Invidious,并且使用了 Invidious companion。请参阅更新后的安装指南。 如果已确认被封锁,可尝试以下方案: 更改你的公网 IP 地址。重启路由器,或在 Invidious companion(而非 Invidious)中配置代理:https://github.com/iv-org/invidious-companion/blob/b0fcfa49e21b708adcdf9fbf15c82c75cf0002a4/config/config.example.toml#L33 如果托管 Invidious 的计算机支持 IPv6,可以尝试轮换你的 IPv6 公网地址,教程见此:“轮换 IPv6 地址以规避 YouTube 封锁” 向社区求助:https://invidious.io/contact/。请勿直接联系团队,我们不会通过邮件提供帮助。仅在 Matrix 或 IRC 中提问。 上述所有方案均不保证能让 Invidious 恢复正常工作。这些只是尝试解除 Invidious 实例在 YouTube 上被封锁状态的建议。报告问题时,务必详细说明对 Invidious 所做的任何修改。 如果并未被封锁,这可能是 companion 尚不支持的 Player ID 变更所致。若情况属实,请先查阅 GitHub issues 看是否已有相关报告。只有在确认没有现有 issue 的情况下,才创建新的 GitHub issue。 Videoplayback URLs 返回 403 HTTP 错误 错误解析 YouTube 禁止你从其“googlevideo.com”服务器观看或下载视频。查看频道页面等其他功能可能仍正常。 原因 该错误有不同的根本原因: 你正在加载的视频流仅限生成该 URL 的 IP 地址访问。例如,这常发生在音乐视频或受版权保护的内容上。 你或你网络中的其他人下载了大量视频,导致你的 IP 地址被 YouTube 服务器封锁。 向社区求助:https://invidious.io/contact/。请勿直接联系团队,我们不会通过邮件提供帮助。仅在 Matrix 或 IRC 中提问。 解决方案 首先确保你正在运行最新版本的 Invidious,并且使用了 Invidious companion。请参阅更新后的安装指南。 之后,你可以尝试以下方案: 更改你的公网 IP 地址。重启路由器,或在 Invidious 中配置代理:https://github.com/iv-org/invidious/blob/2150264d849771df8f15bab172ab6d87eeb80c55/config/config.example.yml#L176-L185 如果托管 Invidious 的计算机支持 IPv6,可以尝试轮换你的 IPv6 公网地址,教程见此:“轮换 IPv6 地址以规避 YouTube 封锁” 如果是音乐视频或受版权保护的内容,请确保视频是从生成该视频 URL 的同一 IP 地址加载的。

评论 (0)