开源神器quark-auto-save：实现夸克网盘到NAS的智能自动化转存

对于使用夸克网盘的用户来说，一个好消息是现在可以实现全自动化的管理体验。本文将介绍一个与夸克网盘相关的开源项目，它能够支持自动完成每日签到领取免费空间、自动转存分享链接、智能命名整理文件、发送推送通知以及自动刷新媒体库等一系列操作，实现真正的一条龙自动化流程。该项目还可关联配置 Alist（根据需求）、Aria2、Emby、Plex 等相关插件来扩展功能。同时，它集成了 CloudSaver 搜索源，这是一个在以往内容中曾被介绍过的资源搜索工具。

该项目属于开源项目，由开发者基于兴趣创建，旨在通过程序自动化来提升网盘使用效率。程序本身不涉及任何破解或修改行为，仅是对夸克网盘现有 API 的封装调用，所有数据交互均通过夸克官方 API 进行。

Image

如今，越来越多的 NAS 用户开始借助网盘资源来构建家庭影音库，以实现观影自由。除了最为热门的 115 和阿里云盘，夸克网盘也是主流选择之一。

然而，对于持续更新的剧集或资源，用户往往需要手动进行转存操作。如果追更的内容较少尚可应付，一旦需要管理的资源增多，频繁的手动操作就会变得相当繁琐。

本文将介绍的 cp0204/quark-auto-save 项目恰好能有效解决这一问题。它支持通过青龙面板或 Docker 进行部署，并提供了直观的 WebUI 界面供用户配置各项参数。本文旨在客观介绍项目功能，帮助读者判断其是否满足自身需求。

核心功能特性

分享链接处理

  • 支持转存分享链接内的子目录内容。
  • 能够自动识别并记录已失效的分享链接，并在后续任务中跳过。
  • 完美支持需要提取码的分享链接。
  • 具备智能资源搜索功能，可自动填充相关信息。

文件管理

  • 当目标转存目录不存在时，支持自动创建。
  • 智能跳过已经成功转存过的文件，避免重复操作。
  • 支持使用正则表达式对需要转存的文件名进行过滤。
  • 转存后支持对文件名进行整理（基于正则替换规则）。
  • 可选择忽略特定的文件后缀。

任务管理

  • 支持创建和管理多组独立的任务。
  • 可为任务设置结束期限，到期后该任务将不再执行。
  • 能够为单个子任务指定在星期几执行，调度灵活。

媒体库整合

  • 可根据任务名称自动搜索 Emby 媒体库中的对应项。
  • 在追更或文件整理完成后，可自动触发 Emby 媒体库刷新。
  • 媒体库功能采用模块化设计，用户可方便地自行开发 Hook 模块以支持其他媒体库（如 Plex）。

其他实用功能

  • 每日自动执行签到，领取夸克网盘空间。
  • 支持通过多个渠道（如 Telegram、Server 酱等）发送通知推送。
  • 支持多账号管理（所有账号均可用于签到，但仅首个账号用于文件转存）。

部署流程

此处以威联通（QNAP）NAS 为例，演示通过 Docker Compose 方式进行部署。以下是一个示例的 Docker Compose 配置代码（docker-compose.yml），请根据您自身的 NAS 存储路径进行修改：

services:
  quark-auto-save:
    image: cp0204/quark-auto-save:latest
    container_name: quark-auto-save
    ports:
      - 5005:5005 # 冒号左侧的宿主机端口可以按需修改
    restart: unless-stopped
    environment:
      WEBUI_USERNAME: "admin"   # 管理界面用户名，可自定义
      WEBUI_PASSWORD: "admin123" # 管理界面密码，请务必修改
    volumes:
      - /share/Container/quarksave/config:/app/config  # 必须：配置文件持久化存储
      - /share/Container/quarksave/media:/media # 可选：供 alist_strm_gen 模块生成 .strm 文件时使用

关于文件映射中提及的 Alist，鉴于近期的相关动态，用户可根据个人情况决定是否关联或使用此功能。

Image

此外，也提供标准的 Docker 命令行运行方式供参考（参数未做修改）：

docker run -d \
  --name quark-auto-save \
  -p 5005:5005 \ # 端口映射，:前为宿主机端口（可改），:后为容器端口（不可改）
  -e WEBUI_USERNAME=admin \
  -e WEBUI_PASSWORD=admin123 \
  -v ./quark-auto-save/config:/app/config \ # 必须，配置持久化
  -v ./quark-auto-save/media:/media \ # 可选，模块alist_strm_gen生成strm使用
  --restart unless-stopped \
  cp0204/quark-auto-save:latest
  # registry.cn-shenzhen.aliyuncs.com/cp0204/quark-auto-save:latest # 国内镜像地址（如需加速可使用此地址）

在威联通的 Container Station 应用中，选择“创建应用程序”，将上述 YAML 代码复制粘贴到编辑框中，修改必要的路径和参数后，即可创建并运行容器。

Image

配置与使用指南

该项目的 Wiki 文档已经相对完善，作者考虑十分周到。在 WebUI 界面中，遇到不清楚的配置项，通常可以点击旁边蓝色的“？”图标，跳转到相关的项目文档或解答页面进行查阅。

部署完成后，在浏览器地址栏输入 你的NAS_IP地址:5005（端口号根据你的映射设置）即可访问管理界面。

Image

使用部署时设置的用户名和密码（如示例中的 admin/admin123）进行登录。

Image

登录后的初始界面如图所示。界面左下角提供了一些相关链接，有需要的用户可以点击查看。

Image

首先，点击左上角的“系统配置”，在此处配置夸克网盘账户。关键的“Cookie”部分，可以点击“登陆”蓝色链接，页面将跳转至夸克网盘登录页，登录后从浏览器开发者工具中获取 Cookie。关于提取 Cookie 的具体方法已有大量教程，此处不再赘述。请务必注意“定时规则”的设定：网盘资源并非实时更新，严禁设置过高的任务执行频率（例如每分钟），以免触发账号风控或对夸克服务器造成不必要的压力。

Image

CloudSaver 上方的 API 接口可用于第三方集成开发，例如与机器人联动或通过油猴脚本快速添加任务。其中“Token”作为身份鉴权凭证，请务必妥善保管，切勿泄露，否则可能导致夸克 Cookie 泄露，进而危及网盘中的个人隐私文件。

插件配置部分，例如需要关联 Emby，只需在对应插件的控制台按照指引创建并配置即可。

Image

基本配置完成后，建议先进行测试。在“任务列表”中，可以找到并运行测试任务。

Image

查看“日志列表”，确认测试任务已成功执行。

Image

这是任务执行前，夸克网盘中对应的分享链接内容。

Image

任务成功执行后，程序自动在目标位置创建了目录，并将分享链接中的所有文件完整转存过来。

Image

Image