夸克网盘自动化助手终极指南：Docker一键部署与完整教程

还在为手动管理夸克网盘资源而烦恼吗？每天重复检查更新、手动转存、整理文件名，这些繁琐的操作不仅耗时耗力，还容易错过重要资源更新。quark-auto-save正是为解决这些痛点而生的自动化神器，让你彻底解放双手，享受智能云存储管理。

为什么选择quark-auto-save？

这款基于Python开发的开源工具具备以下核心优势：

• 全自动转存：自动识别并转存分享链接中的新文件
• 智能命名整理：支持正则表达式过滤和重命名文件
• 多账号管理：同时管理多个夸克网盘账号的签到和转存任务
• 媒体库集成：与Emby媒体库无缝对接，自动刷新资源
• 灵活通知：支持多种推送渠道，实时掌握任务状态
• WebUI管理：图形化界面配置，操作简单直观

两种部署方式对比

Docker容器化部署（推荐）

Docker部署是最简单快捷的方式，无需配置Python环境，一键即可运行：

docker run -d \
  --name quark-auto-save \
  -p 5005:5005 \
  -e WEBUI_USERNAME=myadmin \
  -e WEBUI_PASSWORD=mypassword123 \
  -v ./config:/app/config \
  -v /etc/localtime:/etc/localtime \
  --restart unless-stopped \
  cp0204/quark-auto-save:latest

部署完成后，在浏览器访问 http://你的服务器IP:5005 即可进入Web管理界面。

本地Python部署

适合开发者和喜欢手动配置的用户：

git clone https://gitcode.com/gh_mirrors/qu/quark-auto-save.git
cd quark-auto-save
pip install -r requirements.txt
python app/run.py

实战配置：从零开始搭建自动化任务

第一步：获取夸克网盘Cookie

使用手机端夸克APP登录网盘，通过抓包工具获取以下关键参数：

• kps
• sign
• vcode

这些参数是自动化操作的身份凭证，确保妥善保管。

第二步：配置基础设置

编辑配置文件 quark_config.json，填入你的Cookie信息：

{
  "cookie": [
    "你的夸克网盘Cookie，仅此账号执行转存任务",
    "第二个账号Cookie，仅用于签到"
  ]
}

第三步：创建自动化任务

以下是一个完整的任务配置示例：

{
  "taskname": "追剧任务-示例",
  "shareurl": "https://pan.quark.cn/s/分享链接ID",
  "savepath": "/video/电视剧/剧名/季度",
  "pattern": "^广告内容(\\d+)\\.(mp4|mkv)",
  "replace": "\\1.\\2",
  "enddate": "2024-12-31",
  "runweek": [1, 3, 5],
  "ignore_extension": true
}

正则表达式实战技巧

正则表达式是文件过滤和重命名的核心工具，以下是一些实用示例：

场景	原始文件名	正则pattern	替换replace	结果文件名
去除广告前缀	【电影网】影片01.mp4	^【.*?】(.*)\\.mp4	\\1.mp4	影片01.mp4
剧集编号	01.mp4	^(\\d+)\\.mp4	S01E\\1.mp4	S01E01.mp4
魔法匹配剧集	各种剧集文件	$TV	(留空)	自动标准化命名

高级功能配置指南

Emby媒体库集成

配置Emby连接后，转存完成会自动刷新媒体库：

{
  "emby": {
    "url": "http://你的emby服务器:8096",
    "apikey": "你的Emby API密钥"
  }
}

多通知渠道配置

支持企业微信、Server酱等多种通知方式：

{
  "push_config": {
    "QYWX_AM": "企业微信应用配置",
    "QUARK_SIGN_NOTIFY": true
  }
}

智能任务调度

• 按周执行：指定任务只在特定星期几运行
• 结束日期：设置任务自动结束时间
• 子目录更新：支持递归更新特定子目录中的文件

常见问题排查

Cookie失效问题

如果遇到转存失败，首先检查Cookie是否过期，需要重新获取。

分享链接失效

程序会自动检测并跳过失效的分享链接，在配置中会标记为"分享地址已失效"。

正则表达式错误

编写正则时注意JSON转义，\d需要写成\\d，.需要写成\\.。

磁盘空间不足

定期检查网盘空间，确保有足够的空间存储转存文件。

最佳实践建议

1. 合理设置执行频率：避免过高频率运行，建议每天1-2次
2. 使用测试任务：先用提供的测试任务验证配置是否正确
3. 定期备份配置：重要的任务配置建议定期导出备份
4. 监控运行日志：通过日志了解任务执行情况和发现问题

quark-auto-save让夸克网盘管理变得前所未有的简单高效。无论是追剧更新、资料收集还是媒体库维护，这个工具都能为你节省大量时间和精力。现在就开始你的自动化网盘管理之旅吧！