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_PROXYSOCKS5_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 可以查看所有支持的命令行选项。