🎬 Piped：隐私优先 YouTube 代理无广告自部署 AGPL 开源

🎬 Piped 是一款 AGPLv3 开源的 YouTube 隐私代理前端，无广告、不追踪、自建实例可 Docker 一键部署。支持 30+ 公共节点、LibreTube 等移动 App、前端生态丰富，4,919 次 commit 活跃维护，文末附详细使用教程

🎤 引言

YouTube 的隐私政策有多离谱？它收集你的：政治倾向、音乐品味、搜索想法、观看历史、兴趣画像——比你自己还了解你。更别说那越来越频繁的「请停用广告屏蔽器」弹窗，和永远刷不完的信息流推荐。

Piped 的出现就是为了打破这个局面。

它是一个开源 YouTube 前端，通过自建代理让你绕过 YouTube 的追踪和广告，同时保留完整的视频访问能力。4,919 次 commit，30+ 公共实例可用，LibreTube（Android）、App Store 应用（iOS）全套移动生态，全部围绕同一个 API 构建。

你不需要信任任何第三方服务器——自己搭一个，五分钟跑起来。

⭐ 核心功能

无广告、不追踪——Piped 本身不注入任何广告脚本，也不记录你的观看历史、IP 地址或个人身份。YouTube 的跟踪 cookie 和推荐算法被代理层隔断，你只是在看视频，不是在被分析。
隐私友好的代理架构——Piped 服务器只请求 YouTube 视频流数据，不携带你的个人身份信息。观看时 YouTube 只能看到 Piped 实例的 IP，看不到你的真实来源。这跟使用 VPN 的逻辑类似，但 Piped 额外处理了视频解码和页面渲染。
30+ 公共实例可选——不想自建？直接用公共实例。官方维护的实例列表（pipedapi.kavin.rocks/piped.yt/projectsegfau.lt 等）分布在德国、美国、法国、芬兰等多个地区，可按延迟和可用性自由选择，用完即走。
Docker 一键自建——git clone → ./configure-instance.sh → docker-compose up，五分钟后你就有了自己的 Piped 实例。配置文件在 instances.yml 里，支持自定义实例名称、是否开启注册、API 限流策略。自建实例数据完全自主，零第三方依赖。
多端 App 生态——Piped 的 API 是开放的，基于它衍生了完整的移动生态：LibreTube（Android，最成熟）、App Store 的 Piped-iOS（iOS 客户端），以及各种第三方 Web 前端（用 Piped API 的）。一个后端，多个前端，按需选择。
字幕搜索与内嵌——内置字幕搜索功能，支持 WebVTT 字幕内嵌显示。看生肉视频不用再手动找字幕文件。
视频/音频分离——可以单独提取音频流，适合后台听音乐、播客，不用开画面。用法：在实例 URL 后加 /listen，直接进纯音频模式。
订阅源与播放列表——登录后可以订阅频道，同步到任意实例的订阅列表。播放列表功能完整，支持导入导出 OPML。
IPFS 构建——提供 IPFS 分布式构建，可通过 IPNS 访问文档站点，在中心化服务器被封的情况下仍有备用访问路径。
极活跃维护——4,919 次 commit（持续增长中），Matrix 社区活跃，翻译覆盖 30+ 语言，最近还在持续跟进 YouTube API 变化修 bug 和更新解码器。不用担心像 Invidious 那样突然停维护。

📥 安装与使用

方式一：直接用公共实例（30 秒上手）

访问以下任一实例（按延迟选最快的）：

https://piped.yt （德国）
https://piped.video （德国）
https://projectsegfau.lt （爱沙尼亚）
https://privacydev.net （法国）

打开后跟用 YouTube 一样搜索、播放，只是没有任何广告和追踪。第一次建议对比一下「piped.yt 打开视频」和「youtube.com 打开同一视频」——体验差距立竿见影。

方式二：自建实例（Docker，推荐有 VPS 的人）

# 1. 克隆 Docker 配置
git clone https://github.com/TeamPiped/Piped-Docker.git
cd Piped-Docker

# 2. 配置实例
./configure-instance.sh
# 按提示填写实例名、域名等

# 3. 启动
docker-compose up -d
# 默认端口 8080，用 Nginx 反代 + SSL

# 4. 配置 Nginx（可选，参考官方文档）

自建实例后，你拥有完整的数据控制权。配置 HTTPS 建议用 Certbot：

sudo snap install --classic certbot
sudo certbot --nginx -d your-piped-domain.com

浏览器重定向插件（推荐）：

安装 Piped-Redirects 或 Libredirect 浏览器插件，YouTube 链接自动跳转到你的 Piped 实例，实现无缝替换 YouTube 原站体验。

GitHub 仓库：https://github.com/TeamPiped/Piped
自建文档：https://github.com/TeamPiped/Piped-Docker
公共实例列表：https://github.com/TeamPiped/Piped#instances

🎯 适用场景

广告屏蔽器被 YouTube 弹窗困扰——Piped 完全绕过广告，不需要任何广告屏蔽器，也不用担心被检测。
注重隐私、拒绝追踪——不想让 Google 知道你在看什么。Piped 代理层隔断了 YouTube 对你的直接追踪，适合隐私敏感人群。
自建视频点播平台——有 NAS 或 VPS 的用户，可以用 Piped 搭建家庭媒体中心，所有人通过自建实例访问，没有外部依赖。
低配设备流畅看视频——YouTube 原站 JS 加载量巨大，低配设备容易卡顿。Piped 渲染更轻量，配合流媒体代理速度更快。
开发者集成——开放 API（/api/v1/）可自由调用，适合拿来做视频聚合、数据分析、自动化工具等二次开发。
规避地区限制——Piped 实例可以部署在任意地区，通过选择境外实例访问被地区锁定的视频内容（需自担风险）。

🔍 对比/替代方案

工具	类型	优点	缺点
Piped	自建代理 + 前端	极活跃、Docker 友好、移动端生态完整	需要维护实例
Invidious	类似方案	更老牌，社区更大	维护不如 Piped 活跃，部分实例被封
yt-dlp	CLI 下载工具	最全解码能力、下载功能强	无播放界面，纯下载
NewPipe	Android 专用	界面好、本地缓存、省流量	仅 Android
FreeTube	桌面客户端	全离线、YouTube 不感知	订阅同步需手动

如果你需要的不只是下载，而是完整的「隐私优先看 YouTube 体验」，Piped 是目前最活跃的自建方案。Invidious 出现更早，但 Piped 的 commit 频率和移动生态已经超过它。

⚠️ 注意事项

IP 封禁风险——YouTube 有能力识别并封禁来自自建 Piped 实例的请求（大流量访问时尤其明显）。公共实例被封了就换一个，自建实例可以用代理轮换或 IPv6 轮转绕过（YunoHost 集成讨论区有相关话题）。这是长久的猫鼠游戏，要有预期。
无 YouTube Premium 功能——Piped 不能让你免广告看 YouTube Red 内容（这些本身就是付费功能）。它去掉的只是 YouTube 网页/客户端本身插入的广告，不是绕过 YouTube Premium。
登录账号受限——部分实例不支持 YouTube 账号登录（需要自建实例 + 开启注册功能）。登录后可以同步订阅，但隐私性会略有下降（实例持有者理论上可以看到你的订阅列表）。
自建实例需要公网 IP 或内网穿透——家里宽带没有公网 IP 的话，需要内网穿透（Tailscale / Cloudflare Tunnel）或直接用有公网 IP 的 VPS。
视频质量依赖实例带宽——公共实例的带宽决定了播放流畅度。深夜可能很快，白天高峰期可能卡顿。自建或选一个带宽大的实例是解法。
不支持直播——Piped 目前不支持 YouTube 直播流，这是技术限制，短期内不一定能解决。看直播请回 YouTube 原站或用 streamlink。

✅ 总结

推荐指数：⭐⭐⭐⭐（4/5，扣一分因为 IP 封禁风险和实例维护成本）

适合：注重隐私的人、广告屏蔽器用户、自建 NAS/VPS 玩家、开发者做二次集成。

不适合：需要 YouTube 直播功能的人、完全没有技术背景不想折腾的普通用户（建议直接用公共实例，不需要自建）。

Piped 解决的是 YouTube 生态里最根本的问题：你只是想看视频，为什么要被追踪、被分析、被弹广告？ 它不完美——IP 封禁是长久的猫鼠游戏，自建实例有维护成本——但它是目前开源社区给出的最诚实的答案。

GitHub 仓库：https://github.com/TeamPiped/Piped
公共实例列表：https://github.com/TeamPiped/Piped#instances