N_m3u8DL-RE快捷键大全：效率提升必备手册

引言：告别命令行噩梦，掌握这些参数让你效率翻倍

你是否还在为记不住N_m3u8DL-RE的命令行参数而烦恼？是否在下载流媒体时因为参数设置不当导致失败或效率低下？本文将系统整理N_m3u8DL-RE的所有常用命令行参数，帮助你快速掌握这款强大流媒体下载器的使用技巧，提升下载效率。

读完本文，你将获得：

• 系统分类的N_m3u8DL-RE命令行参数速查表
• 针对不同场景的参数组合示例
• 高级参数配置技巧与注意事项
• 常见问题解决方案

一、基础参数：快速上手必备

1.1 核心参数

参数名称	缩写	功能描述	使用示例
input	无	指定输入的流媒体URL	N_m3u8DL-RE "https://example.com/stream.m3u8"
--save-dir	无	设置文件保存目录	--save-dir ./downloads
--save-name	无	指定保存文件名	--save-name "my_video"
--tmp-dir	无	设置临时文件目录	--tmp-dir ./temp
-H, --header	-H	添加HTTP请求头	-H "Referer: https://example.com" -H "User-Agent: Chrome"

1.2 输出控制参数

参数名称	功能描述	默认值
--save-pattern	定义保存文件命名规则	<SaveName>_<Id>_<Codecs>_<Language>_<Ext>
--sub-format	设置字幕输出格式	SRT
--log-file-path	指定日志文件路径	程序目录下的log文件
--ui-language	设置界面语言	系统默认

# 基础下载示例
N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./downloads \
  --save-name "my_video" \
  -H "Referer: https://example.com" \
  -H "User-Agent: Mozilla/5.0"

二、高级参数：提升下载效率

2.1 性能优化参数

参数名称	缩写	功能描述	使用示例
--thread-count	无	设置下载线程数	--thread-count 16
-mt, --concurrent-download	-mt	启用并发下载	-mt
-R, --max-speed	-R	设置最大下载速度	-R 10M (限制为10MB/s)
--download-retry-count	无	设置下载重试次数	--download-retry-count 5

2.2 内容过滤参数

参数名称	缩写	功能描述	使用示例
-sv, --select-video	-sv	选择视频流	-sv "best" (选择最佳质量)
-sa, --select-audio	-sa	选择音频流	-sa "lang=zh" (选择中文音频)
-ss, --select-subtitle	-ss	选择字幕流	-ss "all" (下载所有字幕)
--ad-keyword	无	设置广告关键词过滤	--ad-keyword "广告" --ad-keyword "promo"

# 高级下载示例：选择最佳视频和中文音频
N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./downloads \
  -mt \
  -R 20M \
  -sv "best" \
  -sa "lang=zh" \
  -ss "all" \
  --thread-count 16

三、加密内容处理：解密参数详解

3.1 密钥相关参数

参数名称	功能描述	使用示例
--key	指定加密密钥	--key "1234567890abcdef"
--key-text-file	从文件加载密钥	--key-text-file ./keys.txt
--custom-hls-method	指定HLS加密方法	--custom-hls-method AES-128
--custom-hls-key	指定自定义HLS密钥	--custom-hls-key "hex:1234567890abcdef"
--custom-hls-iv	指定自定义HLS IV	--custom-hls-iv "base64:abcdef123456"

3.2 解密引擎参数

参数名称	功能描述	可选值
--decryption-engine	设置解密引擎	MP4DECRYPT, SHAKA
--mp4-real-time-decryption	启用MP4实时解密	--mp4-real-time-decryption
--decryption-binary-path	指定解密工具路径	--decryption-binary-path ./mp4decrypt

# 解密下载示例
N_m3u8DL-RE "https://example.com/encrypted_stream.m3u8" \
  --save-dir ./downloads \
  --key "hex:24E99F37D67B7613A9B682E75E5D2A1C" \
  --decryption-engine MP4DECRYPT \
  -H "Referer: https://example.com"

四、直播录制：专用参数配置

4.1 基础直播参数

参数名称	功能描述	使用示例
--live-record-limit	设置直播录制时长限制	--live-record-limit 01:30:00 (录制1.5小时)
--live-real-time-merge	启用实时合并	--live-real-time-merge
--live-wait-time	设置直播等待时间(秒)	--live-wait-time 30
--live-take-count	设置直播分片数量	--live-take-count 32

4.2 高级直播参数

参数名称	功能描述	使用示例
--live-perform-as-vod	直播当作点播处理	--live-perform-as-vod
--live-keep-segments	保留直播分片文件	--live-keep-segments
--live-pipe-mux	启用直播管道混流	--live-pipe-mux
--live-fix-vtt-by-audio	根据音频修复字幕时间	--live-fix-vtt-by-audio

# 直播录制示例
N_m3u8DL-RE "https://example.com/live_stream.m3u8" \
  --save-dir ./live_downloads \
  --save-name "live_event" \
  --live-record-limit 02:00:00 \
  --live-real-time-merge \
  --live-wait-time 60 \
  -mt \
  -R 10M

五、网络配置：代理与连接参数

5.1 代理设置

参数名称	功能描述	使用示例
--use-system-proxy	使用系统代理	--use-system-proxy
--custom-proxy	设置自定义代理	--custom-proxy "http://user:pass@proxy:port"

5.2 网络连接参数

参数名称	功能描述	默认值
--http-request-timeout	HTTP请求超时时间(秒)	100
--base-url	设置基础URL	从输入URL自动提取
--urlprocessor-args	URL处理器参数	无

# 使用代理下载示例
N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./downloads \
  --custom-proxy "http://proxy:8080" \
  --http-request-timeout 150 \
  -H "Referer: https://example.com"

六、高级功能：混流与后处理

6.1 混流参数

参数名称	缩写	功能描述	使用示例
-M, --mux-after-done	-M	下载后进行混流	-M "format=mp4:muxer=ffmpeg"
--mux-import	导入外部文件进行混流	--mux-import "path=./sub.srt:lang=en"

6.2 后处理参数

参数名称	功能描述	使用示例
--skip-merge	跳过合并步骤	--skip-merge
--binary-merge	使用二进制合并	--binary-merge
--del-after-done	完成后删除临时文件	--del-after-done (默认启用)
--write-meta-json	写入元数据JSON文件	--write-meta-json (默认启用)

# 下载并混流示例
N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./downloads \
  -M "format=mp4:muxer=ffmpeg:keep=false" \
  --mux-import "path=./subtitles.srt:lang=zh" \
  --ffmpeg-binary-path ./ffmpeg \
  --del-after-done

七、参数使用流程图：从输入到输出的完整流程

flowchart TD
    A[输入URL] --> B[解析流媒体信息]
    B --> C{内容是否加密?}
    C -->|是| D[应用解密参数]
    C -->|否| E[选择音视频流]
    D --> E
    E --> F{是否直播?}
    F -->|是| G[应用直播参数]
    F -->|否| H[应用点播参数]
    G --> I[开始录制]
    H --> J[开始下载]
    I --> K[实时合并]
    J --> L[下载完成]
    K --> M[后处理]
    L --> M
    M --> N{是否混流?}
    N -->|是| O[执行混流]
    N -->|否| P[完成]
    O --> P

八、常用命令组合示例

8.1 基础点播下载

N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./downloads \
  --save-name "my_video" \
  -H "Referer: https://example.com" \
  -H "User-Agent: Mozilla/5.0"

8.2 高质量视频下载

N_m3u8DL-RE "https://example.com/stream.m3u8" \
  --save-dir ./hd_downloads \
  -sv "best" \
  -sa "best" \
  -ss "all" \
  -mt \
  -R 50M \
  --thread-count 32 \
  -M "format=mkv:muxer=mkvmerge"

8.3 加密直播录制

N_m3u8DL-RE "https://example.com/live.m3u8" \
  --save-dir ./live \
  --save-name "encrypted_live" \
  --key "hex:24E99F37D67B7613A9B682E75E5D2A1C" \
  --live-record-limit 03:00:00 \
  --live-real-time-merge \
  --live-pipe-mux \
  -mt

九、常见问题与解决方案

9.1 参数冲突问题

问题	解决方案
同时设置--use-system-proxy和--custom-proxy	系统会优先使用--custom-proxy
-sv和-drop-video同时使用	drop参数会覆盖select参数
设置--live-record-limit但不是直播流	参数会被忽略，不影响正常下载

9.2 性能优化建议

1. 根据网络带宽合理设置--max-speed参数，避免因速度过快导致连接不稳定
2. 直播下载时建议启用--live-real-time-merge，减少磁盘空间占用
3. 加密内容下载时，确保密钥格式正确，可使用hex:或base64:前缀指定格式
4. 对于长时间运行的任务，建议设置--log-file-path保存详细日志

十、总结与效率提升建议

N_m3u8DL-RE作为一款功能强大的流媒体下载器，提供了丰富的命令行参数来满足不同场景的需求。掌握这些参数不仅能解决下载过程中的各种问题，还能显著提升工作效率。

效率提升建议：

1. 创建批处理脚本保存常用参数组合，避免重复输入
2. 使用--save-pattern自定义输出文件名，便于文件管理
3. 对于经常访问的站点，保存请求头信息到文件，使用--header参数加载
4. 直播录制时合理设置--live-record-limit和--live-wait-time参数，平衡录制完整性和资源占用

通过本文档，你已经掌握了N_m3u8DL-RE的核心参数和高级用法。实际使用中，可根据具体需求灵活组合这些参数，充分发挥工具的强大功能。

收藏本文档，下次使用N_m3u8DL-RE时即可快速查阅，告别命令行参数烦恼！