Yoinks 终端视频下载完整指南：1800+ 站点一键拉取，开源替代 4K Video Downloader（2026）
你有没有过这种体验：想保存一段教程视频或喜欢的 MV，打开网页版转换器，先弹三个广告，再假装点”下载”结果跳转到博彩网站？
如果你习惯在终端里干活，Yoinks 就是为你准备的——粘贴链接，选分辨率，回车，完事。没有弹窗，没有假按钮，没有奇怪的跳转。
一、Yoinks 是什么：终端里的视频下载器
Yoinks 是一款开源的终端视频下载应用，由 @pablostanley 开发，基于成熟的 yt-dlp 引擎，但用 Ink（React for Terminal）重新包装了一个漂亮的交互式界面。
核心定位：个人视频归档工具。它不是爬虫，不是批量下载器，而是一个让你「少开浏览器」的轻量终端应用。
支持平台：YouTube、X/Twitter、Instagram、Threads、TikTok，以及 1800+ 其他站点（任何 yt-dlp 支持的网站它都支持）。
2026 年最新动态：
- GitHub 持续活跃，已被 SourceForge 镜像收录
- Reddit r/BestGitHubRepos 社区热议（60+ 评论）
- 被 opensourcealternatives.to 推荐为 4K Video Downloader Plus 的开源替代
- 多个技术博客在 2026 年最佳开源视频下载器评测中提及
二、核心特性：为什么选 Yoinks 而不是直接用 yt-dlp
你可能会问：既然底层是 yt-dlp，我为什么不直接用 yt-dlp？
好问题。答案是交互体验。
2.1 可视化格式选择器
yt-dlp 的格式选择是这样的：
$ yt-dlp -F https://youtu.be/xxxxx
ID EXT RESOLUTION FPS | FILESIZE TBR PROTO
...（20 行密密麻麻的表格）Yoinks 的格式选择是这样的：
┌─ Format ──────────────────────────────┐
│ 1. 1080p (MP4) ~120 MB │
│ 2. 720p (MP4) ~65 MB │
│ 3. 480p (MP4) ~35 MB │
│ 4. Audio only (MP3) ~8 MB │
│ ↑/↓ 选择 Enter 确认 Esc 返回 │
└───────────────────────────────────────┘每个选项旁边直接标注了预估文件大小，不用再心算 TBR × 时长 = ?。
2.2 零配置依赖
Yoinks 首次运行时会自动下载 yt-dlp 独立二进制到 ~/.yoinks/bin，不需要 Python 环境。ffmpeg 也会通过 ffmpeg-static 作为内置后备。这意味着：
- Windows 用户不用装 Python
- macOS 用户不用
brew install yt-dlp ffmpeg - Linux 用户不用折腾虚拟环境
2.3 全屏交互式 UI
Yoinks 接管整个终端（居中显示），退出时恢复你的滚动缓冲区。支持：
- 键盘操作：↑/↓、j/k、数字键、Enter、Esc、Ctrl+C
- 鼠标操作：点击 Yoink 按钮、格式列表、底部提示
- 主题切换：
auto（跟随终端主题）、light、dark，按Ctrl+T实时切换
2.4 自动保存与路径提示
文件默认保存到 ~/Downloads，下载完成后在终端打印完整路径，方便后续操作。
三、安装与部署：三平台指南
3.1 前置要求
- Node.js 18+（必须）
- 网络可访问 npm registry
检查 Node 版本：
node -v
# 需要 v18.0.0 或更高3.2 Windows 安装
# 方法 1：全局安装
npm install -g yoinks
# 方法 2：免安装直接运行
npx yoinks
# 方法 3：如果还没装 Node.js
# 去 https://nodejs.org 下载 LTS 版本安装3.3 macOS 安装
# 使用 Homebrew 安装 Node（如果还没有）
brew install node
# 全局安装 Yoinks
npm install -g yoinks
# 或者免安装
npx yoinks3.4 Linux 安装
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g yoinks
# Arch Linux
sudo pacman -S nodejs npm
sudo npm install -g yoinks
# Fedora
sudo dnf install nodejs npm
sudo npm install -g yoinks3.5 验证安装
yoinks --version
# 或
npx yoinks --version四、使用教程：从入门到熟练
4.1 基础用法
# 直接带 URL，进入格式选择器
yoinks https://youtu.be/dQw4w9WgXcQ
# 不带参数，交互式提示输入 URL
yoinks
# 指定主题
yoinks --theme light
yoinks --theme dark4.2 操作流程
- 运行
yoinks <URL>（或裸运行yoinks后粘贴 URL） - 界面显示可用格式列表（视频分辨率 + 音频）
- 用 ↑/↓ 或数字键选择格式
- 按 Enter 确认下载
- 等待下载完成，文件保存到
~/Downloads - 按 Esc 返回主页，或 Ctrl+C 退出
4.3 批量下载场景
目前 Yoinks 的 Roadmap 中尚未实现批量/播放列表下载（见下文）。如果你需要批量下载，可以暂时用 yt-dlp 直接处理：
# 下载整个播放列表
yt-dlp https://www.youtube.com/playlist?list=PLxxxxxx
# 下载频道所有视频
yt-dlp https://www.youtube.com/@channelYoinks 的 Roadmap 已列出 Playlist / thread-with-multiple-videos support，未来版本会加入。
五、高级技巧与配置
5.1 利用已有 yt-dlp
如果你已经安装了 yt-dlp，Yoinks 会自动检测并使用你的版本，而不是下载独立的二进制：
# 检查 Yoinks 使用的 yt-dlp 路径
ls ~/.yoinks/bin/
# 如果你 PATH 中有 yt-dlp，Yoinks 会优先使用它5.2 主题自定义
# 跟随终端主题（推荐）
yoinks --theme auto
# 强制浅色
yoinks --theme light
# 强制深色
yoinks --theme dark
# 运行中按 Ctrl+T 循环切换5.3 配合剪贴板使用
虽然 Yoinks 尚未实现自动剪贴板检测（Roadmap 中），但你可以用 shell 快捷方式实现类似效果：
# ~/.bashrc 或 ~/.zshrc
alias yoink='yoinks $(xclip -o -selection clipboard 2>/dev/null || pbpaste)'
# 使用：复制 URL 后直接运行
yoinkmacOS 上用 pbpaste，Linux 上用 xclip 或 xsel。
5.4 代理设置
如果需要通过代理下载（比如某些地区的 YouTube），Yoinks 继承 yt-dlp 的代理支持：
# 环境变量方式
export https_proxy=http://127.0.0.1:7890
yoinks https://youtu.be/xxxxx
# 或者一次性
https_proxy=http://127.0.0.1:7890 yoinks https://youtu.be/xxxxx5.5 下载速度优化
下载速度慢通常不是 Yoinks 的问题，而是 yt-dlp 或网络的问题：
# 1. 更新 yt-dlp（Yoinks 会自动更新其内置版本）
# 如果你用的是系统 yt-dlp：
pip install -U yt-dlp
# 2. 使用并发下载（yt-dlp 原生支持）
# Yoinks 目前未暴露此选项，但可以直接用 yt-dlp：
yt-dlp --concurrent-fragments 4 https://youtu.be/xxxxx
# 3. 检查是否是单线程限制
# 某些平台（如 YouTube）的 1080p+ 视频需要合并音视频流
# 确保 ffmpeg 已安装（Yoinks 会自动处理）六、对比评测：Yoinks vs 同类方案
| 特性 | Yoinks | yt-dlp | 4K Video Downloader | JDownloader 2 | Stacher |
|---|---|---|---|---|---|
| 开源 | ✅ MIT | ✅ | ❌ 免费版有限制 | ✅ GPL | ✅ |
| 终端 UI | ✅ 交互式 | ❌ 纯命令行 | ❌ GUI | ❌ GUI | ❌ GUI |
| 支持站点 | 1800+ | 1800+ | 有限 | 1000+ | 基于 yt-dlp |
| 安装难度 | 低（npm） | 中（需 Python） | 低（安装包） | 中（Java） | 低（Electron） |
| 广告 | 无 | 无 | 免费版有 | 无 | 无 |
| 批量下载 | ❌ 计划中 | ✅ | ✅ 付费版 | ✅ | ✅ |
| 播放列表 | ❌ 计划中 | ✅ | ✅ 付费版 | ✅ | ✅ |
| 自动更新 | ❌ 计划中 | ✅ | ✅ | ✅ | ✅ |
| 系统资源 | 极低 | 低 | 中 | 高（Java） | 高（Electron） |
总结：
- 选 Yoinks：你是终端用户，偶尔下载几个视频，讨厌广告和 GUI 臃肿
- 选 yt-dlp：你需要批量/脚本化下载，或需要最细粒度的控制
- 选 4K Video Downloader：你完全不想碰命令行，且愿意为高级功能付费
- 选 JDownloader 2：你需要下载各种文件（不只是视频），且习惯 Java 生态
- 选 Stacher：你想要 yt-dlp 的能力但需要 GUI 包装
七、实际应用场景
7.1 教程离线观看
程序员看教程是日常。把 YouTube 教程拉到本地，地铁上、飞机上都能看：
yoinks https://youtu.be/xxxxx
# 选 1080p，保存到 ~/Downloads，拷到平板7.2 素材收集
设计师/剪辑师收集参考素材：
# 下载 Instagram 参考视频
yoinks https://www.instagram.com/reel/xxxxx
# 下载 TikTok 灵感视频
yoinks https://www.tiktok.com/@user/video/xxxxx7.3 音频提取
只需要音频？选 Audio only (MP3)：
yoinks https://youtu.be/xxxxx
# 选 "Audio only (MP3)"，自动提取音频7.4 个人视频归档
保存自己喜欢的创作者内容，防止平台下架：
# X/Twitter 上的技术分享
yoinks https://x.com/user/status/xxxxx
# Threads 上的短视频
yoinks https://www.threads.net/@user/post/xxxxx八、常见问题解答（FAQ）
Q1：Yoinks 支持哪些网站？
Yoinks 基于 yt-dlp，支持 1800+ 网站，包括 YouTube、X/Twitter、Instagram、Threads、TikTok、Bilibili、Vimeo、Dailymotion 等。任何 yt-dlp 支持的网站，Yoinks 都支持。完整列表见 yt-dlp 支持的站点。
Q2：如何安装 Yoinks？
需要 Node.js 18+。运行 npm install -g yoinks 全局安装，或 npx yoinks 免安装直接运行。首次启动时 Yoinks 会自动下载 yt-dlp 和 ffmpeg，无需额外配置。
Q3：下载速度慢怎么办？
下载速度取决于网络环境和目标平台。可以尝试：1) 更新 yt-dlp（pip install -U yt-dlp 或让 Yoinks 自动更新）；2) 检查代理设置（export https_proxy=...）；3) 对于 1080p+ 视频，确保 ffmpeg 已安装（Yoinks 会自动处理）。
Q4：支持批量下载或播放列表吗？
目前 Yoinks 的 Roadmap 中已列出播放列表支持，但尚未实现。如果你需要批量下载，建议直接使用 yt-dlp（yt-dlp <playlist-url>）。Yoinks 未来版本会加入此功能。
Q5：Yoinks 是免费的吗？
是的，Yoinks 完全免费且开源（MIT 许可证）。没有广告，没有付费版，没有功能限制。你可以自由使用、修改和分发。
九、Yoinks 的局限与 Roadmap
诚实说，Yoinks 目前还不是一个”全能”下载器。以下是它的已知局限：
当前缺失：
- ❌ 批量下载 / 播放列表支持
- ❌ 自定义输出目录（
-o <dir>） - ❌ 命令行快捷标志（
--best/--mp3） - ❌ 自动剪贴板检测
- ❌ yt-dlp 自动更新
Roadmap（来自 GitHub）：
- ✅ 已发布到 npm（
npm i -g yoinks/npx yoinks） - ⏳
--best/--mp3标志（跳过选择器，适合脚本） - ⏳
-o <dir>选择输出文件夹 - ⏳ 播放列表 / 多视频帖子支持
- ⏳ 剪贴板检测：裸启动时自动建议复制的 URL
- ⏳ 内置 yt-dlp 自更新（
yt-dlp -U） - ⏳
curl yoinks.sh | sh一键安装器
如果你需要脚本化、自动化、批量处理，yt-dlp 仍然是更好的选择。Yoinks 的价值在于交互式体验——它让偶尔下载视频这件事变得更愉快。
十、总结：Yoinks 适合谁？
Yoinks 适合你，如果：
- 你是终端重度用户，讨厌为下载视频打开浏览器
- 你偶尔下载几个视频，不需要批量/播放列表功能
- 你欣赏开源、无广告、无套路的工具
- 你想要 yt-dlp 的能力但不想记那些复杂的命令行参数
Yoinks 不适合你，如果：
- 你需要批量下载整个频道或播放列表
- 你需要完全脚本化、可自动化的工作流
- 你完全不想碰命令行（选 4K Video Downloader 或 Stacher）
Yoinks 的哲学很简单：粘贴，选格式，回车，完事。在视频下载器这个被广告和恶意软件污染的领域，它是一股清流。
希望这篇博客文章对您有所帮助！
相关链接：
- Yoinks GitHub 仓库
- yt-dlp 项目
- Ink - React for Terminal
- opensourcealternatives.to - Yoinks
- FreeAITool 开源工具系列 | 命令行工具推荐
