CloudScribe 是一个部署在 Docker 中的云盘订阅与转存工具,用来把阿里云盘、夸克网盘分享资源持续同步到自己的云盘目录,并按需推送到 Aria2 下载。

它适合运行在 Docker、NAS、家庭服务器或 VPS 上。你可以接入多个云盘账号,管理目录与分享,创建订阅任务,配置季集识别、重命名和同集更新规则,让追更、转存、下载和记录归档集中在一个 Web 界面里完成。

• 支持阿里云盘、夸克网盘账号接入。
• 支持扫码接入和凭据接入。
• 显示账号可用状态、认证状态、容量占用和最近更新时间。
• 支持启用、停用、刷新和移除账号。
• 支持设置每个账号的默认保存目录。
• 支持浏览云盘目录、返回上级、刷新、搜索当前目录和新建文件夹。
• 支持单个文件删除、批量删除,并对夸克删除后的同步延迟给出状态提示。
• 支持从云盘文件直接创建分享,支持公开分享、提取码分享和有效期设置。
• 支持分享记录管理、复制分享信息、单个取消和批量取消分享。

• 支持阿里云盘、夸克网盘分享链接预览和资源选择。
• 支持在文件管理中把分享资源快速转存到当前目录。
• 支持订阅分享链接,配置提取码、保存账号、保存目录和目标子目录。
• 支持手动执行单个订阅、立即执行全部已启用订阅。
• 支持定时检查已启用订阅,可按间隔、每天或每周设置,默认关闭。
• 支持启用、停用、编辑、删除订阅。
• 支持重置订阅历史,重新识别已保存内容。
• 支持订阅执行前预览保存效果。
• 支持在预览中直接调整文件筛选、季集范围、未识别季处理、重命名、同集更新和 Aria2 设置。
• 支持按包含关键词、排除关键词过滤资源。
• 支持按季集范围保存:全部保存、从指定季集开始、从指定集数开始、只保存指定季。
• 支持未识别季的自动推断、指定季数或不补充处理。

• 支持季集识别规则,用于从文件名中识别季数和集数。
• 支持重命名规则,用模板生成转存后的文件名。
• 支持同集更新规则,当同一集出现多个版本时按优先级选择更合适的文件。
• 同集更新规则支持按文件名关键词、文件大小范围、扩展名匹配。
• 支持新增、编辑、删除自定义规则。
• 支持启用、停用和排序同集更新规则。
• 内置多套常用命名规则,如剧名季集、中文集数、季集编号前置等。
• 内置规则不可误删,适合不熟悉正则或模板时直接使用默认配置。

• 支持配置 Aria2 RPC 地址、密钥、默认下载目录和启用状态,并可测试连接。
• 支持手动提交 URL 到 Aria2,支持多行或逗号分隔。
• 支持从云盘目录选择文件推送下载。
• 文件夹下载会自动展开并保留文件夹层级。
• 订阅转存后可按任务配置自动推送到 Aria2。
• 支持查看 Aria2 下载概览和任务列表。
• 支持下载队列分批推送,减少一次性提交过多任务。
• 支持按状态和关键词筛选下载任务。
• 支持分页、单个删除、批量删除、批量暂停和批量继续。

• 执行记录按时间倒序展示,支持来源、执行方式、结果和关键词筛选。
• 支持删除单条执行记录和清空执行记录。
• 系统日志支持分页、级别筛选、分类筛选、刷新、删除单条和清空。
• 应用管理页显示当前版本、构建号、发布日期和运行状态。
• 支持应用内版本更新,默认读取 GitHub 更新清单,展示版本说明并可一键更新容器,失败时显示原因。
• 更新期间进入维护状态,等待服务恢复后自动刷新。
• 支持修改 Web 登录用户名和密码。
• /health 接口返回健康状态、版本、构建号和适配器版本。

docker run -d \
 --name cloudscribe \
 --restart unless-stopped \
 -p 8008:8008 \
 -v ./data:/data \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -e APP_SECRET_KEY=change-this-secret \
 -e APP_DATA_DIR=/data \
 -e APP_UPDATE_CHECK_URL=https://raw.githubusercontent.com/joevess/cloudscribe/main/update.json \
 -e APP_SELF_UPDATE_ENABLED=true \
 -e APP_SELF_UPDATE_CONTAINER_NAME=cloudscribe \
 -e APP_SELF_UPDATE_WATCHTOWER_IMAGE=containrrr/watchtower:latest \
 -e TZ=Asia/Shanghai \
 joevess9/cloudscribe:latest

启动后访问:

http://服务器IP:8008

默认登录信息:

• 账号:admin
• 密码:password

首次登录后建议立即在"应用管理"中修改密码。

services:
 cloudscribe:
 image: joevess9/cloudscribe:latest
 container_name: cloudscribe
 ports:
 - "8008:8008"
 environment:
 APP_SECRET_KEY: change-this-secret
 APP_DATA_DIR: /data
 APP_UPDATE_CHECK_URL: https://raw.githubusercontent.com/joevess/cloudscribe/main/update.json
 APP_SELF_UPDATE_ENABLED: "true"
 APP_SELF_UPDATE_CONTAINER_NAME: cloudscribe
 APP_SELF_UPDATE_WATCHTOWER_IMAGE: containrrr/watchtower:latest
 TZ: Asia/Shanghai
 volumes:
 - ./data:/data
 - /var/run/docker.sock:/var/run/docker.sock
 restart: unless-stopped

启动:

docker compose up -d

应用运行数据统一保存到容器内 /data,包括:

• SQLite 数据库
• 云盘账号配置和认证信息
• 订阅配置和订阅历史
• 规则配置
• 分享记录
• 下载推送记录
• 执行记录
• 系统日志
• 应用账号配置

请务必挂载持久化目录:

./data:/data

发布镜像不包含本地测试数据、云盘账号、订阅记录、日志或数据库文件。

docker compose pull
docker compose up -d

应用内版本更新默认读取本仓库的 update.json。

应用管理页的"版本更新"会自动检查新版本,展示发布日期、镜像和更新说明。发现新版本后点击"立即更新",CloudScribe 会启动一次性 Watchtower 任务,拉取 joevess9/cloudscribe:latest 并重建当前容器。

默认 Compose 配置已经包含应用内更新所需的环境变量和 Docker Socket 挂载:

environment:
 APP_SELF_UPDATE_ENABLED: "true"
 APP_SELF_UPDATE_CONTAINER_NAME: cloudscribe
 APP_SELF_UPDATE_WATCHTOWER_IMAGE: containrrr/watchtower:latest
volumes:
 - ./data:/data
 - /var/run/docker.sock:/var/run/docker.sock

更新过程中页面会进入全屏更新状态,避免继续操作其它功能;服务恢复后页面会自动刷新。

建议正式部署使用 latest 标签。如果固定使用 0.9.x 版本标签,Watchtower 只会检查同一个标签,无法切换到新版本号。

/var/run/docker.sock 代表宿主机 Docker 管理能力,请只在可信的自用环境中部署。

健康检查:

wget -qO- http://127.0.0.1:8008/health

• Docker Hub: https://hub.docker.com/r/joevess9/cloudscribe
• GitHub: https://github.com/joevess/cloudscribe
• 镜像: joevess9/cloudscribe:latest

当前版本:

• 0.9.96
• 更新说明:优化应用内更新稳定性;更新失败时显示明确原因;固定版本镜像会提示手动更新。
• Digest: sha256:03185942428e0839a72227b3a5e46cc40e0d1740c7e18281a6dfb469c4fbe508

云盘 Web 接口不是稳定的公开契约。登录、转存、分享、直链获取等能力可能受到账号状态、Cookie 或 token 失效、平台策略调整、风控和频率限制影响。

建议使用较低频率执行订阅检查,避免短时间大量请求。