Kubespider：把局域网闲置服务器变成自动下载中心

很多人家里都有一台闲置的服务器或 NAS，平时也就存存文件，利用率很低。Kubespider 这个项目做的事情，就是把这台闲置机器变成一个全自动的资源下载中心。电视剧更新了自动下载，YouTube 有新视频自动抓取，B站关注的UP主发了新内容也能自动同步。

这个项目目前在 GitHub 上有 2191 个 Star，基于 Docker 部署，支持 Linux 系统。

它解决什么问题

平时下载资源，你可能要打开好几个网站，用好几个工具。YouTube 用 yt-dlp，B站用另一个工具，磁力链接又得开个下载器。Kubespider 的思路是把这些全合到一起，做一个统一的调度层。

它的架构分三部分：

• kubespider-core：核心调度模块，接收下载请求，调用资源解析，再分配给下载工具执行
• source-provider：适配各个资源网站，把不同格式的地址统一解析成标准下载链接
• download-provider：对接各种下载软件，比如 aria2、qBittorrent、迅雷等

这种分层设计的好处是，要支持新网站只需要加一个 source-provider，要支持新下载器只需要加一个 download-provider，核心逻辑不用动。

支持哪些资源网站

目前已有的适配覆盖面比较广：

• 动漫：蜜柑计划（mikanani）、ANi，支持自动追番
• 视频：YouTube、B站（含UP主订阅自动下载）、抖音
• 美剧：meijutt，自动下载更新的剧集
• 通用：RSS 订阅源、btbtt12 种子站
• 网盘：alist，可以自动同步云存储里的新增文件
• 自定义：Magic source provider，通过 xpath 配置抓取任意网站

基本上主流的资源站点都覆盖了，而且配置方式统一，不用每个站点单独折腾。

下载器支持

Kubespider 不自己实现下载功能，而是对接已有的下载软件：

• aria2（默认安装）
• qBittorrent
• 迅雷
• yt-dlp（YouTube 专用）
• you-get
• transmission
• yutto（B站专用）

这意味着你可以根据资源类型选择最合适的下载器。比如 YouTube 视频走 yt-dlp，磁力链接走 aria2，各取所长。

安装和使用

安装过程比较省心，克隆仓库后跑一个脚本就行：

git clone https://github.com/opennaslab/kubespider.git
cd kubespider
bash hack/install_kubespider.sh

脚本会自动拉取 Docker 镜像，部署 Kubespider 和 Aria2。装完之后，下载的文件默认存在 ~/kubespider/nas 目录下，配置文件在 ~/kubespider/.config。

项目还提供了 Chrome 浏览器插件，安装后在网页上右键就能把当前页面的资源发送到 Kubespider 下载。对于日常使用来说，这个交互方式比较顺手。

除了默认的 Docker 安装，项目还支持在群晖、威联通、华硕、绿联等 NAS 设备上部署，文档里都有详细说明。

通知和扩展

下载完成后可以通过多种方式通知你：Pushdeer、Telegram、QQ、Bark 都支持。不用一直盯着下载进度，完成了会自动提醒。

整体来看，Kubespider 是一个思路清晰的项目。它没有重新造轮子去实现下载功能，而是把现有的优秀工具串起来，做一个统一的调度平台。对于有闲置服务器的人来说，值得花半小时部署试试。

晰的项目。它没有重新造轮子去实现下载功能，而是把现有的优秀工具串起来，做一个统一的调度平台。对于有闲置服务器的人来说，值得花半小时部署试试。