yt-dlp 代理配置与下载加速完整指南
使用 yt-dlp 下载视频时,常见的问题是需要代理才能访问、下载速度不理想,以及下载后的文件无法在部分设备上播放。本文分别介绍代理配置、下载加速和格式选择,并给出可以组合使用的命令。
一、配置本地代理
Clash、V2Ray 等工具可以提供本地代理。下文以 127.0.0.1:7890 为例,实际地址、端口和协议请以代理工具的设置为准。
临时使用:命令行指定代理
# HTTP 代理
yt-dlp --proxy http://127.0.0.1:7890 "视频链接"
# SOCKS5 代理:本地解析目标域名
yt-dlp --proxy socks5://127.0.0.1:7890 "视频链接"
# SOCKS5 代理:由代理端解析目标域名
yt-dlp --proxy socks5h://127.0.0.1:7890 "视频链接"
临时指定代理便于按需使用,不会改变后续命令的配置。使用 SOCKS5 时,socks5h:// 可避免为这些请求在本地解析目标域名;这不代表系统中其他程序的 DNS 请求也会经过代理。
长期使用:写入配置文件
如果多数下载都需要代理,可以将参数写入用户配置文件:
- Linux / macOS:
~/.config/yt-dlp/config;设置了XDG_CONFIG_HOME时,使用该目录下的yt-dlp/config。 - Windows:
%APPDATA%\yt-dlp\config.txt。
--proxy http://127.0.0.1:7890
需要临时直连时,可以覆盖配置中的代理:
yt-dlp --proxy "" "视频链接"
二、提升下载速度
下载速度可能受代理带宽、服务器限速、网络延迟和下载协议影响。增加连接数或分片并发有时能改善速度,但不能保证提速,也无法突破线路或服务器的带宽上限。
使用内置下载器提高分片并发
对于 yt-dlp 内置下载器处理的 DASH / HLS 分片视频,可以先尝试:
yt-dlp --proxy http://127.0.0.1:7890 -N 8 "视频链接"
-N 是 --concurrent-fragments 的简写,默认值为 1。它控制同时下载的分片数,不会把普通 HTTP 单文件自动拆成多段。
可以从 8 开始,再尝试 16。并发过高可能导致超时、限速或 HTTP 429,应根据实际速度和稳定性调整。
使用 aria2c 多连接下载
对于支持 Range 请求的 HTTP / HTTPS 文件,可以尝试 aria2c 的多连接下载。先安装 aria2,并确保 aria2c 在 PATH 中:
- Windows:从 aria2 Releases 下载并加入
PATH。 - Debian / Ubuntu:
sudo apt install aria2。 - macOS:
brew install aria2。
yt-dlp --proxy http://127.0.0.1:7890 \
--downloader aria2c \
--downloader "dash,m3u8:native" \
--downloader-args "aria2c:-x 16 -s 16 -k 1M --file-allocation=none" \
-N 16 \
"视频链接"
这组命令让 aria2c 处理其支持的下载协议,并明确让 DASH / HLS 使用内置下载器,分别控制两种下载方式的并发。
| 参数 | 作用 |
|---|---|
--downloader aria2c |
选择 aria2c 作为外部下载器 |
--downloader "dash,m3u8:native" |
DASH / HLS 使用内置下载器 |
-x 16 |
aria2c 对每个服务器最多建立 16 个连接 |
-s 16 |
aria2c 对单个文件最多使用 16 个连接,实际数量受文件大小和服务器支持影响 |
-k 1M |
aria2c 的最小拆分大小为 1 MiB;文件小于该值的两倍时不会拆分 |
--file-allocation=none |
aria2c 不预分配文件空间 |
-N 16 |
内置下载器最多同时下载 16 个 DASH / HLS 分片 |
-N 不会叠加到 aria2c 的连接数上。当前版本的 yt-dlp 已为 aria2c 设置了类似的默认参数;显式写出这些参数便于理解和调整,并不意味着一定比默认配置更快。
代理兼容性:aria2c 不支持 SOCKS 代理。 上面的组合使用 HTTP 代理。如果只有 SOCKS5 代理,应去掉 aria2c 相关选项,使用 yt-dlp 内置下载器。
三、格式选择:兼容性优先
yt-dlp 默认会综合分辨率、编码等因素选择格式,可能下载 AV1 / VP9 视频和 Opus 音频。部分设备对这些编码支持有限,兼容性优先时可以倾向选择 H.264 视频和 AAC 音频。
使用 -S 设置格式优先级
yt-dlp -S "vcodec:h264,res,acodec:aac" "视频链接"
vcodec:h264:优先选择 H.264 视频。res:在前面的排序条件相同时,优先选择更高分辨率。这里的分辨率按视频较短的一边计算。acodec:aac:优先选择 AAC 音频。
旧文中的 acodec:m4a 也可被当前版本识别,但 M4A 是容器,AAC 才是编码,这里改用更明确的 acodec:aac。
-S 设置的是排序偏好,不是严格筛选。网站没有目标编码时,仍可能选择其他编码,也不会自动转码。H.264 与 AAC 通常兼容性较好,但实际播放能力仍取决于设备支持的分辨率、Profile 等条件。
优先选择不超过 1080p 的格式
yt-dlp -S "vcodec:h264,res:1080,acodec:aac" "视频链接"
res:1080 优先选择不超过 1080p 的格式,但如果没有符合条件的格式,仍可能选择更高分辨率。需要严格限制高度时,使用格式筛选:
yt-dlp -f "bv[height<=1080]+ba/b[height<=1080]" \
-S "vcodec:h264,res,acodec:aac" \
"视频链接"
这里的 bv、ba、b 分别表示最佳纯视频、纯音频和音视频合一格式。+ 合并视频与音频,/ 提供备选方案;没有高度已知且符合限制的格式时,命令会报错。高度限制与按短边计算的 res 不完全相同,竖屏视频尤其需要区分。
合并为 MP4 容器
yt-dlp -S "vcodec:h264,res,acodec:aac" \
--merge-output-format mp4 \
"视频链接"
合并独立的视频与音频流需要安装 FFmpeg,并确保 ffmpeg 在 PATH 中。macOS 可用 brew install ffmpeg,Debian / Ubuntu 可用 sudo apt install ffmpeg,Windows 可参考 FFmpeg 下载页。
--merge-output-format mp4 只指定合并时的容器,不会把视频转成 H.264,也不会把音频转成 AAC。不需要合并时,该参数会被忽略;如还需要将单文件重新封装为 MP4,可加 --remux-video mp4。重新封装同样需要 FFmpeg,且源编码必须受目标容器支持。
四、完整命令示例
安装 aria2 和 FFmpeg 后,可以组合使用 HTTP 代理、多连接下载、分片并发与兼容格式偏好:
yt-dlp --proxy http://127.0.0.1:7890 \
--downloader aria2c \
--downloader "dash,m3u8:native" \
--downloader-args "aria2c:-x 16 -s 16 -k 1M --file-allocation=none" \
-N 16 \
-S "vcodec:h264,res,acodec:aac" \
--merge-output-format mp4 \
--remux-video mp4 \
"视频链接"
这条命令优先选择 H.264 / AAC,并尝试输出 MP4;它不保证源站一定提供这些编码,也不会转码。
- 不需要代理时,去掉
--proxy及其地址;若配置文件或环境变量已设置代理,使用--proxy ""明确直连。 - 不使用 aria2c 时,去掉两个
--downloader选项和--downloader-args,保留-N 16即可。 - 上面的多行命令使用 Bash / Zsh 的
\续行语法。Windows PowerShell / CMD 用户可将命令合并为一行。
总结
| 需求 | 推荐做法 |
|---|---|
| 临时使用本地代理 | --proxy http://127.0.0.1:7890 |
| 使用 SOCKS5 并由代理解析目标域名 | --proxy socks5h://127.0.0.1:7890,配合内置下载器 |
| 加速内置 DASH / HLS 下载 | 从 -N 8 开始调整分片并发 |
| 尝试 HTTP / HTTPS 多连接下载 | 使用 aria2c,并根据服务器和网络情况调整连接数 |
| 优先选择兼容编码 | -S "vcodec:h264,res,acodec:aac" |
| 输出 MP4 容器 | 安装 FFmpeg,按需使用 --merge-output-format mp4 和 --remux-video mp4 |
| 长期使用代理 | 写入用户配置文件 |
参数应围绕实际瓶颈调整。如果代理节点带宽不足或源站限制速度,增加并发不一定有帮助。