TeamPiped/Piped

项目介绍

Piped 是一个 YouTube 替代前端。它通过 NewPipeExtractor 获取视频信息，不调用 YouTube 官方 API，再由 Piped 自己的 API 和公共实例完成播放，目标是无广告、无跟踪，并且不直接连接 Google 服务器。

前端提供登录、动态、播放列表、订阅、无限滚动、明暗主题、纯音频播放、4K 和 PWA 安装，偏好保存在本地。它还集成 SponsorBlock、LBRY 推流，并通过 RYD-Proxy 显示 Return YouTube Dislike，支持嵌入式播放。项目提供公开的 JSON API，并记录实例之间基于 Matrix 的联邦协作。

它适合不想用 Google 账号、希望无广告看 YouTube 的观众，也适合想自建实例的运维者。

快速使用

普通用户直接打开公共实例 piped.video 即可，无需安装。更多社区实例见 公共实例文档。注册账号后可以使用动态和播放列表，入口在注册页。

要在本地运行前端，在仓库根目录安装依赖并启动开发服务器：

pnpm install
pnpm dev

开发构建会随文件修改热更新。README 的开发章节没有给出后端/API 的启动命令；自建完整实例见自托管文档，API 规范在 OpenAPI 仓库。

自建与 API

完整实例由前端和 Piped API 后端两部分组成，前端通过实例设置指定 API 地址。自托管步骤记录在 docs.piped.video，并提供 OpenAPI 规范。由于前后端是独立服务，上面的 pnpm dev 只覆盖 Vue 前端。

使用约束

Piped 依赖非官方的数据提取方式，播放能否可用取决于提取器是否仍能工作，以及 API 实例是否可访问。公共实例可能被封锁或限流；README 对地理限制的表述是“尽可能通过联邦网络绕过”。项目声称无年龄限制，但这同样取决于提取层。

项目采用 AGPL-3.0，修改后对外提供网络服务需要履行源码公开义务。若想把 YouTube 链接自动跳转到 Piped，推荐使用 Piped-Redirects、Libredirect 或 Predirect。

HotRepo 点评

Piped 在 Hacker News 至少有两次较有分量的讨论：2021 年 7 月获得 265 分、230 条评论，2023 年 10 月获得 315 分、127 条评论。讨论里能看到实际使用生态：有人提到 Invidious 作为替代，有人推荐用 Yattee 同时连接 Piped 和 Invidious，也有人介绍基于 Piped 的 Android 应用 LibreTube，支持账号同步和代理播放。另有一条 2022 年关于 Cloudflare 封锁 Piped 的相关讨论，说明公共实例的可用性属于实际运维依赖，并不是稳定保证。