定义
Streamlink是一个以Python实现的命令行工具和程序库，作用是把各类在线服务提供的视频流提取出来，管道式转交给用户选定的播放器，或者写入磁盘成为文件[1]。它本身不含播放界面，播放工作由VLC 媒体播放器、mpv 等外部播放器完成，默认情况下会选择VLC[2]。
该工具由两部分组成，一部分是面向终端用户的命令行界面，另一部分是供开发者调用的库接口，后者可用于把流地址解析能力嵌入其他程序[1]。除播放之外，它也能读取流元数据，或把原始流数据输出到标准输出，方便与其他工具串联[4]。
原理
Streamlink的运作围绕插件展开。程序接收到网址后，会遍历已安装的插件，由每个插件的匹配方法判断自身能否处理该地址，命中后由对应插件负责解析该站点的页面或接口，取出可用的流地址列表[4]。这些流地址随后被封装为按清晰度命名的多个选项，用户可指定具体分辨率，也可用best、worst等关键字表示最高与最低质量[5]。
在协议层面，Streamlink支持HLS、MPEG-DASH等主流流媒体传输方式，HLS通常以.m3u8索引文件列出分片，程序按序抓取分片后再交给播放器或写入文件[5]。若采用记录模式，数据可不经重新编码直接落盘，从而避免画质损失并降低处理器负担；输出到标准输出时，则常与FFmpeg配合完成转封装[6]。
鉴权环节由插件与网络会话共同处理。程序支持通过配置文件保存OAuth令牌、Cookie文件与自定义HTTP头，从而访问需要登录或订阅的流；也支持HTTP与SOCKS代理，并可设定读取超时与重试次数以应对不稳定的网络[5]。
发展历程
Streamlink的前身是Livestreamer，该项目一度被广泛使用，但原作者在2016年前后停止维护，导致新增平台支持与既有插件修复都难以进行[7]。2016年，原项目的用户与开发者将其代码分支出来，以Streamlink之名继续开发，官方文档确认该项目派生自不再维护的Livestreamer[1]。
分支后的首个版本为2016年9月23日发布的0.0.1，早期版本主要围绕稳定分支代码、更新文档站点、修复各平台插件以及提供Windows可执行文件展开[8]。2019年1月30日发布1.0.0版本，此后项目保持较频繁的更新节奏，持续维护插件、协议与各平台适配[8]。
版本号进入8.x系列后仍不断推出新版本，官方文档的更新日志列出了从早期版本到8.x期间的多次发布记录[1]。项目也被打包进多种软件源，覆盖Homebrew、Chocolatey、Debian与Ubuntu、Fedora、Arch、Scoop、winget、openSUSE等，跨平台分发范围较广[8]。
应用
最常见的用法是在命令行中给出一条直播地址与目标画质，程序随即调用播放器开始播放，例如指定最高画质即可自动选择码率最高的流[1]。若只想浏览可用清晰度而不立即播放，也可以仅输入地址，程序会列出全部可选项并退出[5]。
录制是该工具的另一主要用途。用户通过输出参数指定保存路径，即可把直播存为.ts等文件，或同时播放并录制；把数据送入标准输出后再由FFmpeg处理，可实现时长限制、转封装为MP4等操作[6]。
在此基础上衍生出大量自动化项目。例如以Streamlink为内核的无人值守录制脚本，通过轮询平台接口判断主播是否开播，可对哔哩哔哩、斗鱼、虎牙、抖音、YouTube、Twitch等多个平台进行自动录制[9]。也有项目把它打包进容器，按固定间隔检查直播状态并自动保存文件[10]。另有桌面程序把Streamlink作为库调用，配合播放器实现回看缓冲与片段导出[11]。
局限
Streamlink的可用性高度依赖插件与目标站点的契合度，站点一旦调整接口或反爬策略，对应插件就需要更新，否则该平台可能无法解析[8]。其派生的自动化录制项目也明确指出，部分平台存在风控机制，小众平台的支持可能不稳定，同时录制过多直播可能引发难以预料的问题[9]。
受保护的流媒体内容无法通过该工具获取。项目曾因某平台直播采用数字版权管理而移除对应插件，说明加密保护的内容不在其支持范围内[12]。此外，该项目在播放时会绕过站点投放的广告，这一点在其项目说明中亦有提及，与站点的商业安排并不一致[12]。
搜索与解析本身也存在边界。程序默认的流数据读取超时为20秒，在网络不稳定时连接可能中断，需要手动调大该数值或增加重试[5]。同时，不同平台、不同地区所支持的清晰度与质量关键字并不统一，实际可选项需以程序列出的结果为准[5]。
参见
-
Livestreamer —— Streamlink的直接前身，项目即由其分支而来。
-
FFmpeg —— 常与Streamlink配合完成流的转封装与切片处理。
-
HLS —— Streamlink支持的主流流媒体传输协议之一。
-
VLC 媒体播放器 —— Streamlink默认调用的播放器。
-
Python —— Streamlink的实现语言，也是其提供库接口的基础。
参考资料
- Streamlink 8.3.0 documentation [引用日期2026-10-14]
- Streamlink (Français) [引用日期2026-10-14]
- streamlink [引用日期2026-10-14]
- streamlink/streamlink | DeepWiki [引用日期2026-10-14]
- Streamlink [引用日期2026-10-14]
- Streamlink: The Revolutionary CLI Tool Every Developer Needs [引用日期2026-10-14]
- Streamlink [引用日期2026-10-14]
- streamlink [引用日期2026-10-14]
- LiveRecorder [引用日期2026-10-14]
- lauwarm/streamlink-recorder repository overview [引用日期2026-10-14]
- clippiti-player [引用日期2026-10-14]
- streamlink [引用日期2026-10-14]