夸克网盘自动转存系统技术文档

最新推荐文章于 2025-04-23 07:23:25 发布

计嫱甜

最新推荐文章于 2025-04-23 07:23:25 发布

阅读量1.6k

点赞数 24

本文链接：https://blog.csdn.net/gitblog_01287/article/details/143045254

版权

夸克网盘自动转存系统技术文档

quark-auto-save 夸克网盘签到、自动转存、命名整理、发推送提醒和刷新媒体库一条龙项目地址: https://gitcode.com/gh_mirrors/qu/quark-auto-save

安装指南

Docker部署（推荐）

启动容器：通过以下命令部署项目至Docker环境中，确保您已安装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 /etc/localtime:/etc/localtime \
  --network bridge \
  --restart unless-stopped \
  cp0204/quark-auto-save:latest

此命令将拉取最新版本的镜像，并创建一个名为quark-auto-save的容器，开放5005端口以供访问WebUI界面。

环境配置：利用环境变量配置管理用户名和密码。您可以自定义WEBUI_USERNAME和WEBUI_PASSWORD值。

自动更新：为了维持软件的最新状态，可以使用Watchtower自动化更新容器。

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

青龙面板部署

添加仓库：在青龙面板的插件管理页面，输入下列命令来添加项目仓库。

ql repo https://github.com/Cp0204/quark-auto-save.git "quark" "" "notify"

配置文件编辑：首次运行后，需要手动编辑quark_config.json文件，位于青龙的任务脚本目录下。若删除该配置文件并设置QUARK_COOKIE环境变量，将仅执行签到操作。

项目使用说明

夸克网盘自动转存系统设计用于自动化管理夸克网盘资源，涵盖自动签到、智能转存、文件整理、媒体库同步等核心功能。

任务配置：在WebUI中或直接编辑JSON配置文件，定义分享链接、目标存储路径、文件命名规则以及任务执行的特定条件。
文件处理：支持通过正则表达式对文件名进行整理，实现标准化命名，同时能智能跳过已转存文件，支持任务周期性执行控制。
媒体库整合：配置Emby信息后，每次转存或整理后会自动更新媒体库，确保您的观影体验无缝对接。

API使用文档

项目并未公开明确的外部API接口，主要通过内部脚本和配置文件交互。不过，您可以利用其配置机制（特别是quark_config.json），间接“控制”软件的行为，这类似于一种配置层面的“API”。

配置字段说明：
- Cookie: 包含夸克网盘的登录凭证，是自动操作的基础。
- Push Config: 设置通知服务，启用成功签到通知等功能。
- Tasklist: 区域内定义转存任务，含分享URL、保存路径、文件命名逻辑、任务执行规则等。
注意事项：配置文件内的正则表达式用于文件名的匹配和转换，应遵循Python正则语法。