常见问题
这里整理了用户最常提出的问题与官方解答。如果你的问题不在列表中,欢迎在 GitHub Issues 提交反馈,我们会持续更新这份文档。
安装与启动
ytDownloader 完全免费,永远不会收费。软件基于 GPL-3.0 开源协议发布,全部源代码在 GitHub 公开,任何人都可以自由使用、修改、分发。如果你在第三方网站看到收费版本,请勿上当,请只通过本官网
ytdownloader.cn 或 GitHub Releases 下载。
ytDownloader 支持 Windows 10 / 11、macOS 11 及以上版本、以及主流 Linux 发行版(Ubuntu、Fedora、Debian、Arch 等)。三个平台版本功能完全一致,持续同步更新。Windows 提供 exe / msi / zip 三种格式,macOS 提供 Apple Silicon 与 Intel 两套 dmg 镜像,Linux 提供 AppImage、Flatpak、Snap、deb、rpm 五种安装方式。
这是 macOS 的安全机制,因为 ytDownloader 是开源软件未通过 Apple 公证。首次启动时打开「系统设置 → 隐私与安全性」,滚动到底部会看到「已阻止 ytDownloader」的提示,点击「仍要打开」即可。或者在终端执行以下命令一次性解除隔离:
此外,macOS 用户需要通过 Homebrew 安装 yt-dlp 引擎:
sudo xattr -r -d com.apple.quarantine /Applications/YTDownloader.app此外,macOS 用户需要通过 Homebrew 安装 yt-dlp 引擎:
brew install yt-dlp。
Windows 与 Linux 安装包已内置 yt-dlp 与 FFmpeg,安装后即可使用,无需手动配置 PATH 或额外下载依赖。macOS 用户需要通过
brew install yt-dlp 安装 yt-dlp 引擎(FFmpeg 仍内置)。yt-dlp 会在软件内自动更新到最新版本,无需手动管理。
ytDownloader 内置 electron-updater 自动更新机制。新版本发布后会自动检测并提示,点击「立即更新」即可一键升级。AppImage 与 Microsoft Store 版本支持后台自动更新,其他格式(exe、dmg、deb 等)会提示有新版本,需手动重新下载安装包覆盖安装,你的偏好设置与历史记录会保留。
下载问题
排查步骤:
1. 更新 yt-dlp:YouTube 等平台会频繁更新反爬规则,yt-dlp 团队通常在 24 小时内发布应对更新。在偏好设置中点击「检查更新 yt-dlp」。
2. 检查网络:用浏览器打开目标视频链接确认能正常访问。如果是海外站点,请启用系统代理。
3. 查看错误日志:在偏好设置中开启详细日志,下载失败时会显示具体错误信息。
4. 提交反馈:在 GitHub Issues 提交问题,附上完整错误日志与视频链接,社区会快速响应。
1. 更新 yt-dlp:YouTube 等平台会频繁更新反爬规则,yt-dlp 团队通常在 24 小时内发布应对更新。在偏好设置中点击「检查更新 yt-dlp」。
2. 检查网络:用浏览器打开目标视频链接确认能正常访问。如果是海外站点,请启用系统代理。
3. 查看错误日志:在偏好设置中开启详细日志,下载失败时会显示具体错误信息。
4. 提交反馈:在 GitHub Issues 提交问题,附上完整错误日志与视频链接,社区会快速响应。
基于 yt-dlp 引擎,ytDownloader 支持 1000+ 网站,包括 YouTube、TikTok、Instagram、Facebook、Twitter、Twitch、Vimeo、Bilibili(B 站)、SoundCloud、Dailymotion 等几乎所有主流平台。完整列表可在 yt-dlp 官方仓库 查看。如果你访问的网站不在列表中,大概率是 yt-dlp 尚未支持,可向 yt-dlp 团队提交支持请求。
下载速度主要受网络带宽与源站限速影响。可尝试:1)启用系统代理走更优的网络路径;2)在偏好设置中调整并发下载数(默认 1,可调到 3-5);3)避开高峰时段下载;4)如果是 YouTube,下载较大文件时可能触发限流,ytDownloader 会自动重试。注意不要盲目调高并发数,过高反而可能触发 IP 封禁。
画质上限取决于源站提供的最高规格。YouTube 部分视频支持 4K(2160p)甚至 8K(4320p),选择「Best Quality」会自动挑选源站最高画质。其他平台如 Bilibili、Vimeo 等也支持 4K 下载。对于 DASH 分片流媒体(YouTube、Bilibili 等),ytDownloader 会自动下载分离的视频流与音频流并用 FFmpeg 合成最高画质文件。
默认保存路径在用户目录下的「Downloads/ytDownloader」文件夹中。可在偏好设置 → 下载路径中修改为任意位置。配合文件名模板(如
%(uploader)s/%(title)s.%(ext)s)可以实现按创作者、日期等条件自动归档到子文件夹。
隐私与安全
完全不会。ytDownloader 不包含任何遥测、用户行为追踪或匿名上报代码,下载记录、浏览链接、文件路径只存在于你本机,不会以任何形式上传到服务器。全部源代码以 GPL-3.0 协议在 GitHub 公开,任何人都可以审查验证。这正是开源软件相比闭源商业软件的核心优势。
Cookie 仅在本机使用,不会被收集、上传或共享给任何第三方。ytDownloader 读取你指定浏览器的本地 Cookie 数据,附加到下载请求中用于身份验证,相当于以你的登录身份访问目标网站。完成下载后可在偏好设置中清除 Cookie 缓存。重要提示:请勿在不信任的设备上启用 Cookie 功能,Cookie 等同于你的登录凭证,泄露后可能被用于冒充你的身份。
没有。从主界面到设置面板,从启动到退出,你不会在任何位置看到任何形式的广告、弹窗、推广。开源协议保证了这一点可以由社区监督与验证,与那些靠广告盈利的免费下载器有本质区别。
Electron 打包的应用偶尔会被部分杀毒软件误报(特别是 Windows Defender 或国内杀软),这是因为 Electron 应用的自解压机制与某些恶意软件相似。ytDownloader 源代码完全开源,可自行编译验证。建议从本官网或 GitHub Releases 下载官方安装包,避免从第三方下载站获取可能被篡改的版本。
功能与使用
支持。粘贴播放列表链接后,ytDownloader 会自动识别并列出所有视频,可逐条勾选或全选批量下载。支持按时长、上传日期过滤,自动跳过已下载内容,遇到限流自动重试。v3.22.0 还新增了任务取消按钮,可随时中止队列。
可以。在「高级选项」中启用「片段下载」,输入起始时间与结束时间(格式
HH:MM:SS 或 MM:SS),ytDownloader 会先下载完整视频流,然后用 FFmpeg 按时间戳精确裁剪,保留你指定的部分。非常适合从长直播、播客中截取精彩片段。
支持。在「高级选项」中勾选「下载字幕」,可选自动生成字幕或人工上传字幕,支持中文简体、繁体、英语、日语、韩语、法语、德语等数十种语言。字幕以通用
.srt 格式保存,VLC、MPV、PotPlayer 等主流播放器会自动加载。也可勾选「仅下载字幕」跳过视频,用于获取文字稿。
支持三大主流 GPU 厂商方案:NVIDIA NVENC(GTX 10 系及以上)、Intel Quick Sync(Intel 集成显卡)、AMD VCE / AMF(AMD 独立显卡与 APU)。软件会自动检测系统可用的 GPU 编码器并默认选用最快的方案。如果你的显卡不支持硬件编码,会自动回退到 CPU 编码。
视频格式支持 MP4、WebM、MKV,分辨率从 360p 到 8K(4320p)。音频格式支持 MP3、M4A、OPUS、OGG、WAV,MP3 最高 320kbps。具体可用格式取决于源站提供的选项,在格式列表中会显示每个选项的预估文件大小。
通过 Crowdin 社区协作翻译,已支持 24 种界面语言,包括简体中文、繁体中文、英语、日语、法语、德语、俄语、西班牙语、阿拉伯语、印地语等。可在偏好设置中切换。如发现翻译错误或想贡献新语言,欢迎参与 Crowdin 翻译项目。
版权与法律
下载视频的版权归属取决于原始内容的版权状态。ytDownloader 仅作为下载工具,不改变视频版权。下载后仅供个人学习、研究、欣赏使用;商用、二次分发、公开播放等行为需获得版权方授权。请在使用前确认目标视频的版权许可(如 Creative Commons 协议),并遵守当地法律法规。
ytDownloader 软件本身基于 GPL-3.0 协议开源,可自由使用、修改、分发。软件作为通用下载工具,类似于浏览器、FTP 客户端等中性技术工具,其合法性已在多国判例中确立。用户使用软件下载内容时需自行遵守当地版权法律,软件作者不对用户的具体下载行为承担责任。
通过 Cookie 下载你自己已订阅的会员内容(如 YouTube Premium 视频、Bilibili 大会员视频)属于个人合理使用范畴。但下载他人分享的会员内容、绕过付费墙获取付费内容则可能违反平台用户协议。请在合法合规的前提下使用本功能,软件作者不对用户的违规行为承担责任。
与 4K Video Downloader 相比,ytDownloader 完全免费且无任何下载次数限制,而 4K Video Downloader 免费版有每日 30 次下载限制,且高级功能需付费订阅。与 JDownloader2 相比,ytDownloader 专注于视频下载场景,界面更现代简洁,独有的 GPU 压缩与片段下载功能是 JDownloader2 没有的。JDownloader2 在批量下载文件分享站点(如网盘)方面更强。
没有找到你的问题?
欢迎在 GitHub Issues 提交反馈,或在社区讨论区与其他用户交流。我们也会持续更新这份 FAQ 文档。
