代理与网络

# HTTP 代理
yt-dlp --proxy "http://127.0.0.1:7890" "URL"

# SOCKS5 代理
yt-dlp --proxy "socks5://127.0.0.1:1080" "URL"

# 设置环境变量（所有命令生效）
# Windows
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

# Linux/macOS
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

import yt_dlp

ydl_opts = {
    'proxy': 'http://127.0.0.1:7890',
    # 或 'socks5://127.0.0.1:1080'
}

with yt_dlp.YoutubeDL(ydl_opts) as ydl:
    ydl.download(["URL"])

# 限制下载速度为 10MB/s
yt-dlp --limit-rate 10M "URL"

# 限速 500KB/s
yt-dlp --limit-rate 500K "URL"

# 同时下载多个片段（分段视频加速）
yt-dlp -N 4 "URL"  # 4 个并发连接

# 设置重试次数
yt-dlp --retries 10 "URL"

# 分段重试
yt-dlp --fragment-retries 10 "URL"

import yt_dlp

ydl_opts = {
    'ratelimit': 10 * 1024 * 1024,   # 10MB/s
    'concurrent_fragment_downloads': 4, # 并发片段数
    'retries': 10,                     # 重试次数
    'fragment_retries': 10,            # 分段重试
}

with yt_dlp.YoutubeDL(ydl_opts) as ydl:
    ydl.download(["URL"])

# 断点续传 + 重试组合
yt-dlp -c --retries 10 --fragment-retries 10 "URL"

# 超时设置
yt-dlp --socket-timeout 30 "URL"

# 下载失败时暂停后重试
yt-dlp --retry-sleep 5 "URL"

import yt_dlp

ydl_opts = {
    'continuedl': True,         # 断点续传
    'retries': 10,              # 重试次数
    'fragment_retries': 10,     # 分段重试
    'socket_timeout': 30,       # 超时秒数
    'retry_sleep_functions': {
        'http': lambda n: 5,    # HTTP 错误重试等待 5 秒
    },
}

with yt_dlp.YoutubeDL(ydl_opts) as ydl:
    ydl.download(["URL"])