+0
日增长
9,458
stars
781
forks
28
watchers
3
prs
128
issues
0
releases
README
CloudSaver
一个可自行部署的网盘资源搜索与转存工具
整合资源搜索、链接解析与网盘转存,提供适配桌面和移动设备的 Web 界面。
快速部署 ·
功能特性 ·
📖 使用文档 ·
更新日志 ·
交流反馈
[!TIP]
📖 查看 CloudSaver 使用文档 →
包含 部署教程、使用说明、常见问题及更多搜索频道,建议首次使用前阅读。
🔑 文档访问密码:me16(如语雀提示输入访问密码,请填写此密码)。
[!IMPORTANT]
版本说明:本仓库公开的源码版本为 v0.2.5,较新版本的功能并未同步到这里。希望使用较新版本的用户,请优先选择下方提供的 Docker 镜像。Docker 镜像与本仓库源码不一定一一对应;不同版本的功能、配置方式请以对应版本文档为准。
[!CAUTION]
请自行部署,不要在陌生网站填写网盘 Cookie。 CloudSaver 项目方不提供官方在线 Demo 或托管服务。网盘 Cookie 等凭据可能赋予第三方访问账号及文件的能力,请仅在自己信任的环境中使用,并妥善保护配置及数据。
功能特性
| 能力 | 说明 |
| --- | --- |
| 多源资源搜索 | 聚合订阅源,支持关键词搜索、分享链接解析及豆瓣热门榜单展示 |
| 网盘快捷转存 | 支持 115 网盘、夸克网盘、天翼网盘、123 云盘等平台的转存操作,以及目标文件夹选择 |
| 多用户管理 | 提供注册、登录及管理员与普通用户的权限区分 |
| 多端适配 | 基于响应式 Web 界面,在 PC 与移动设备上使用 |
上述能力来自项目现有介绍;不同源码版本和 Docker 镜像版本支持的功能可能存在差异。
界面预览
说明:以下截图仅供参考,可能与当前版本存在差异,实际界面请以最新发布版本为准。
PC 端 · 资源搜索 / 转存
查看更多界面截图(PC / 移动端)
PC 端
移动端
快速部署
推荐使用 Docker Compose 部署。无需在宿主机安装 Node.js,也方便维护数据与配置目录。
1. 创建配置目录
bash
mkdir -p cloudsaver/{data,config}
cd cloudsaver
创建 config/env 文件,并将 JWT_SECRET 修改为自己生成的、足够长的随机字符串:
dotenv
JWT_SECRET=replace_with_your_own_long_random_secret
TELEGRAM_BASE_URL=https://t.me/s
请勿直接使用示例密钥。较新镜像所需的配置项可能发生变化,遇到差异时请参阅部署与常见问题文档。
2. 创建 Compose 文件
在当前目录新建 compose.yaml:
yaml
services:
cloudsaver:
image: jiangrui1994/cloudsaver:latest
container_name: cloudsaver
ports:
- "8008:8008"
volumes:
- ./data:/app/data
- ./config:/app/config
restart: unless-stopped
3. 启动服务
bash
docker compose up -d
启动后,访问 http://localhost:8008;如果部署在局域网服务器上,请将 localhost 替换为对应设备的 IP 地址。
查看服务日志:
bash
docker compose logs -f cloudsaver
升级镜像(升级前建议备份 data 和 config 目录):
bash
docker compose pull
docker compose up -d
其他部署选择
| 镜像来源 | 稳定版 | 测试版 |
| --- | --- | --- |
| Docker Hub | jiangrui1994/cloudsaver:latest | jiangrui1994/cloudsaver:test |
| GitHub Container Registry | ghcr.io/jiangrui1994/cloudsaver:latest | ghcr.io/jiangrui1994/cloudsaver:test |
- 稳定版 latest:适合日常使用。
- 测试版 test:用于体验新功能与修复,可能存在不稳定情况;将 Compose 中的 image 替换成对应标签即可。
- 镜像来源切换:只需替换 image 地址,不需要同时运行两份服务。
使用 docker run 部署
在预先创建好 data、config 目录以及 config/env 文件后执行:
bash
docker run -d \
--name cloudsaver \
-p 8008:8008 \
-v "$(pwd)/data:/app/data" \
-v "$(pwd)/config:/app/config" \
--restart unless-stopped \
jiangrui1994/cloudsaver:latest
首次使用与配置
注册码
本仓库 v0.2.5 源码定义的初始注册码如下:
| 用户类型 | 初始注册码 |
| --- | --- |
| 管理员 | 230713 |
| 普通用户 | 9527 |
安全建议:初次部署后,请尽快在管理设置中修改默认注册码,并设置强密码。不要未经访问控制就把管理界面直接暴露到公网。新版本的注册与管理方式请以对应版本的实际界面为准。
Telegram 资源搜索
资源搜索依赖频道 / 订阅源以及访问 Telegram 相关页面所需的网络条件。部分网络环境需要配置 HTTP 代理;可在项目的管理设置中检查代理地址、端口和启用状态。
使用 Docker 时,容器内的 127.0.0.1 指向容器自身,不是你的宿主机。若代理运行在宿主机上,请填写容器能够访问的主机地址,并确认代理允许来自容器的连接。
在 v0.2.5 源码中,backend/.env 还支持 TELE_CHANNELS 配置;原项目文档注明该配置在 v0.3.0 及之后版本无效。较新版本的频道配置方式请查看使用说明。
数据持久化
| 容器目录 | 用途 |
| --- | --- |
| /app/data | 保存应用持久化数据(包括 SQLite 数据库) |
| /app/config | 保存运行配置,例如 env 文件 |
请定期备份这两个目录,且不要公开其中的凭据、数据库Top issues
#45请问,我的openwrt是在主路由上的,我的代理地址应该填哪个呢8 comments · 2025-04-30#74可否通过哪个网址或者api获取当前部署的版本号?7 comments · 2025-09-06#41带用户认证信息的代理服务器地址怎么填写6 comments · 2025-04-24#38搜索文件报 "未搜索到相关资源"6 comments · 2025-04-20#57配置本地代理后还是无法访问4 comments · 2025-06-08#56代理服务器协议是socket的还是http4 comments · 2025-06-07#32夸克转存空文件夹的问题4 comments · 2025-04-15#95作者你好,请教下使用夸克自动转存插件的时候,如何直接关联aria2自动下载,字段应该怎么写3 comments · 2025-12-18