网络选项

本节列出 mpv 的网络和流媒体选项。

网络配置

连接设置

# 连接超时（秒）
network-timeout=60

# 重试次数
stream-lavf-o=timeout=60

# 用户代理
user-agent="Mozilla/5.0"

代理设置

# HTTP 代理
http-proxy=http://proxy:8080

# SOCKS 代理
socks-proxy=socks5://proxy:1080

# 代理认证
http-proxy=http://user:pass@proxy:8080

HTTP 选项

HTTP 配置

# HTTP 超时
network-timeout=60

# HTTP 头
http-header-fields="Referer: https://example.com"

# HTTP Cookies
cookies=yes
cookies-file=~/.config/mpv/cookies.txt

HTTP 认证

# HTTP 认证
http-user=username
http-passwd=password

# HTTP 认证文件
http-auth-file=~/.config/mpv/auth.conf

RTSP 选项

RTSP 配置

# RTSP 传输
rtsp-transport=tcp
rtsp-transport=udp

# RTSP 端口
rtsp-port=554

# RTSP 超时
rtsp-timeout=60

HLS 选项

HLS 配置

# HLS 线程数
hls-segment-threads=4

# HLS 优先级
hls-bitrate=max

# HLS 缓存
hls-cache=yes

YouTube 选项

YouTube-DL 配置

# 使用 youtube-dl
ytdl=yes

# 使用 yt-dlp
script-opts=ytdl_hook-ytdl_path=yt-dlp

# YouTube 质量选择
ytdl-format=bestvideo+bestaudio

YouTube 选项

# YouTube 质量
ytdl-format=best

# YouTube 字幕
ytdl-raw-options=write-subs=,write-auto-subs=

# YouTube Cookies
ytdl-raw-options=cookies-from-browser=chrome

网络缓存

缓存配置

# 启用缓存
cache=yes

# 缓存大小
demuxer-max-bytes=500MiB

# 缓存目录
cache-dir=~/.cache/mpv

# 缓存文件
cache-file=TMP

缓存策略

# 预读取
demuxer-readahead-secs=20

# 缓存清理
cache-unlink-files=immediate

网络调试

调试信息

# 显示网络信息
mpv --msg-level=all=v https://example.com/video.mp4

# 显示缓冲信息
mpv --stats https://example.com/video.mp4

网络测试

# 测试网络连接
mpv --network-timeout=10 https://example.com/video.mp4

# 测试代理
mpv --http-proxy=http://proxy:8080 https://example.com/video.mp4

网络故障排除

常见问题

1. 连接超时

   • 增加超时时间：network-timeout=120
   • 检查网络连接

2. 缓冲区溢出

   • 增加缓冲区大小：demuxer-max-bytes=500MiB
   • 减少预读取：demuxer-readahead-secs=10

3. 代理不工作

   • 检查代理配置：http-proxy=http://proxy:8080
   • 检查代理认证

调试命令

# 显示网络信息
mpv --msg-level=all=v https://example.com/video.mp4

# 测试网络连接
mpv --network-timeout=10 https://example.com/video.mp4

下一步

• 缓存选项 - 缓冲和缓存
• 协议参考 - 支持的协议
• 流媒体播放 - 流媒体配置