目录

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,应根据实际速度和稳定性调整。

对于支持 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 音频。

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 等条件。

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 不完全相同,竖屏视频尤其需要区分。

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
长期使用代理 写入用户配置文件

参数应围绕实际瓶颈调整。如果代理节点带宽不足或源站限制速度,增加并发不一定有帮助。