CloudPaste

CloudPaste 是一个开源的 Serverless 工具，集文件管理、多源存储聚合、30+ 文件格式在线预览与 Markdown 协作分享于一体。它无需独立服务器，全部运行在 Cloudflare 生态之上，兼顾隐私、性能与易用性，适合个人、开发者和小团队部署使用。

为什么选择 CloudPaste？

它解决了几个常见痛点：

• 管理多个网盘太麻烦？ → 支持 R2、B2、OSS、OneDrive、Google Drive、GitHub、Telegram 等十余种存储源，统一界面操作。
• 想在线预览文件但格式不支持？ → 内置图片、视频、PDF、Office、EPUB、代码等 30+ 格式直接预览，其余通过 KKFileView 嵌入支持。
• 需要安全分享文档或配置文件？ → 提供密码、过期时间、访问次数限制，还支持类似 GitHub Raw 的直链。
• 希望挂载为本地磁盘？ → 完整支持 WebDAV 协议，兼容任何标准客户端（如 Windows 资源管理器、RaiDrive、Cyberduck）。
• 不想维护服务器？ → 基于 Cloudflare Workers + D1 + R2，真正零运维，按请求计费，全球 300+ 节点就近响应。

核心能力一览

Serverless 架构，原生 Cloudflare 集成

• 后端逻辑运行在 Cloudflare Workers，数据库使用 D1，文件可存于 R2 或任意 S3 兼容服务。
• 支持一体化部署（前后端打包进单个 Worker）或前后端分离，适配不同场景。
• 自动扩缩容，无服务器运维负担。

多存储聚合，自由切换

• S3 兼容：R2、Backblaze B2、AWS S3、阿里云 OSS、腾讯云 COS、MinIO。
• 网盘与 API 集成：OneDrive、Google Drive、WebDAV、Telegram Bot、Discord、Hugging Face Database、GitHub Releases（只读）。
• 本地部署选项：通过 Docker 挂载本地文件系统，适合自托管用户。
• 智能上传机制：前端预签名直传 + 流式分片上传 + 断点续传，有效绕过 Cloudflare 的请求体限制，上传进度实时反馈。

强大的 Markdown 编辑与分享

• 基于 Vditor，支持 GitHub 风格 Markdown、LaTeX 数学公式、Mermaid 流程图、思维导图。
• 实时双向预览，所见即所得。
• 一键导出为 PDF、HTML、PNG 或 Word 文档。
• 分享链接可设置：密码保护、有效期、最大访问次数。
• 提供 Raw 直链，适合托管配置文件、脚本或静态资源。

WebDAV 协议支持

• 标准 WebDAV 实现，可被任意客户端挂载为网络驱动器。
• 支持创建目录、上传、删除、重命名、移动等完整操作。
• 可配置缓存 TTL，减少对上游存储的重复请求。
• 通过 API 密钥进行权限控制，保障安全性。

灵活的权限与认证

• 支持创建多个 API 密钥，可限定为只读/读写，并绑定到特定存储路径。
• 密钥可设置有效期，支持手动撤销。
• 管理后台使用 JWT 认证，保障管理员操作安全。
• 支持 PWA，可安装为桌面应用，部分功能支持离线使用。

多种部署方式

• GitHub Actions 自动部署：推送代码即自动上线。
• Wrangler CLI 手动部署：适合调试与定制。
• Docker Compose 一键启动：适合本地测试或私有部署。
• 支持部署到 Cloudflare、Vercel、ClawCloud、Hugging Face Spaces 等平台。

快速开始（以 Cloudflare 为例）

前置准备：

• 一个 Cloudflare 账号
• 若使用 R2，需创建存储桶（绑定支付方式）
• 若使用其他 S3 服务，准备好：

  S3_ACCESS_KEY_ID
  S3_SECRET_ACCESS_KEY
  S3_BUCKET_NAME
  S3_ENDPOINT
  

部署流程：

1. Fork 项目仓库
2. 配置环境变量（.env 或 Cloudflare 控制台）
3. 通过 GitHub Actions 或 wrangler deploy 一键部署

⚠️ 注意：部分存储服务（如 OneDrive、Google Drive）需自行配置 OAuth 应用。详细步骤请参考官方 CloudPaste 部署文档