慕橙AI正在绞尽脑汁想思路ING···

慕橙のAI摘要

deepseek-v4-flash

夸克网盘自动转存（QAS）部署与使用教程

🎯 一站式解决方案：夸克网盘签到、自动转存、命名整理、推送提醒和刷新媒体库一条龙。

对于一些持续更新的资源，隔段时间去转存十分麻烦。定期执行本脚本自动转存、文件名整理，配合 SmartStrm / OpenList / Emby 可达到自动追更的效果。🥳

重要提醒

⛔️⛔️⛔️ 资源不会每时每刻更新，严禁设定过高的定时运行频率！ 以免账号风控和给夸克服务器造成不必要的压力。

雪山崩塌，每一片雪花都有责任！

一、项目介绍

夸克网盘自动转存（QAS） 是一款基于 Docker 部署的开源工具，专注于解决网盘资源的手动转存痛点。通过简单的正则表达式和任务配置，即可实现资源的自动追更、文件名整理及媒体库联动刷新。

核心优势

🐳 Docker 一键部署：提供 WebUI 图形化配置界面
🔄 全自动转存：定时执行，无需人工干预
📝 智能命名：正则表达式批量整理文件名
📺 媒体库联动：自动刷新 Emby / Jellyfin 等媒体库
🔌 插件化扩展：支持模块化插件开发

项目信息

项目	信息
项目名称	quark-auto-save
镜像名称	`cp0204/quark-auto-save:latest`
默认端口	`5005`
默认账号	`admin`
默认密码	`admin123`
国内镜像	`registry.cn-shenzhen.aliyuncs.com/cp0204/quark-auto-save:latest`

二、功能特性

2.1 部署方式

✅ 可能兼容青龙
✅ Docker 部署，提供 WebUI 配置

2.2 分享链接

✅ 支持分享链接的子目录
✅ 记录失效分享并跳过任务
✅ 支持需提取码的分享链接
✅ 智能搜索资源并自动填充

2.3 文件管理

✅ 目标目录不存在时自动新建
✅ 跳过已转存过的文件
✅ 正则过滤要转存的文件名
✅ 转存后文件名整理（正则替换）
✅ 可选忽略文件后缀

2.4 任务管理

✅ 支持多组任务
✅ 任务结束期限，期限后不执行此任务
✅ 可单独指定子任务星期几执行

2.5 媒体库整合

✅ 根据任务名搜索 Emby 媒体库
✅ 追更或整理后自动刷新 Emby 媒体库
✅ 插件模块化，允许自行开发和挂载插件

2.6 其它功能

✅ 每日签到领空间
✅ 支持多个通知推送渠道
✅ 支持多账号（多账号签到，仅首账号转存）

三、部署教程

3.1 准备工作

部署前准备

一台运行 Docker 的服务器（推荐 Linux / NAS）
已安装 Docker 和 Docker Compose（可选）
服务器开放 5005 端口（可自定义）
一个可用的 夸克网盘 账号和 Cookie

3.2 部署方式

使用 docker run 一键部署：

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 \
  --network bridge \
  --restart unless-stopped \
  cp0204/quark-auto-save:latest

注意：-p 5005:5005：冒号前的端口可修改（即部署后访问的端口），冒号后的端口不可修改。

国内用户

国内用户可使用阿里云镜像加速拉取：

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 \
  --network bridge \
  --restart unless-stopped \
  registry.cn-shenzhen.aliyuncs.com/cp0204/quark-auto-save:latest

使用 docker-compose.yml 部署（推荐）：

新建 docker-compose.yml 文件，写入以下内容：

name: quark-auto-save
services:
  quark-auto-save:
    image: cp0204/quark-auto-save:latest
    container_name: quark-auto-save
    network_mode: bridge
    ports:
      - 5005:5005
    restart: unless-stopped
    environment:
      WEBUI_USERNAME: "admin"
      WEBUI_PASSWORD: "admin123"
    volumes:
      - ./quark-auto-save/config:/app/config
      - ./quark-auto-save/media:/media

然后执行：

1	docker-compose up -d

3.3 访问管理后台

部署完成后，浏览器访问：

1	http://yourhost:5005

将 yourhost 替换为您的服务器 IP 或域名。

部署成功

首次访问使用默认账号密码登录后，请立即修改密码！

3.4 环境变量配置

环境变量	默认值	备注
`WEBUI_USERNAME`	`admin`	管理账号
`WEBUI_PASSWORD`	`admin123`	管理密码
`PORT`	`5005`	管理后台端口
`PLUGIN_FLAGS`	（空）	插件标志，如 `-emby,-aria2` 禁用某些插件
`TASK_TIMEOUT`	`1800`	任务执行超时时间（秒），超时则任务结束

3.5 一键更新

使用 Watchtower 实现自动更新：

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  -cR quark-auto-save

3.6 WebUI 预览

夸克自动转存 - WebUI 主页
夸克自动转存 - 启动界面

四、使用说明

4.1 正则处理示例

教程说明

正则表达式是 QAS 的核心功能之一，通过灵活的 pattern 和 replace 规则，可以实现自动化的文件命名整理。

pattern	replace	效果
`.*`	（空）	无脑转存所有文件，不整理
`\.mp4$`	（空）	转存所有 `.mp4` 后缀的文件
`^【电影TT】花好月圆(\d+)\.(mp4\|mkv)`	`\1.\2`	`【电影TT】花好月圆01.mp4` → `01.mp4` `【电影TT】花好月圆02.mkv` → `02.mkv`
`^(\d+)\.mp4`	`S02E\1.mp4`	`01.mp4` → `S02E01.mp4` `02.mp4` → `S02E02.mp4`
`$TV`	（空）	魔法匹配剧集文件
`^(\d+)\.mp4`	`{TASKNAME}.S02E\1.mp4`	`01.mp4` → `任务名.S02E01.mp4`

更多正则使用说明：正则处理教程

在正则处理中，我们定义了一些"魔法匹配"模式。如果 表达式 的值以 $ 开头且 替换式 留空，程序将自动使用预设的正则表达式进行匹配和替换。

自 v0.6.0 开始，支持更多以 {} 包裹的"魔法变量"，可以更灵活地进行重命名。

更多说明请看：魔法匹配和魔法变量

4.2 刷新媒体库

在有新转存时，可触发完成相应功能，如自动刷新媒体库、生成 .strm 文件等。配置指南：插件配置

媒体库模块以插件的方式的集成，如果你有兴趣请参考：插件开发指南

4.3 更多使用技巧

请参考 Wiki：使用技巧集锦

五、生态项目

以下展示 QAS 生态项目，包括官方项目和第三方项目。

5.1 官方项目

项目	简介
QAS 一键推送助手	油猴脚本，在夸克网盘分享页面添加推送到 QAS 的按钮
SmartStrm	STRM 文件生成工具，用于转存后处理，媒体免下载入库播放

5.2 第三方开源项目

风险提示

以下第三方开源项目均由社区开发并保持开源，与 QAS 作者无直接关联。在部署到生产环境前，请自行评估相关风险。

如果您有新的项目没有在此列出，可以通过 Issues 提交。

项目	简介
nonebot-plugin-quark-autosave	QAS Telegram 机器人，快速管理自动转存任务
Astrbot_plugin_quarksave	AstrBot 插件，调用 `quark_auto_save` 实现自动转存资源到夸克网盘
Telegram 媒体资源管理机器人	一个功能丰富的 Telegram 机器人，专注于媒体资源管理、Emby 集成、自动下载和夸克网盘资源管理