FreeTube 上手实录：无广告看 YouTube，订阅与观看记录全部存在本地

FreeTube 是一款开源自带的隐私视频桌面客户端：无广告播放、不被 cookies 和脚本追踪，订阅、历史、播放列表都只存在本地。本文带你完成安装、首次启动的关键决策和常见故障排查。

一个真实场景

网页版 YouTube 的广告先播 5 秒，右侧"为你推荐"还一直在猜你想看什么。FreeTube 是独立的桌面程序，没有广告，也没有 Google 的追踪脚本在后台运行。最爽的时刻是：你的订阅更新、观看历史、播放列表全在自己设备上，随时可以导出，也可以一键清空。

装之前先确认

Linux 用 Flatpak 最省事，一行装完：

flatpak install flathub io.freetubeapp.FreeTube

AppImage 则不用安装，下载后双击就能跑，适合先试试再说。

首次启动的三个关键决策

首次启动会问你语言和数据来源，这两项选错了后面会一直别扭。

1. 数据提取器（数据从哪来）。两个选项：
   • 内置提取器（local）：你的设备直接请求 YouTube，不依赖任何第三方服务器，简单稳定，但你的 IP 对 YouTube 可见；
   • Invidious API：请求经社区运营的 Invidious 实例（提供 YouTube 数据的公开中转服务）中转，隐蔽性更好，但依赖实例的稳定性。
   • 怎么选：新手先用内置的；想要更强匿名再切 Invidious，并记得在设置里开启"失败时回退到内置提取器"，实例挂了不至于完全看不了。
2. 语言。自带 80 种语言翻译，直接选简体中文，无需额外配置。
3. 默认实例与首页。用 Invidious 时必须指定一个实例并可设为默认；落地页可选订阅动态、热门或指定页面，建议选订阅动态——打开 App 第一眼就是你想看的内容。

按需调优 ✨

我想要更强的隐私

• 设置里的"代理设置"可接入 Tor 或普通代理，连接后点"测试代理"能看到出口 IP 是否已变化；
• "隐私设置"里可关闭观看历史和搜索历史记录，并一键清空本地数据；
• 用 Invidious 时匿名程度取决于实例，建议选更新频繁、社区维护的实例。

我想要界面更顺眼

• 20 套以上基础主题（Nordic、Gruvbox、Solarized、Catppuccin 等），还能单独调主色和 UI 缩放；
• "免打扰设置"可隐藏播放量、订阅数、相关推荐，甚至按关键词过滤视频；
• 侧边栏标签、顶栏 logo、平滑滚动都有独立开关，改完重启生效。

我想要更干净的播放体验

• 开启 SponsorBlock，自动跳过赞助片段；
• 开启 DeArrow，替换点击诱饵式的标题和缩略图；
• 播放器支持截图、画中画小窗和外部播放器播放。

出问题了看这里 ⚠️

接下来去哪

• 通用设置界面与全部开关项源码，想知道某个选项具体管什么，看这里；
• 数据访问层实现，内置提取器与 Invidious 请求的分流就写在这；
• 本地化翻译文件，80 种语言的界面文本都在这里。

发现 bug 时先搜一下仓库里有没有同类 issue，没有再提一个，开发者能少处理一半重复工单。