你是否也有过这样的矛盾：离不开YouTube的内容生态，却又厌倦了Google的追踪、算法的绑架、以及在不同设备间反复登录的繁琐？
现有的替代方案各有短板：FreeTube只支持桌面，NewPipe只支持Android手机，Invidious虽好但缺乏原生App体验。而今天介绍的 TubeHaus，试图给出一个全平台统一答案。
- GitHub：https://github.com/biolend83/tubehaus
- 网盘：https://pan.quark.cn/s/9fe56d42eab4 提取码：uiE5
它有两种形态：自建服务器版和独立应用版，两者可联动共享媒体库。外观和操作完全复刻YouTube（相同的布局、相同的快捷键），但你的订阅、历史和推荐全部掌握在自己手中。
1. 两种形态，按需选择
| 🖥️ 服务器版 | 📱 应用版 | |
|---|---|---|
| 部署方式 | Docker Compose 部署在 VPS/NAS/树莓派 | 各平台独立安装包 |
| 观看方式 | 任意浏览器（含iPhone/iPad无需侧载） | 原生应用（Android/iOS/Win/Mac/Linux） |
| YouTube通信 | 服务器通过 Invidious + Cloudflare WARP | 设备直连（或连接你的服务器） |
| 隐私保护 | YouTube只看到WARP地址，设备零暴露 | 设备IP可见，但无Google账号/追踪 |
| 媒体库 | 服务器上，全家/全设备共享 | 本地存储，或连接服务器同步 |
| 独有功能 | 实时字幕(whisper.cpp)、发送到电视、全质量下载 | 离线下载、后台播放、画中画、mpv播放器 |
💡 最佳实践：自 0.5.4 起，应用可连接到你的 TubeHaus 服务器。服务器负责隐私和共享媒体库，应用负责原生播放体验——鱼与熊掌兼得。
2. 服务器版核心亮点
⚡ 极致性能
- 视频页面本地缓存+预获取，冷启动1-2秒，热启动毫秒级
- 直播不卡顿：服务器保持活动连接预拉分段，时间线永不跳动
- 始终最佳质量：偏好60fps+硬件解码编解码器，掉帧时切换编解码器而非降分辨率
🔒 彻底私密
- 设备从不与Google通信，浏览器中无Cookie、无YouTube脚本
- 所有YouTube流量经Cloudflare WARP，YouTube永远看不到你的真实IP
- 无账号、无遥测，媒体库是你服务器上的文件
🎙️ 实时字幕
- YouTube不为直播提供字幕？TubeHaus用whisper.cpp在单核CPU上实时转录
🧠 本地学习的Shorts推荐
- 根据你的观看时长、循环、点赞、划走在服务器上学习偏好
- 每第四个位置留给新内容，随时可重置，什么都不离开你的服务器
🌿 平静模式
- 一键将YouTube变回工具：只显示订阅新视频，Shorts/热门/推荐全部消失，视频结束不自动播放，评论默认折叠
3. 与 FreeTube / NewPipe 的区别
| TubeHaus | FreeTube | NewPipe | |
|---|---|---|---|
| 平台覆盖 | Android/TV/Win/Mac/Linux/iOS + 浏览器 | Win/Mac/Linux | Android手机/平板 |
| UI风格 | 完全复刻YouTube | 自有设计 | 自有设计 |
| 多设备共享媒体库 | ✅ 可选服务器同步 | ❌ 手动导入导出 | ❌ 手动导入导出 |
| 电视适配 | ✅ 遥控器导航 | ❌ | ⚠️ 可用但非专为电视设计 |
| 成熟度 | 2026年新生项目 | 2018年起，庞大社区 | 2015年起，F-Droid老牌 |
选择建议：只需桌面→FreeTube；只需Android手机→NewPipe；想要全平台统一体验+可选共享媒体库→TubeHaus。
4. 快速部署（Docker一条命令）
git clone https://github.com/biolend83/tubehaus && cd tubehaus
cp .env.example .env # 设置域名和密钥
docker compose pull # 预构建镜像（amd64/arm64）
docker compose up -d
内置 Caddy + Cloudflare WARP + Invidious + companion + PostgreSQL + whisper.cpp，开箱即用。
⚠️ 安全提醒：TubeHaus没有账号系统。若要暴露到公网，务必在.env中配置TUBEHAUS_AUTH=basic或在前面加Authelia/Authentik，否则所有人共享同一个媒体库。也可通过Tailscale/WireGuard私网访问。
5. 应用获取方式
| 平台 | 获取方式 |
|---|---|
| Android | APK直接安装 / Obtainium更新 / Android TV Downloader代码3155410 |
| Windows/macOS/Linux | GitHub Releases / Scoop / Homebrew / AUR |
| iPad/iPhone | Sideloadly侧载.ipa（免费Apple ID每7天重签） |
6. 数据自由：导入导出不被困住
- 导入：Google Takeout、Invidious、NewPipe、FreeTube导出、OPML
- 导出：完整TubeHaus备份、Invidious格式、Takeout风格CSV、OPML
你的数据永远属于你，随时可以带走。
在这个算法主导注意力的时代，能把视频平台变回“我想看什么就看什么”的工具，本身就是一种奢侈。TubeHaus让这种奢侈变得触手可及。
