ozoo0/cloud-auto-save-x repository overview

Telegram 交流群：https://telegram.me/Oz0Casx⁠

⁠项目简介

网盘自动转存（Cloud Auto Save X 简称 CASX）是一个基于 FastAPI + Vue3 的 Web 应用，提供网盘自动转存功能，可以帮助你：

• 🔄 自动转存：定时或自动（根据节目状态和任务进度）运行，自动转存各种网盘分享链接中的文件
• 🔄 数据同步：支持 OpenList、网盘直连、NAS 本地目录等多种同步方式，适合多网盘与本地资料库统一管理
• 📝 智能规则：在为手动配置重命名规则并且配置TMDB配置时，支持自动识别-重命名
• 🧩 文件过滤：通过过滤规则排除不需要的文件或文件夹，支持高级过滤功能
• 📊 任务管理：支持多任务管理，支持全局统一设置及单任务独立设置，支持任务筛选、排序、暂停、停止、继续等操作
• 🔍 资源搜索：智能搜索网盘资源，自动识别链接可用性，自动定位到分享目录
• 🎬 影视发现：浏览豆瓣热门影视榜单，一键快速创建任务，智能填充配置
• 📅 追剧日历：追踪节目播出时间，了解转存进度，支持海报视图和日历视图
• ✅ 自动签到：每日自动签到领空间（支持：夸克网盘、天翼云盘、百度网盘）
• 🔔 通知推送：支持多个通知推送渠道，及时了解转存状态
• 🔌 插件系统：支持多种插件扩展功能，包括媒体库局部刷新、下载任务推送、strm 文件生成等
• 🔄 自动修复异常任务：自动识别并修复异常任务，如分享链接失效、账号被限流等
• 🔄 多网盘复制与秒传加速：支持网盘到网盘、网盘到本地、本地到网盘的复制，并自动为后续分发准备秒传数据
• 🔄 STRM 302直连与反代: 支持生成302直连STRM，支持飞牛影视反代，并可结合多账号自动负载与 CAS 数据实现更顺滑的直连体验

⁠核心功能

⁠网盘支持情况

⁠自动转存

• 分享链接自动识别资源存放文件夹
• 转存任务文件智能重命名（需配置TMDB API密钥）
• 智能搜索资源并自动填充（集成 CloudSaver、PanSou，支持有效性检查、失效过滤）
• 支持自动修复异常任务（如分享链接失效、账号被限流等）
• 支持自动解压压缩包（仅限夸克高级会员）
• 支持一次性转存任务

⁠数据同步

• 支持 OpenList、网盘直连、本地目录等多种同步端点
• 支持网盘与网盘、网盘与 NAS、本地资料库之间的数据同步
• 支持同步任务统一管理，便于查看进度、执行状态和异常信息
• 适合把常用网盘内容同步到本地媒体库，或在多个网盘之间建立副本

⁠网盘复制与秒传加速

• 支持本地到网盘、网盘到本地、网盘到网盘的文件复制
• 支持流式复制与下载复制两种方式，可按场景选择速度优先或空间优先
• 支持 115、天翼云盘、移动云盘等账号间更高效的同盘复制体验
• 复制完成后会自动准备可复用的秒传数据，方便后续把同一文件快速分发到其他网盘
• 即使文件先落到本地或临时目录，也能继续为后续上传准备可复用的数据

⁠CAS 数据任务

• 支持按账号扫描 302_path 下的视频文件，批量生成 CAS 数据
• 已生成的数据可直接服务于 302 反代、预览和多网盘分发场景
• 支持任务创建、暂停、停止、继续和查看明细进度
• 任务状态会持久保存，服务重启或中断后可继续处理未完成任务
• 适合首次接入 302 反代时做一次性预热，也适合后续按需补全

⁠多网盘 302 与智能反代

• 支持飞牛影视反代（其它系统会陆续适配）
• 当飞牛挂载本地资源时，自动识别内外网，如果网盘中同样存储对应资源，自动切换到网盘资源进行302直连
• 智能负载策略，根据网盘负载情况智能切换到不同网盘进行302直连（需要网盘中有资源）
• 支持同类型多账号自动负载，减少单账号压力，提升预览可用性
• 多网盘自动负载无需手动同步，配合 CAS 能力实现主网盘有资源、子网盘少操作甚至免操作即可实现302直连反代
• 配合 STRM 使用时，可进一步提升媒体库预览和播放体验

注：不建议将反代端口直接暴露给公网，可能存在安全风险。建议搭配Web反代服务使用。

⁠部署

⁠Docker 部署

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

docker run -d \
  --name cloud-auto-save-x \
  -p 5115:5115 \ # 映射端口，:前的可以改，即部署后访问的端口，:后的不可改
  -p 5225:5225 \ # 反代端口，:前的可以改，即部署后访问的端口，:后的不可改
  -v ./cloud-auto-save-x/data:/app/backend/data \ # 必须，配置持久化
  -v ./cloud-auto-save-x/media:/media \ # 可选，模块alist_strm_gen生成strm使用
  -v ./cloud-auto-save-x/strm:/strm \ # 可选，项目本身生成strm使用
  -v ./cloud-auto-save-x/nasfile:/app/backend/data/sync/nasfile \ # 可选，用于同步任务Local使用，可与网盘数据同步
  --network bridge \
  --restart unless-stopped \
  ozoo0/cloud-auto-save-x:latest
  # registry.cn-hangzhou.aliyuncs.com/ozoo0/cloud-auto-save-x:latest # 国内镜像地址

docker-compose.yml

name: cloud-auto-save-x
services:
  cloud-auto-save-x:
    image: ozoo0/cloud-auto-save-x:latest
    container_name: cloud-auto-save-x
    network_mode: bridge
    ports:
      - 5115:5115
      - 5225:5225
    restart: unless-stopped
    volumes:
      - ./cloud-auto-save-x/data:/app/backend/data
      - ./cloud-auto-save-x/media:/media
      - ./cloud-auto-save-x/strm:/strm
      - ./cloud-auto-save-x/nasfile:/app/backend/data/sync/nasfile

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

⁠使用 MySQL

项目默认使用 sqlite3。如果需要切换到 MySQL，有两种配置方式：

1. 直接配置完整连接串：

DB_DRIVER=mysql
DATABASE_URL=mysql+pymysql://root:[email protected]:3306/casx?charset=utf8mb4
APP_DATA_DIR=./data

1. 使用分项配置：

DB_DRIVER=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=casx
DB_USER=root
DB_PASSWORD=your_password
DB_CHARSET=utf8mb4
APP_DATA_DIR=./data

说明：

• DATABASE_URL 优先级最高，配置后会覆盖 DB_HOST/DB_PORT/DB_NAME/DB_USER/DB_PASSWORD
• APP_DATA_DIR 是项目运行数据目录，不是 MySQL 数据文件目录
• 首次切换到 MySQL 前请先手动创建数据库，例如 CREATE DATABASE casx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 配置完成后请执行数据库迁移，再启动服务

如果使用 docker-compose，可以这样写：

name: cloud-auto-save-x
services:
  cloud-auto-save-x:
    image: ozoo0/cloud-auto-save-x:latest
    container_name: cloud-auto-save-x
    network_mode: bridge
    ports:
      - 5115:5115
      - 5225:5225
    restart: unless-stopped
    environment:
      DB_DRIVER: mysql
      DB_HOST: 127.0.0.1
      DB_PORT: 3306
      DB_NAME: casx
      DB_USER: root
      DB_PASSWORD: your_password
      DB_CHARSET: utf8mb4
      APP_DATA_DIR: /app/backend/data
    volumes:
      - ./cloud-auto-save-x/data:/app/backend/data
      - ./cloud-auto-save-x/media:/media
      - ./cloud-auto-save-x/strm:/strm
      - ./cloud-auto-save-x/nasfile:/app/backend/data/sync/nasfile

如果是源码运行，请在 backend/.env 中写入上述配置，然后执行：

cd backend
alembic upgrade head

⁠使用说明

⁠正则处理示例

默认规则：在已配置TMDB后，留空则增加兜底智能匹配。

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

⁠刷新媒体库

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

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

⁠更多使用技巧

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

⁠声明

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

⁠致谢

本项目参考 Cp0204/quark-auto-save⁠ 思路进行整体重构，感谢 Cp0204⁠ 的开源贡献。

⁠❤️ 支持项目

如果觉得这个项目对你有帮助，你可以通过以下方式支持我：

1. ⭐ 给项目点个 Star，让更多的人看到
2. 📢 分享给更多有需要的朋友
3. ☕ 请作者喝杯冰阔乐~

⁠Sponsor

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

⁠Star History