Lux 是用 Go 语言编写的快速、简单的视频下载命令行工具
Lux 是一款用 Go 语言编写的快速、简单的视频下载命令行工具,支持 YouTube、Bilibili、抖音等众多主流视频网站。
本教程将详细介绍在不同的操作系统上安装、配置和使用 Lux 的完整流程。
💻 第一步:安装前的准备
在开始安装 Lux 之前,强烈建议先安装 FFmpeg。
- 作用:Lux 依赖 FFmpeg 来合并下载的视频和音频流,否则下载的高清视频可能没有声音。
- 安装方法:请根据你的操作系统,通过包管理器或官网下载安装 FFmpeg,并确保在终端/命令行中运行
ffmpeg -version能正常显示版本信息。
⚙️ 第二步:在不同系统上安装 Lux
你可以根据自己的操作系统,从以下几种方式中选择最方便的一种进行安装。
| 操作系统 | 推荐方式 | 安装命令 |
|---|---|---|
| 通用 | Go 安装 | go install github.com/iawia002/lux@latest |
| macOS | Homebrew | brew install lux |
| Windows | Scoop | scoop install lux |
| Windows | Chocolatey | choco install lux |
| Arch Linux | AUR | 通过 AUR 安装 lux-dl 包 |
| Void Linux | 系统源 | xbps-install -S lux |
💡 补充说明
除了包管理器,你也可以直接从 GitHub Releases 页面下载对应操作系统的预编译二进制文件(如 Windows 的.exe文件),并将其所在目录添加到系统PATH环境变量中,以便在任意目录下使用lux命令。
🚀 第三步:基础使用方法
安装完成后,打开终端(或命令提示符),就可以使用 lux 命令了。基本用法为:
1 | lux [OPTIONS] URL [URL...][citation:4] |
1. 下载单个视频
直接提供视频链接即可。
1 | lux "https://www.youtube.com/watch?v=dQw4w9WgXcQ" |
2. 查看视频可用质量
使用 -i 参数可以列出视频所有可用的清晰度,而不会实际下载。
1 | lux -i "https://www.bilibili.com/video/BV1xx411c7XX" |
3. 指定清晰度下载
在查看视频信息后,可以使用 -f 参数跟上对应的视频流代号来下载指定画质。
1 | lux -f 137 "视频URL" |
✨ 第四步:进阶功能与常用参数
Lux 还提供了许多实用的高级功能,可以应对更复杂的下载场景。
批量下载与播放列表:使用
-p参数下载整个播放列表。还可以用--start、--end或--items参数指定下载列表的范围。1
2
3
4# 下载整个B站剧集
lux -p "https://www.bilibili.com/bangumi/play/ep198061"
# 只下载列表中的第1,5,6,8-10项
lux --items "1,5,6,8-10" "播放列表URL"多线程加速:通过
-n参数可以指定下载线程数,默认是10,能显著提升下载速度。但请注意,某些网站(如芒果TV)线程数过多可能引发错误,建议设置为1。1
lux -n 20 "视频URL"
断点续传:如果下载被中断(如按
Ctrl+C),Lux 会在输出目录保留一个临时的.download文件。再次运行相同的下载命令,它会自动从中断处继续下载。使用 Cookies:对于需要登录才能观看的视频,可以使用
-c参数提供 Cookie。Cookie 可以是字符串或文本文件。1
2
3
4# 使用Cookie字符串
lux -c "name=value; name2=value2" "视频URL"
# 使用Cookie文件
lux -c cookies.txt "视频URL"使用代理:对于访问受限的网站,可以通过设置
HTTP_PROXY或SOCKS5_PROXY环境变量来使用代理。1
HTTP_PROXY="http://127.0.0.1:1087/" lux "https://www.youtube.com/watch?v=..."
🧠 第五步:故障排除与技巧
- 下载后视频无声:这通常是因为没有安装或正确配置 FFmpeg。请回到第一步检查 FFmpeg 的安装和环境变量设置。
- 下载速度慢:尝试增加下载线程数,如
lux -n 20。 - 特定网站无法下载:Lux 在不断更新中,如果遇到支持问题,可以查看项目的 GitHub Issues 或尝试更新到最新版本。
- 获取更多帮助:在终端中输入
lux -h可以查看所有支持的命令行选项。






