WBlog

wangzhiwei blog

0%

yt-dlp youtube 视频下载

发表于 更新于

yt-dlp youtube 视频下载

yt-dlp 是 youtube-dl 的一个活跃社区分支，修复速度快、支持的站点更多，且每天都会更新。
下面给你一份 30 秒上手教程，以及如果你刚在用 docker-compose，也附带容器化用法。

  1. 安装

macOS（homebrew）

1
brew install yt-dlp/taps/yt-dlp        # 官方源，永远最新

或升级

1
brew upgrade yt-dlp

Linux（pip）

1
python3 -m pip install -U yt-dlp

Windows（scoop）

1
scoop install yt-dlp
  1. 快速验证
1
2
yt-dlp --version        # 2023.* 或更高
yt-dlp -F "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

会列出所有可选清晰度，说明安装成功。

  1. 常用一行命令

最佳画质音视频合一，保存到 ~/Downloads

1
yt-dlp -P ~/Downloads -o "%(title)s.%(ext)s" 网址

只要音频（320 k MP3）

1
yt-dlp -x --audio-format mp3 --audio-quality 0 -P ~/Music 网址

整播单，独立文件夹，可断点续跑

1
2
yt-dlp -P ~/Videos:/MyPlaylist -o "%(playlist_index)03d  %(title)s.%(ext)s" \
       --download-archive archive.txt 播单地址

限速 5 MB/s、4 线程、断点续传

1
yt-dlp -r 5M -N 4 -c 网址
  1. 容器化用法（可选）

官方镜像（每晚构建）

1
2
3
docker run --rm -u $(id -u):$(id -g) \
  -v "$(pwd)":/workdir ghcr.io/yt-dlp/yt-dlp:latest \
  -P /workdir -o "%(title)s.%(ext)s" 网址

docker-compose 示例

1
2
3
4
5
6
services:
  ytdl:
    image: ghcr.io/yt-dlp/yt-dlp:latest
    volumes:
      - ./downloads:/workdir
    command: ["-P", "/workdir", "-o", "%(title)s.%(ext)s", "网址"]

然后

1
docker-compose run --rm ytdl
  1. 常见坑
  • “Unable to extract uploader id” → 版本太旧，升级即可。
  • “ERROR: Postprocessing: ffprobe not found” → 装 ffmpeg（brew install ffmpeg）。
  • 下载慢 → 加 -N 4 或使用代理 --proxy socks5://127.0.0.1:1080。
  • 遇到验证码/地区限制 → 导出 cookies：--cookies-from-browser chrome 或 cookies.txt。
  1. 查看帮助
1
2
yt-dlp --help | less
yt-dlp --list-extractors | grep -i twitch

换上网址就能下，祝使用愉快。

yt-dlp -r 5M -N 4 -c “https://www.youtube.com/watch?v=BcqPv3aR0lM“ 执行报错

1
2
3
4
5
6
7
8
9
10
11
12
13
yt-dlp -r 5M -N 4 -c "https://www.youtube.com/watch?v=BcqPv3aR0lM "
[youtube] Extracting URL: https://www.youtube.com/watch?v=BcqPv3aR0lM 
[youtube] BcqPv3aR0lM: Downloading webpage
WARNING: [youtube] Unable to download webpage: HTTP Error 429: Too Many Requests (caused by <HTTPError 429: Too Many Requests>)
[youtube] BcqPv3aR0lM: Downloading initial data API JSON
[youtube] BcqPv3aR0lM: Downloading tv client config
[youtube] BcqPv3aR0lM: Downloading player a644926e-main
[youtube] BcqPv3aR0lM: Downloading tv player API JSON
[youtube] BcqPv3aR0lM: Downloading android sdkless player API JSON
[youtube] BcqPv3aR0lM: Downloading web player API JSON
WARNING: [youtube] No title found in player responses; falling back to title from initial data. Other metadata may also be missing
ERROR: [youtube] BcqPv3aR0lM: Sign in to confirm you’re not a bot. Use --cookies-from-browser or --cookies for the authentication. See  https://github.com/yt-dlp/yt-dlp/wiki/FAQ#how-do-i-pass-cookies-to-yt-dlp   for how to manually pass cookies. Also see  https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies   for tips on effectively exporting YouTube cookies

YouTube 已经把你这台 IP 标记成“可疑流量”，所以：

  1. 所有匿名请求都返回 429 / “Sign in to confirm you’re not a bot”
  2. yt-dlp 再换客户端（web/tv/android）也拿不到完整数据，只能强制你登录。

要解决，就得让 yt-dlp“假装”你是浏览器里的已登录用户——把浏览器 Cookie 塞给它。下面给出最简三步，macOS 示例，其他系统同理。

① 安装浏览器导出插件（一次就行）

Chrome/Edge
• Get “Get cookies.txt LOCALLY” （https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc）
• 打开 YouTube 并登录账号 → 点插件 → “Export as Netscape” → 保存为 youtube.com_cookies.txt

Firefox
• 装 “Export Cookies” （https://addons.mozilla.org/firefox/addon/export-cookies-txt/） → 同样导出 Netscape 格式。

② 用 cookies 重新下载

把刚才导出的文件放在当前目录，运行 

1
yt-dlp --cookies youtube.com_cookies.txt -r 5M -N 4 -c "https://www.youtube.com/watch?v=BcqPv3aR0lM"

通常就能直接拿到 1080p/720p 无需验证码。

③（可选）更懒的办法：直接读浏览器数据库

如果你不想每次手动导出，可以让 yt-dlp 自己抽 Cookie（macOS 示例） 

1
yt-dlp --cookies-from-browser chrome -r 5M -N 4 -c "https://www.youtube.com/watch?v=BcqPv3aR0lM"

• 会弹框要钥匙串权限，允许即可。
• 支持 chrome, chromium, firefox, safari, edge。

还报错？再加一层伪装

1
2
3
4
5
6
yt-dlp \
  --cookies youtube.com_cookies.txt \
  -r 5M -N 4 -c \
  --user-agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
  --proxy socks5://127.0.0.1:1080   # 如果你有代理
  "https://www.youtube.com/watch?v=BcqPv3aR0lM"

短期应急方案

• 换个网络（手机热点、隔壁 Wi-Fi）往往就解除 429，可暂时不用 Cookie。
• 降低并发：把 -N 4 改成 -N 1 并加长间隔 --sleep-requests 1 --sleep-interval 5。

总结

YouTube 429 ≠ yt-dlp 坏了，只是 IP/账号被限。
“登录 + 塞 Cookie”是目前最稳的通用解法；导出一次后就能批量下。

yt-dlp + UI界面

Media Downloader（Qt 外壳，功能最全）
仓库 https://github.com/mhogomchungu/media-downloader
特点
同时支持 yt-dlp、gallery-dl、aria2、wget…
内嵌“格式选择器”，可预览所有清晰度、帧率、码率。
自带“引擎管理”：一键更新 yt-dlp 可执行文件。
支持“订阅”——定时把播单增量拉到本地。
安装
Windows：Releases 里 MediaDownloader-Setup.exe
macOS：brew install –cask media-downloader
Linux：AppImage / flatpak 都有。

1
2
yt-dlp --cookies-from-browser chrome -r 5M -N 4 -c yt-dlp -r 5M -N 4 -c "https://www.bilibili.com/video/BV1u8mcBBEZT/?spm_id_from=333.1007.tianma.1-1-1.click"

高级配置用法，支持任务中断后继续

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
  yt-dlp \
    --proxy http://127.0.0.1:1081 \
    --ignore-errors --continue --no-overwrites \
    --write-info-json --write-thumbnail --embed-metadata --embed-subs \
    --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
    --merge-output-format mp4 --remux-video mp4 \
    --format "bv*[ext=mp4][height<=1080]+ba[ext=m4a]/b[ext=mp4][height<=1080]/bv+ba/b" \
    --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
    --download-archive downloaded.txt \
    --sleep-interval 3 --max-sleep-interval 13 \
    https://www.youtube.com/@user-sbxsdsyy/playlists


yt-dlp \
  --cookies-from-browser chrome \
  --proxy http://127.0.0.1:1081 \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "bv*[ext=mp4][height<=1080]+ba[ext=m4a]/b[ext=mp4][height<=1080]/bv+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 10 --max-sleep-interval 60 \
  https://www.youtube.com/playlist\?list=PLR1ACzwrLF_3oaoAILcSc7vW6wHX2c1Xd



yt-dlp \
  --cookies-from-browser chrome \
  --proxy http://127.0.0.1:1081 \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "worst[ext=mp4]/22/18/bv[height<=480]+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 10 --max-sleep-interval 60 \
  https://www.youtube.com/playlist\?list=PLR1ACzwrLF_3oaoAILcSc7vW6wHX2c1Xd



yt-dlp \
  --cookies-from-browser chrome \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "worst[ext=mp4]/22/18/bv[height<=480]+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 10 --max-sleep-interval 60 \
  https://www.youtube.com/playlist\?list=PLR1ACzwrLF_3oaoAILcSc7vW6wHX2c1Xd



yt-dlp \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "bv*[ext=mp4][height<=1080]+ba[ext=m4a]/b[ext=mp4][height<=1080]/bv+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 3 --max-sleep-interval 13 \
  https://www.youtube.com/playlist\?list=PLR1ACzwrLF_1hg5xjaX1mbOgPlmShcpjM



yt-dlp \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "bv*[ext=mp4][height<=1080]+ba[ext=m4a]/b[ext=mp4][height<=1080]/bv+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 10 --max-sleep-interval 60 \
  --playlist-reverse --playlist-start 1 --playlist-end 60 \
  "https://www.youtube.com/playlist?list=PLR1ACzwrLF_3tmjscUfjGpawHRKze3pI7"







查询有多少条数据
yt-dlp --flat-playlist --print "%(playlist_index)s" \
  "https://www.youtube.com/playlist\?list=PLR1ACzwrLF_3tmjscUfjGpawHRKze3pI7" | \
tail -n1



yt-dlp \
  --ignore-errors --continue --no-overwrites \
  --write-info-json --write-thumbnail --embed-metadata --embed-subs \
  --sub-langs "zh.*,en.*,zh-CN,zh-TW,en" --compat-options no-live-chat \
  --merge-output-format mp4 --remux-video mp4 \
  --format "bv*[ext=mp4][height<=1080]+ba[ext=m4a]/b[ext=mp4][height<=1080]/bv+ba/b" \
  --output "%(upload_date>%Y-%m-%d)s %(title)s [%(id)s].%(ext)s" \
  --download-archive downloaded.txt \
  --sleep-interval 3 --max-sleep-interval 13 \
  --playlist-start 227 \
  "https://www.youtube.com/playlist\?list=PLR1ACzwrLF_3tmjscUfjGpawHRKze3pI7"


  yt-dlp --proxy http://127.0.0.1:1081 \
       --flat-playlist \
       --print "%(title)s | %(id)s | %(webpage_url)s" \
       https://www.youtube.com/@user-sbxsdsyy/playlists
       
數學合集 | PLR1ACzwrLF_0LkIfD49gYWamb5chMpKZb | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0LkIfD49gYWamb5chMpKZb
記單詞 | PLR1ACzwrLF_0RhtAElUXqI1ZRC5KLUmze | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0RhtAElUXqI1ZRC5KLUmze
封神演義 | PLR1ACzwrLF_1dMwOPm7aOaoUr-RwUh0gI | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1dMwOPm7aOaoUr-RwUh0gI
紅樓夢 | PLR1ACzwrLF_2VpoCKy4h31uZtDGJrDMuU | https://www.youtube.com/playlist?list=PLR1ACzwrLF_2VpoCKy4h31uZtDGJrDMuU
故宫小故事 | PLR1ACzwrLF_3H_UMEnDAxJozjU5xy_8Yr | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3H_UMEnDAxJozjU5xy_8Yr
中學歷史 | PLR1ACzwrLF_11MxvNZTDBtPs09RwzSZte | https://www.youtube.com/playlist?list=PLR1ACzwrLF_11MxvNZTDBtPs09RwzSZte
物理化學實驗課 | PLR1ACzwrLF_0UFfMfuHN5Ok4HGHnAJICj | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0UFfMfuHN5Ok4HGHnAJICj
中學地理 | PLR1ACzwrLF_0-FvCBkURhCR-xtr06pR0H | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0-FvCBkURhCR-xtr06pR0H
中學英語 | PLR1ACzwrLF_3oaoAILcSc7vW6wHX2c1Xd | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3oaoAILcSc7vW6wHX2c1Xd
中學生物 | PLR1ACzwrLF_1woXE4M6WW39TUKWUtr31r | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1woXE4M6WW39TUKWUtr31r
小學數學 | PLR1ACzwrLF_3tmjscUfjGpawHRKze3pI7 | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3tmjscUfjGpawHRKze3pI7
文言文学习 | PLR1ACzwrLF_3Hghqe7ULVDjc9xvdiemuu | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3Hghqe7ULVDjc9xvdiemuu
初中数学 | PLR1ACzwrLF_1cGgv_lYjkzG3Qca-eA67v | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1cGgv_lYjkzG3Qca-eA67v
高中物理 | PLR1ACzwrLF_1W1nOT0-0WI51VsufIWO3C | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1W1nOT0-0WI51VsufIWO3C
高中化学 | PLR1ACzwrLF_3JEmrFtjdGYHIUtnWtiPCK | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3JEmrFtjdGYHIUtnWtiPCK
高中数学 | PLR1ACzwrLF_09MidJqluugHTHQCErNeSb | https://www.youtube.com/playlist?list=PLR1ACzwrLF_09MidJqluugHTHQCErNeSb
高中語文 | PLR1ACzwrLF_2gwtuI6nYtYrj2id8VpSb2 | https://www.youtube.com/playlist?list=PLR1ACzwrLF_2gwtuI6nYtYrj2id8VpSb2
小学奥数  奥林匹克数学竞赛 | PLR1ACzwrLF_3gjfp4EXD138c7pQ9AMhkR | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3gjfp4EXD138c7pQ9AMhkR
初中化学 | PLR1ACzwrLF_0qe4lqmCAagBIW3SZ4fF2i | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0qe4lqmCAagBIW3SZ4fF2i
初中物理 | PLR1ACzwrLF_3gUJQ701S7E_sapkYgjcHe | https://www.youtube.com/playlist?list=PLR1ACzwrLF_3gUJQ701S7E_sapkYgjcHe
英語語法學習 | PLR1ACzwrLF_1hg5xjaX1mbOgPlmShcpjM | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1hg5xjaX1mbOgPlmShcpjM
趣味詩詞小故事 | PLR1ACzwrLF_0kAYMeYrjQUh6ETgFKBGXw | https://www.youtube.com/playlist?list=PLR1ACzwrLF_0kAYMeYrjQUh6ETgFKBGXw
趣味文學小故事 | PLR1ACzwrLF_1A_KwQuNjHVUWhJsyJvf_4 | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1A_KwQuNjHVUWhJsyJvf_4
趣味唐詩小故事 | PLR1ACzwrLF_1wAMWccHzA_yRWeryWIzcg | https://www.youtube.com/playlist?list=PLR1ACzwrLF_1wAMWccHzA_yRWeryWIzcg