返回目录
开源项目开发者工具类新手

GitHub - iawia002/lux: 👾 Fast and simple video download library and CLI tool written in Go

Lux 是一个用 Go 编写的快速、简单的视频下载库和命令行工具,支持 YouTube、Bilibili、抖音、优酷、爱奇艺、腾讯视频等多个网站的视频、图片、音频和播放列表下载。

0 次阅读2026/08/14 发布
GitHub - iawia002/lux: 👾 Fast and simple video download library and CLI tool written in Go 来源图片

社区作者 · zZz

它解决什么问题

Lux 是一个用 Go 语言实现的视频下载命令行工具,支持多站点解析与下载,具备多线程下载、断点续传、播放列表下载、字幕下载、Cookie/Referrer/代理设置、Debug 模式、JSON 数据提取等功能。

主要功能包括:

  • 下载单个视频:lux "视频URL"
  • 查看视频可用清晰度:lux -i "视频URL",通过 -f 流ID 下载指定清晰度
  • 下载播放列表:lux -p "播放列表URL",支持 -start-end-items 指定下载范围
  • 批量下载多个 URL,也可通过 -F 文件路径 从文件读取链接
  • 断点续传:Ctrl+C 中断后保留 .download 临时文件,再次运行相同命令可继续下载
  • 自动重试:下载失败时自动重试,可通过 -retry 设置次数(默认 10)
  • 多线程下载:通过 --multi-thread 开启,--thread/-n 设置线程数(默认 10)
  • Cookie 支持:可通过 -c 传字符串或 Netscape 格式的 cookie 文件
  • 代理支持:通过环境变量 HTTP_PROXY 设置 HTTP/SOCKS5 代理
  • 指定 Referrer:-r 选项
  • 指定输出路径与文件名:-o-O 选项
  • 字幕下载:-C 下载字幕,支持 YouTube 按语言筛选及嵌入字幕
  • 调试模式:-d 输出网络请求信息
  • 提取数据:-j 以 JSON 格式打印提取的数据

支持网站包括:抖音、哔哩哔哩、半次元、pixivision、优酷、YouTube、西瓜视频/头条、爱奇艺、新片场、芒果 TV、糖豆广场舞、Tumblr、Vimeo、Facebook、斗鱼视频、秒拍、微博、Instagram、Threads、Twitter、腾讯视频、网易云音乐、音悦台、极客时间、Pornhub、XVIDEOS、聯合新聞網、TikTok、Pinterest、好看视频、AcFun、Eporner、StreamTape、虎扑、虎牙视频、喜马拉雅、快手、Reddit、VKontakte、知乎、Rumble、小红书、Zing MP3、Bitchute、Odysee 等,支持视频、图片、音频和播放列表的不同组合。

— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

以下命令来源于项目 README。需要先安装依赖 FFmpeg(FFmpeg 不影响下载,只影响最终文件合并)。

步骤 1 · 通过

可复制命令
go install 安装

(需 Go 环境):

命令
go install github.com/iawia002/lux@latest

或从 Releases 页面下载二进制文件。

  1. macOS 使用 Homebrew:
命令
brew install lux
  1. Arch Linux:有 AUR 包可用。

$ xbps-install -S lux

  1. Void Linux:
  1. Windows 使用 Scoop:
命令
scoop install lux
  1. Windows 使用 Chocolatey:
命令
choco install lux

$ cask install github.com/iawia002/lux

  1. Windows/macOS/Linux 使用 Cask:

安装后基本使用:

  • 下载视频:lux "视频URL"
  • 查看所有清晰度:lux -i "视频URL"
  • 下载指定清晰度:lux -f 流ID "视频URL"
  • 下载播放列表:lux -p "播放列表URL"
  • 多个 URL 可一次性传入,或通过 -F 文件路径 从文件读取。

已知问题:

  • 优酷:ccode 经常变化导致 lux 不可用,可用 -ccode 手动指定新 ccode,最好每次下载都附带登录过的 Cookie。
  • 西瓜/头条视频:必须带 Cookie 才能下载成功,Cookie 有效期可能较短,失败后更新 Cookie 再试。

适用场景

下载单个视频
下载播放列表
批量下载多个 URL
下载图片和音频
断点续传下载
指定清晰度下载
下载字幕
多线程下载