4370 字
22 分钟
自建服务实战:LibreGet 万能下载管理器
2026-11-15

先说问题:下载这件事,工具为什么越攒越多#

想把自己买的网课存到本地慢慢看,要装一个课程下载工具;想存 YouTube 视频,得记住 yt-dlp 那一长串参数,隔两个月不用就忘光;想存 Instagram 的动态、X 上的视频、Pinterest 的图板,又得各找一个网页下载站,界面全是广告,还动不动失效。工具散落一地,每个只管一摊,下载完的文件还得自己另外找播放器、找转码工具、找字幕工具。

LibreGet 的思路是把这一摊事收进一个桌面窗口:粘贴链接 → 预览选清晰度 → 下载 → 在同一个应用里播放、阅读、转录、转换、管理。底层该用 yt-dlp 的地方用 yt-dlp,该用原生解析的地方用原生解析,全部封装好,不用碰终端。

项目地址:https://github.com/OpenSelena/libreget

本篇主线:它是什么 → 能下什么 → 核心工作流 → 浏览器扩展配对 → 下完之后的管理与工具 → 给 AI 助手用的接口 → 三平台安装与首次启动排障 → 便携模式。

它是什么#

LibreGet 是一个开源免费的桌面下载管理器,用 Tauri 2.0 + Rust + Svelte 编写,GPL-3.0 协议,Windows、macOS、Linux 三平台全覆盖。它的定位很明确:免费、无账号、无广告、不收集你的下载记录,所有文件只落在你自己的电脑上。

几个关键设计先交代清楚:

  • 引擎自动托管:yt-dlp 和 FFmpeg 由应用自己下载、校验 SHA-256、保持更新,你不需要装 Python、不需要配环境变量、不需要开终端。
  • 原生解析优先:课程、Instagram、X、Pinterest、Bilibili、Telegram、种子这些高频场景有原生解析器,其余 1800 多个站点交给 yt-dlp 兜底。
  • 纯本地运行:没有官方服务器在中间中转。应用自己发起的网络请求只有三类——你让它下载的站点、去 GitHub 检查更新、以及你配置的 AI 服务(用 AI 工具时)。

能下什么#

在线课程:38 个平台#

内置的课程插件支持 38 个学习平台,包括 Udemy、Hotmart、Coursera、Domestika、Skillshare、Kiwify、Rocketseat 等。在应用内登录你的账号后,它会列出你已购买的课程,打开课程大纲勾选要下的章节,连同课件附件一起下载,支持断点续下和连续编号整理。这里的口径要说清:它只能下载你自己账号已经购买、能正常打开的课程,带 DRM 保护的课时会被自动跳过并报告,不做任何破解。买过的课趁平台还在先备份到本地,是这类工具最正当的用途。

视频与音频:1800 多个站点#

YouTube(视频、播放列表、频道、直播回放、章节、SponsorBlock 跳过)、Instagram、TikTok、X、Reddit、Twitch(点播、剪辑、直播)、Vimeo、Bluesky、Threads、Pinterest、抖音等热门站点有专门优化,其余长尾站点由 yt-dlp 覆盖,总数 1800 以上。保存格式上,视频可存 MP4、MKV、WebM,音频可存 MP3、M4A、Opus、FLAC、WAV,字幕可存 SRT、VTT、ASS,可内嵌也可旁挂。

Bilibili:登录后的完整体验#

登录自己的 Bilibili 账号后,按账号权限下载 4K、HDR、杜比视界、高清无损音频;弹幕可导出为 XML、ASS 或 JSON,还能生成供 Kodi 和 Jellyfin 识别的 NFO 文件,支持番剧、课程、收藏夹、稍后再看、历史记录等 11 类链接。

图库与其它#

图库走 gallery-dl 引擎,覆盖 DeviantArt、Pixiv、ArtStation、Flickr、Tumblr、Imgur 等 250 多个站点,可整站、整画师、整图板备份。另外还支持 .torrent 文件与磁力链接(内置 BitTorrent 客户端)、Telegram 频道与群组里的文件(内置 Telegram 插件,按频道自动归档到 LibreGram/<频道名>/ 文件夹)、批量粘贴链接或导入 .txt 批量下载、两台 LibreGet 之间用短口令互传文件。

和其它方案比一比#

维度LibreGet裸用 yt-dlp单站网页下载站付费课程下载器
站点覆盖课程、Instagram、X、Pinterest、Bilibili、Telegram、种子原生支持,另加 yt-dlp 的 1800+1800+一个一两个平台
安装门槛下载一个文件打开即用Python、PATH、FFmpeg、记参数无安装包加许可证密钥
登录内容浏览器扩展转发你的登录态手动导出 --cookies基本不行部分支持
下载队列断点续传、退避重试、规则分流、订阅频道自动下新一次一条命令无不一定
下完之后播放器、阅读器、闪卡、笔记、158 个工具只有文件只有文件,还常被转码只有文件
价格与协议免费,GPL-3.0免费,Unlicense免费但带广告订阅付费

结论很直白:如果你就住在终端里、只要文件本身,裸用 yt-dlp 就够了;如果你想要一个窗口管完下载加整理,LibreGet 是目前开源里完成度最高的那个。

核心工作流:一分钟下第一个文件#

  1. 打开 LibreGet,首次启动选好语言和主题,点一下它就自动装好 yt-dlp 和 FFmpeg(下载后先验 SHA-256 再运行)。
  2. 复制任意链接:YouTube 视频、Instagram 短视频、X 帖子、Pinterest 图板、磁力链接、直链文件都行。
  3. 粘贴到主页的输入框,它自动识别站点,展示标题、缩略图和可选清晰度,选好按回车开下。

下载页会实时显示速度、阶段和预计剩余时间(数据直接读自下载引擎,卡住就是卡住,不会假装还剩 3 秒)。几个用顺手之后回不去的设计:

  • 断点续传:中断的任务保留部分文件,下次接着下;遇到限流自动退避重试;每个站点的并发连接数自适应——YouTube 可以拉到 16 路分片并行,返回 429 的站点自动降速。
  • 全局热键:在任何地方复制链接后按 Ctrl+Shift+D(macOS 是 Cmd+Shift+D),后台直接开下,不用切窗口;Ctrl+Shift+M 只抓音频,YouTube 链接直接变 MP3。这两个热键默认关闭,在「设置 → 下载 → 剪贴板与热键」里开启,也可以改键。
  • 一次设置长期生效:默认清晰度、纯音频格式、字幕语言与格式、文件名模板、按平台分文件夹、跳过已存在文件、限速、并发数都可以预设;规则功能可以把某个频道或站点固定分流到指定文件夹和清晰度;订阅的频道会在后台检查更新,有新内容自动下载并托盘通知。
  • 每条任务留底:每个下载任务都保存它实际执行的 yt-dlp 命令,打开就能看,想改参数重试不用重新拼命令。

命令行党也有份:每次发布都带 libreget-cli,常用法如下:

Terminal window
libreget info <url> # 只看标题、格式和大小,不下载
libreget download <url> -q 1080 -o ~/Videos
libreget download <url> --audio-only --subs en,zh
libreget batch links.txt -m 3 # 一行一个链接,3 个并发
libreget import-cookies cookies.txt # Netscape 格式

浏览器扩展:登录内容的关键一环#

很多内容不登录看不到:你买的课、仅粉丝可见的视频、Instagram 的限时动态。LibreGet 处理登录态的方式是装一个浏览器扩展,由它把你在浏览器里的登录 Cookie 和来源页一起转发给应用——前提永远是那是你自己的账号、你自己的浏览器会话,它不绕过任何登录墙和付费墙。

扩展在已识别的站点(YouTube、Instagram、TikTok、X、Reddit、Twitch、Pinterest、Bluesky、Telegram、Vimeo、Udemy、Hotmart、Bilibili、SoundCloud 等)上点图标或按 Alt+O 一键发送当前页;对其它站点,它会嗅探页面里的 MP4、HLS、DASH、WebM 和音频流列在弹窗里供你挑。装法分三档,由简到繁:

第一档:应用内安装(推荐,不用下载任何压缩包)

  1. 打开 LibreGet,进入「设置 → 插件 → 浏览器扩展」,点 Chrome 旁边的「更新/安装」,它会把内置的扩展复制到一个文件夹并自动打开。
  2. 在 Chrome(Edge、Brave 等 Chromium 浏览器同理)地址栏输入 chrome://extensions。
  3. 打开右上角的「开发者模式」。
  4. 点「加载已解压的扩展程序」,选中刚才打开的文件夹。
  5. 工具栏出现 LibreGet 图标,一个选项页会自动打开并寻找应用。
  6. 回到 LibreGet 同一设置页,点「配对扩展」,几秒后显示「扩展已连接」,选项页变绿,完成。

第二档:用发布包里的 zip。每个版本都附带 libreget-chrome-extension-vX.Y.Z.zip,解压后按第一档第 3 步往下走即可。适合浏览器和应用不在同一台机器,或者帮别人装的场景。

第三档:Firefox 与手动配对。Firefox 在同样的设置页点 Firefox 的「更新/安装」,再打开 about:debugging#/runtime/this-firefox,点「临时加载附加组件」选导出文件夹里的 manifest.json(注意 Firefox 临时组件重启后会掉,要重装一次,等上架官方商店后就没这问题;Safari 暂不支持)。如果自动配对超时,打开扩展的选项页,把 LibreGet 里显示的配对令牌粘贴进去即可——应用只监听本机 127.0.0.1 的 47720–47729 端口,令牌每台机器独立生成,数据不出本机。

小提醒:如果扩展装了但 LibreGet 没开着,点击会走 libreget:// 链接唤起应用排队,但带不了 Cookie;Chrome 第一次问是否允许时记得勾「始终允许」。

下完之后:不只是个下载器#

LibreGet 真正和其它下载工具拉开差距的是下载之后:

  • 内置播放器与阅读器:下完的课程直接在应用里播,PDF 直接在应用里读,还有闪卡和笔记功能,备份下来的课不用再倒腾到别的软件里。
  • 158 个内置小工具(25 类):每个工具是一个独立的 Rust 命令,全部在本机运行。挑最实用的几类说:
    • 语音与字幕(8 个):用 whisper.cpp 本地离线转录音视频成字幕(模型按需下载)、字幕翻译、文字转语音、按字幕配音等。
    • 视频编辑(14 个):截取片段、转码换容器/编码/分辨率、精确压缩到指定大小(如 10 MB 发 Discord)、视频转 GIF、剪静音段、字幕格式互转与烧录、字幕对轴、画面防抖与修复、录屏。
    • PDF(13 个):合并、拆分、压缩、转换、OCR、修复、加解密与权限、水印页码、裁边、生成目录、转 Markdown 等。
    • 平台工具:YouTube 工具 11 个(封面、评论导出、双语字幕合并等)、Instagram 24 个、X 10 个、Pinterest 10 个,另有图片、文档、音频(响度标准化、降噪)、系统、CTF 分析等类别。
  • 命令面板:Ctrl+K(macOS Cmd+K)直达任意页面、设置或工具;还有 14 套主题、12 种界面语言(含简体中文)可选。

下完的影音文件如果量大,建议归档进媒体库统一管理——本系列的 Jellyfin 影音库 正是干这个的;散文件想跨设备随时取用,可以放进 Alist 网盘聚合;多台设备之间的文件夹同步方案见 文件同步篇。

给 AI 助手用的接口:MCP 与插件#

这是 LibreGet 一个很超前的设计:它内置了 MCP 服务器。工具的内部实现本来就是「JSON 进、JSON 出」的独立命令,所以开放给 AI 助手几乎是顺手的事。

  • 应用内 MCP 服务器:在「工具 → AI → MCP 服务器」里开启后,它通过与浏览器扩展相同的本机桥接通道、同一套每机独立令牌,对外提供 37 个工具。助手可以把链接加入下载队列并查看、暂停、恢复、取消任务,可以合并拆分 PDF、转录文件、文字转语音、OCR、图片缩放去重、文件搜索等。设置页直接给出 Claude Code、Claude Desktop、Cursor、VS Code、Goose、Codex 的现成配置片段,复制粘贴即可,不用自己拼。
  • Claude Code 插件:仓库里的 claude-plugin/ 文件夹提供一个不需要桌面应用的插件,粘贴视频、音频或社交帖子链接并说明需求,libreget-fetch 与 libreget-transcribe 两个技能会自动触发;也可以用斜杠命令显式调用:
/plugin marketplace add /path/to/libreget/claude-plugin
/plugin install libreget
/libreget:setup # 一次确认后装好 yt-dlp、ffmpeg 与 libreget-cli
/libreget:fetch <url> [--audio] # 下载媒体到 ~/Downloads/libreget
/libreget:transcribe <url|file> # 先取字幕,再本地 whisper.cpp,最后才用云端
/libreget:research <url> # 字幕加转录整理成带 [mm:ss] 引用的 Markdown 笔记
/libreget:doctor # 检查装了什么、缺什么、怎么补
WARNING

MCP 服务器和浏览器扩展共用同一个本机令牌,令牌只在本机使用、不要外发给任何人或粘贴到在线服务里;给助手开 MCP 等于允许它调用你电脑上的下载与文件工具,装好后先在小任务上试一轮,确认行为符合预期再放手批量使用。

安装:三平台各自的拿法#

所有版本都在 GitHub 的 Releases 页发布,应用内可自动更新。

系统下载什么其它装法
Windows 10 / 11libreget_x.y.z_x64-setup.exe(安装版)、libreget_x.y.z_x64-portable.exe(便携版)、libreget_x.y.z_x64_en-US.msi(批量部署)winget install -e --id OpenSelena.LibreGet
macOS 10.15+Apple 芯片用 libreget_x.y.z_aarch64.dmg,Intel 用 libreget_x.y.z_x64.dmgbrew install --cask OpenSelena/tap/libreget
LinuxDebian/Ubuntu 用 .deb,Fedora/openSUSE/RHEL 系用 .rpm,其它发行版用 .AppImage(均含 x86_64 与 ARM64)AppImage 靠随附的 .zsync 文件自更新

命令行一把梭的装法:

Terminal window
winget install -e --id OpenSelena.LibreGet
Terminal window
brew install --cask OpenSelena/tap/libreget

务必只从 GitHub 官方 Releases、winget 或上述 Homebrew 仓库安装,不要从来路不明的下载站拿安装包——这类热门免费工具最容易被捆绑恶意软件重新打包。

便携模式:整个应用装进 U 盘#

Windows 下在便携版 .exe 同目录新建一个空文件 portable.txt(或 .portable),重新启动后,设置、数据库、Cookie、插件、缓存以及 yt-dlp 和 FFmpeg 全部搬到 exe 旁边的 data 文件夹,不碰系统的 AppData。整个文件夹拷进 U 盘,换台电脑插上就能用,自己的下载环境随身走。

常见问题与排障#

Q:Windows 第一次打开弹出 SmartScreen 蓝色警告,怎么办? A:这是因为应用没有购买付费代码签名证书,开源桌面软件常见。点「更多信息」→「仍要运行」即可,只需处理一次。前提是你从官方渠道下载的安装包。

Q:macOS 提示应用「已损坏」打不开? A:把应用拖进「应用程序」后,打开终端执行下面两行去掉隔离属性并本地签名,之后正常从启动台打开,同样只需一次:

Terminal window
xattr -cr /Applications/libreget.app
codesign --force --deep --sign - /Applications/libreget.app

Q:Linux 上 AppImage 报 libfuse 错误起不来? A:Debian 12+、Ubuntu 24.04+ 不再自带 FUSE 2。装一下 sudo apt install libfuse2,或者用 ./libreget.AppImage --appimage-extract-and-run 方式运行;用 .deb 包则完全没有这个问题。

Q:Linux 下播放器黑屏或应用直接闪退? A:界面用 WebKitGTK 渲染,音视频走 GStreamer 解码,缺插件会导致播放器一出现就崩。多数桌面发行版自带,Arch 和精简镜像需手动装齐(.deb、.rpm 会自动带依赖,主要是 AppImage 和手动构建会遇到):

Terminal window
sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-libav # Debian、Ubuntu
sudo dnf install gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugin-libav # Fedora
sudo pacman -S gst-plugins-good gst-plugins-bad gst-libav # Arch

Q:需要装 Python 或 Node 吗?平时要开终端吗? A:都不需要。下载应用、打开、粘贴链接三步完事;唯一的终端操作就是上面 macOS 那次性的两行命令。

Q:登录后才能看的内容下不了? A:先确认浏览器扩展已装好且显示「扩展已连接」——登录 Cookie 靠它转发;再确认你在浏览器里确实处于登录状态且能正常打开那个页面。应用只能取到你自己会话能打开的内容,带 DRM 的课时会明确跳过并报告,这是设计如此,不是故障。

Q:下载到一半断了、或者站点返回 429? A:直接在下载页点继续即可断点续传;429 是站点限流,应用会自动退避重试并降低该站点的并发,挂着等它自己恢复,不要手动连点重试火上浇油。

Q:它和裸用 yt-dlp 到底什么关系? A:yt-dlp 是它长尾站点的下载引擎,由它内置、校验并自动更新;课程、Instagram、X、Pinterest、Bilibili、Telegram、种子走原生解析。在这之上是队列续传、工具区和格式转换。你在任务详情里能看到每条任务实际跑的 yt-dlp 命令,想接管随时接管。

Q:从源码构建要注意什么? A:需要 Rust(工具链版本被 rust-toolchain.toml 锁定,因为插件 ABI 依赖它)、Node.js 18+ 和 pnpm:

Terminal window
git clone https://github.com/OpenSelena/libreget.git
cd libreget
pnpm install
pnpm tauri dev

正式构建要用 pnpm tauri build --config '{"bundle":{"createUpdaterArtifacts":false}}',否则会因为缺少发布签名私钥在生成更新包那步停住。普通使用直接下 Releases 就好,不必自己构建。

小结#

下载这件事的麻烦从来不在「下不动」,而在工具散、参数多、下完还要二次整理。LibreGet 把课程备份、1800 多站点的视频音频图库下载、断点续传队列、浏览器登录态、播放阅读、转录转换等 158 个小工具,连同给 AI 助手调用的 MCP 接口,全部收进一个免费开源、纯本地运行的桌面窗口里。如果你手上正攒着一堆买过的课和散落各处的下载小工具,它值得成为那个唯一的入口。

自建服务实战:LibreGet 万能下载管理器
https://www.anexns.cloudns.org/posts/selfhost-libreget/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0