Skip to content

README.md

Latest commit

 

History

History
183 lines (132 loc) · 3.92 KB

README.md

File metadata and controls

183 lines (132 loc) · 3.92 KB

文件中转站 | File Transfer

基于 Cloudflare Workers + R2 的文件分享服务，支持大文件分片上传，最大支持 100GB。

community

功能特性

  • 大文件支持：最大支持 100GB 文件上传
  • 分片上传：大于 100MB 的文件自动使用分片上传，避免超时
  • 分享密码：可为文件设置访问密码
  • 过期自动清理：文件可设置过期时间，过期自动删除
  • 临时下载链接：下载链接 5 分钟有效，安全可靠
  • 二维码分享：一键生成分享二维码
  • 并发上传：支持多文件同时上传

部署

1. 创建 Cloudflare Workers

# 使用 wrangler CLI
wrangler login
wrangler init file-transfer

2. 创建 R2 Bucket

在 Cloudflare Dashboard 中创建一个 R2 Bucket，名称默认为 file-transfer（可在配置中修改）。

3. 绑定 R2 Bucket

在 wrangler.toml 中添加：

[[r2_buckets]]
binding = "file-transfer"
bucket_name = "file-transfer"

4. 部署

wrangler deploy

配置

编辑 worker.js 中的 CONFIG 对象：

const CONFIG = {
  // R2 Bucket 名称
  BUCKET_NAME: 'file-transfer',
  
  // 全局访问密码（留空则不启用）
  ACCESS_PASSWORD: '',
  
  // 文件分享密码密钥（用于生成临时下载签名）
  SHARE_SECRET_KEY: '',
  
  // 临时下载链接有效期（毫秒）默认5分钟
  TEMP_LINK_EXPIRE: 5 * 60 * 1000,
  
  // 文件大小限制（字节）默认 100GB
  MAX_FILE_SIZE: 100 * 1024 * 1024 * 1024,
  
  // 文件过期时间（毫秒）默认 7天，0 表示永不过期
  FILE_EXPIRE_TIME: 7 * 24 * 60 * 60 * 1000,
  
  // 允许的文件类型（留空数组表示允许所有）
  ALLOWED_TYPES: [],
  
  // 自定义域名（可选）
  CUSTOM_DOMAIN: '',
  
  // 最大并发上传数
  MAX_CONCURRENT_UPLOADS: 3,
  
  // 分片上传配置
  CHUNK_SIZE: 50 * 1024 * 1024,  // 分片大小 50MB
  MULTIPART_THRESHOLD: 100 * 1024 * 1024,  // 大于100MB启用分片
};

API 接口

获取上传链接

POST /api/upload-url
Content-Type: application/json

{
  "filename": "example.zip",
  "size": 104857600,
  "type": "application/zip",
  "password": "optional-share-password"
}

响应：

{
  "uploadUrl": "...",
  "fileId": "...",
  "downloadUrl": "...",
  "hasPassword": false,
  "useMultipart": true,
  "chunkSize": 52428800
}

上传文件（小文件）

PUT /api/upload/{fileId}
Content-Type: {file-type}

[binary data]

分片上传（大文件）

  1. 初始化分片上传
POST /api/multipart/create
Content-Type: application/json

{
  "fileId": "...",
  "totalChunks": 20
}
  1. 上传分片
POST /api/multipart/upload?fileId={fileId}&chunkIndex=0

[binary chunk data]
  1. 完成分片上传
POST /api/multipart/complete
Content-Type: application/json

{
  "fileId": "..."
}

下载文件

访问分享链接：/d/{fileId}

如果需要密码，会显示密码输入页面。验证通过后会自动跳转到临时下载链接。

技术说明

分片上传原理

  1. 前端将大文件切分为 50MB 的分片
  2. 逐个上传分片，失败自动重试（最多 3 次）
  3. 同时上传 2 个分片，控制并发
  4. 后端将分片保存在 R2 中
  5. 下载时按顺序流式读取所有分片

安全特性

  • 所有下载链接都是临时的（默认 5 分钟有效）
  • 支持设置文件访问密码
  • 支持设置全局访问密码
  • 文件可设置过期时间

注意事项

  1. Cloudflare Workers 免费版有每日 100,000 次请求限制
  2. R2 存储有容量和出站流量限制
  3. 分片上传时，Workers 内存限制为 128MB，因此单分片大小不能超过 50MB
  4. 大文件下载时，由于需要流式读取多个分片，首字节时间可能稍长

许可证

Apache License 2.0