ozoo0/cloud-auto-save repository overview

⁠推荐

欢迎关注全新项目CASX⁠，全新自动追剧一体化平台 更智能、更好用；支持自动修复异常任务替换链接；如你计划继续长期使用当前工具，建议顺手点个 Star 并关注新项目动态。

⁠功能

• 部署方式
  • 可能兼容青龙
  • Docker 部署，WebUI 配置
• 网盘支持情况
  • 夸克网盘
  • 115网盘
  • 百度网盘
  • 阿里云盘
  • UC网盘
  • 迅雷网盘(长时间token会过期！)
  • 123网盘
  • 天翼云盘
• 分享链接
  • 支持分享链接的子目录
  • 记录失效分享并跳过任务
  • 支持需提取码的分享链接 ^?⁠
  • 智能搜索资源并自动填充 ^?⁠
• 文件管理
  • 目标目录不存在时自动新建
  • 跳过已转存过的文件
  • 正则过滤要转存的文件名
  • 转存后文件名整理（正则替换）
  • 可选忽略文件后缀
• 任务管理
  • 支持多组任务
  • 任务结束期限，期限后不执行此任务
  • 可单独指定子任务星期几执行
• 媒体库整合
  • 根据任务名搜索 Emby 媒体库
  • 追更或整理后自动刷新 Emby 媒体库
  • 插件模块化，允许自行开发和挂载插件⁠
• 数据同步
  • 本地目录间文件同步(支持WebDav/FTP等本地挂载之后使用)
  • 支持增量同步和覆盖同步两种模式
  • 支持文件名/去扩展名/MD5 多种匹配模式
  • 支持正则过滤和文件类型过滤
  • 支持定时调度执行
  • MD5 缓存加速，大文件快速指纹优化
• 其它
  • 每日签到领空间 ^?⁠
  • 支持多个通知推送渠道 ^?⁠
  • 支持多账号

⁠部署

⁠Docker 部署

Docker 部署提供 WebUI 进行管理配置，部署命令：

docker run -d \
  --name cloud-auto-save \
  -p 5005:5005 \ # 映射端口，:前的可以改，即部署后访问的端口，:后的不可改
  -e WEBUI_USERNAME=admin \
  -e WEBUI_PASSWORD=admin123 \
  -v ./cloud-auto-save/config:/app/config \ # 必须，配置持久化
  -v ./cloud-auto-save/media:/media \ # 可选，模块alist_strm_gen生成strm使用
  -v /mnt/cloud-drive:/app/datafiles/source \ # 可选，数据同步功能使用，映射网盘目录
  -v /mnt/local-storage:/app/datafiles/dest \ # 可选，数据同步功能使用，映射本地目录
  --network bridge \
  --restart unless-stopped \
  ozoo0/cloud-auto-save:latest
  # registry.cn-hangzhou.aliyuncs.com/ozoo0/cloud-auto-save:latest # 国内镜像地址

docker-compose.yml

name: cloud-auto-save
services:
  cloud-auto-save:
    image: ozoo0/cloud-auto-save:latest
    container_name: cloud-auto-save
    network_mode: bridge
    ports:
      - 5005:5005
    restart: unless-stopped
    environment:
      WEBUI_USERNAME: "admin"
      WEBUI_PASSWORD: "admin123"
    volumes:
      - ./cloud-auto-save/config:/app/config
      - ./cloud-auto-save/media:/media
      - /mnt/cloud-drive:/app/datafiles/source  # 可选，数据同步功能使用，网盘挂载点
      - /mnt/local-storage:/app/datafiles/dest  # 可选，数据同步功能使用，本地存储目录

管理地址：http://yourhost:5005⁠

数据同步目录映射说明：

如需使用数据同步功能，需要额外映射 datafiles 目录：

示例场景：

1. 网盘挂载同步到本地存储

   volumes:
     - ./config:/app/config
     - /mnt/cloud-drive:/app/datafiles/source  # 网盘挂载点
     - /mnt/local-storage:/app/datafiles/dest  # 本地存储目录
   

   Copy
   配置同步任务时：
   • 源目录：source
   • 目标目录：dest
2. 多目录同步

   volumes:
     - ./config:/app/config
     - ./datafiles:/app/datafiles  # 统一挂载父目录
   

   Copy
   在宿主机 ./datafiles/ 下创建子目录（如 src1, src2, dest），配置时填写相对路径即可。

⁠一键更新

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

⁠使用说明

⁠正则处理示例

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

⁠数据同步

支持本地目录间的文件同步功能，适用于网盘挂载目录与本地存储之间的数据同步。

同步模式：

匹配模式：

配置参数：

使用示例：

同步网盘挂载目录到本地存储：

• 源目录：test_src
• 目标目录：test_dest
• 同步模式：增量同步
• 匹配模式：文件名匹配
• 文件类型：视频

⁠刷新媒体库

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

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

⁠更多使用技巧

请参考 Wiki ：使用技巧集锦⁠

⁠生态项目

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

⁠官方项目

• QAS一键推送助手⁠

  油猴脚本，在夸克网盘分享页面添加推送到 QAS 的按钮

• SmartStrm⁠

  STRM 文件生成工具，用于转存后处理，媒体免下载入库播放。

⁠第三方开源项目

• nonebot-plugin-quark-autosave⁠

  QAS Telegram 机器人，快速管理自动转存任务

• Astrbot_plugin_quarksave⁠

  AstrBot 插件，调用 quark_auto_save 实现自动转存资源到夸克网盘

• Telegram 媒体资源管理机器人⁠

  一个功能丰富的 Telegram 机器人，专注于媒体资源管理、Emby 集成、自动下载和夸克网盘资源管理。

⁠版权

• 原项目：Copyright (C) Cp0204 - Cp0204/quark-auto-save⁠
• 本项目：Copyright (C) 2025-2026 OzoO0 - OzoO0/cloud-auto-save⁠

本项目基于 Cp0204/quark-auto-save:0.8.4⁠ 进行二次开发，包含大量功能扩展与代码重构，新增和修改部分的版权归 OzoO0 所有。

⁠声明

本项目基于个人兴趣开发并开源，仅供学习与交流使用，不包含任何破解行为，只是对夸克官方 API 的封装与调用，所有数据均来源于各大网盘官方，本人不对网盘内容及官方 API 变更所导致的任何后果负责。

⁠致谢

本项目基于 Cp0204/quark-auto-save:0.8.4⁠ 进行二次开发，感谢 Cp0204⁠ 的开源贡献。

⁠Sponsor

CDN acceleration and security protection for this project are sponsored by Tencent EdgeOne.