项目介绍
CloudSaver 提供网盘资源搜索、订阅和转存功能。下面介绍部署配置、初始注册、群晖目录准备和启动方法。搜索源访问与网盘转存授权需要分别检查,搜索到结果并不代表转存任务已经成功。
version: "3"
services:
cloudsaver:
image: jiangrui1994/cloudsaver:latest
container_name: cloud-saver
ports:
- "8008:8008"
volumes:
- /volume1/docker/cloudsaver/data:/app/data
- /volume1/docker/cloudsaver/config:/app/config
environment:
no_proxy: 172.17.0.1,127.0.0.1,localhost
https_proxy: http://192.168.0.118:20171
http_proxy: http://192.168.0.118:20171
restart: unless-stopped
资源搜索需要配置代理环境
默认注册码
管理员:230713
普通用户:9527
补充:部署与使用
配置与操作示例
Compose 与应用配置
建立 /volume1/docker/cloudsaver/data 和 config 两个目录。在 config/env 中写入:
JWT_SECRET=替换成自己生成的长随机值
TELEGRAM_BASE_URL=https://t.me/s
随机值可由 openssl rand -hex 32 生成。创建项目文件:
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/cloudsaver/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/cloudsaver /volume1/docker/cloudsaver/config /volume1/docker/cloudsaver/data
cd /volume1/docker/cloudsaver
HALO_PREPARE
cd /volume1/docker/cloudsaver
services:
cloudsaver:
image: jiangrui1994/cloudsaver:latest
ports:
- "8008:8008"
volumes:
- /volume1/docker/cloudsaver/data:/app/data
- /volume1/docker/cloudsaver/config:/app/config
restart: unless-stopped
访问 http://NAS_IP:8008,按对应镜像的文档完成账户初始化,再接入自己的网盘。项目已说明公开源码与较新容器镜像的功能不一定一致;排错时记录镜像摘要和应用版本,不能仅凭仓库旧源码推断镜像行为。
先完成「搜索一条合法分享 → 选择目标目录 → 转存 → 在网盘原生界面核对文件」的闭环,再添加订阅。任务成功后检查重复文件策略、剩余容量和失效分享处理。
启动与状态检查
在保存 compose.yaml 和所需 .env 的项目目录执行:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。
常见问题
- 搜索正常但转存失败:检查分享有效性、提取要求、账号状态与目标存储配额。
更新与备份
保存应用数据、来源与订阅配置,网盘授权另行管理;重要转存结果自行备份。
更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。