jiangrui1994 /CloudSaver

一个基于 Vue 3 + Express 的网盘资源搜索与转存工具。

★ 9,458⑂ 781👁 28⑃ 3● 128▤ 0
VueMITCreated 2024-12-17
+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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON