跳转至

Yt Dlp常用指令

📌 yt-dlp 核心功能表

功能 命令示例 说明
基本下载 yt-dlp "URL" 下载视频(自动选择最佳画质)
指定格式 yt-dlp -f "bestvideo+bestaudio" "URL" 下载最佳画质+音质组合(推荐)
选择分辨率 yt-dlp -f "bv[height<=720]+ba" "URL" 下载720p及以下分辨率
下载播放列表 yt-dlp --yes-playlist "URL" 下载整个播放列表

⚡ 下载控制参数

参数 作用 示例
-o "输出模板" 自定义文件名和路径 -o "/sdcard/Download/%(title)s.%(ext)s"
--concurrent-fragments N 多线程下载(默认1,建议4-16) --concurrent-fragments 8
--limit-rate RATE 限速(如2M500K --limit-rate 2M
--retries N 全局重试次数(默认10) --retries 20
--fragment-retries N 分片重试次数(默认10) --fragment-retries 20
--abort-on-error 下载失败时终止(适合批量下载) --abort-on-error

🔐 加密/解密与特殊处理

参数 作用 适用场景
--allow-u 允许未加密的HLS流(默认禁用) 下载非加密M3U8时使用
--no-check-certificate 跳过SSL证书验证(不推荐) 对付某些HTTPS错误的网站
--extractor-args "..." 传递特殊参数给提取器 --extractor-args "youtube:player_client=android"

📂 输出模板变量(用于-o参数)

变量 含义 示例
%(title)s 视频标题 %(title)s.mp4
%(id)s 视频ID %(id)s.%(ext)s
%(ext)s 文件扩展名(如mp4) %(title)s.%(ext)s
%(upload_date)s 上传日期(YYYYMMDD) %(upload_date)s_%(title)s.mp4
%(playlist)s 播放列表名称 %(playlist)s/%(title)s.%(ext)s

🔧 常用组合命令

场景 完整命令
下载M3U8并限速 yt-dlp "URL" -o output.mp4 --concurrent-fragments 8 --limit-rate 2M
批量下载播放列表 yt-dlp --yes-playlist -f "bv[height<=1080]+ba" -o "playlist/%(title)s.%(ext)s" "URL"
仅提取音频(MP3格式) yt-dlp -x --audio-format mp3 "URL" -o "%(title)s.mp3"
绕过地理限制 yt-dlp --geo-bypass --proxy "http://代理IP:端口" "URL"

💡 实用技巧

  1. 查看可用格式
    bash yt-dlp -F "URL" # 列出所有可下载格式
  2. 断点续传:直接重新运行相同命令即可自动继续未完成的下载。
  3. 批量下载文本中的链接
    bash yt-dlp -a links.txt # links.txt每行一个URL

此表格已覆盖 90% 的日常使用场景,建议收藏备用!如需更高级功能,可运行 yt-dlp --help 查看完整文档。