FileBox
Zero cost and serverless file delivery web app based on CloudflareR2 or MongoDB or File0 or Supabase / 基于多种可选免费存储服务的零成本无服务器文件快递柜
GPL-3.0 License
FileBox
A serverless file delivery web app based on free Cloudflare R2 / MongoDB Atlas / File0 / Supabase databases, using Next.js, React, Ant Design, Tailwind CSS, etc.
基于 Cloudflare R2 / MongoDB Atlas / File0 / Supabase 的零成本无服务器文件快递柜, 采用 Next.js, React, Ant Design, Tailwind CSS 等技术栈.
 |
 |
 |
 |
|---|
Usage
使用方法
1 Install Dependencies
安装依赖
bun i
2 Local Development
本地开发
bun dev
3 Deploy
部署
3.1 Config Storage
You can use all the storage solutions while only one of them is required. And when using R2, you should deploy a separate server side project (not this Next.js project).
你可以同时使用所有存储解决方案, 但只需要其中一个. 当使用 R2 时, 你需要部署一个单独的服务端项目 (不是这个 Next.js 项目).
Above all, you should set FILEBOX_UPLOAD_PW, FILEBOX_DOWNLOAD_PW environment variables in .env file or Vercel no matter which storage solution you use.
不管使用哪种存储方案, 你都需要在 .env 文件或 Vercel 中设置 FILEBOX_UPLOAD_PW, FILEBOX_DOWNLOAD_PW 环境变量.
3.1.1 For Cloudflare R2
如果使用 Cloudflare R2
See this project.
见此项目.
3.1.2 For MongoDB
如果使用 MongoDB
Set MONGODB_URI environment variables in .env file or Vercel.
在 .env 文件或 Vercel 中设置 MONGODB_URI 环境变量.
3.1.3 For File0
如果使用 File0
Set F0_SECRET_KEY environment variable in .env file or Vercel.
在 .env 文件或 Vercel 中设置 F0_SECRET_KEY 环境变量.
3.1.4 For Supabase
如果使用 Supabase
Set SUPABASE_URL and SUPABASE_KEY environment variables in .env file or Vercel.
在 .env 文件或 Vercel 中设置 SUPABASE_URL 和 SUPABASE_KEY 环境变量.
Create a storage bucket named filebox and create a table named filebox in Supabase dashboard. The table should have the following columns: key (text), filename (text), created_at (timestamp), filetype (text).
在 Supabase 控制台中创建一个名为 filebox 的存储桶, 并创建一个名为 filebox 的表. 表应该有以下列: key (text), filename (text), created_at (timestamp), filetype (text).
3.2 Deploy to Vercel
部署到 Vercel
4 All Environment Variables
| Name | Description | Default | Required |
|---|---|---|---|
FILEBOX_UPLOAD_PW |
Upload Password | - | Yes |
FILEBOX_DOWNLOAD_PW |
Download Password | - | Yes |
MONGODB_URI |
MongoDB Connection URI | - | No |
F0_SECRET_KEY |
File0 Secret Key | - | No |
SUPABASE_URL |
Supabase URL | - | No |
SUPABASE_KEY |
Supabase SECRET api keyOr anon api key with additional permission |
- | No |
NEXT_PUBLIC_DEFAULT_SERVER |
Client Default R2 Server | - | No |
NEXT_PUBLIC_DEFAULT_UPLOAD_PW |
Client Default Upload Password | - | No |
NEXT_PUBLIC_DEFAULT_DOWNLOAD_PW |
Client Default Download Password | - | No |
NEXT_PUBLIC_DEFAULT_STORAGE |
Client Default Storage Serverr2 / mongodb / file0 / supabase
|
supabase |
No |
NEXT_PUBLIC_DEFAULT_UPLOAD_TYPE |
Client Default Upload Typefile / text
|
file |
No |
5 Frontend Config
| Name | Description |
|---|---|
上传密码 |
For authentication, should be the same as the FILEBOX_UPLOAD_PW environment variable in the server side |
下载密码 |
For authentication, should be the same as the FILEBOX_DOWNLOAD_PW environment variable in the server side |
存储服务器 |
Choose storage server |
R2 服务器地址 |
See 3.1.1, only appears when R2 is selected |
6 Realtime Progress Support
上传/下载实时进度支持情况
| Storage | Upload | Download |
|---|---|---|
R2 |
✅ (XHR's onUploadProgress Event) | ✅ (Fetch & Stream API) |
MongoDB |
✅ (Split File into Chunks & XHR's onUploadProgress Event) | ✅ (Fetch & Stream API) |
File0 |
❌ (SDK's Upload API) | ✅ (SDK's Download as Stream) |
Supabase |
✅ (XHR's onUploadProgress Event) | ✅ (Public Direct Download Link) |
R2andMongoDBhave different real-time upload progress implementations because vercel has a 4.5MB limit on the request body size while cloudflare workers is 100MB. As a result,MongoDB's upload speed is slower than other three storage solutions.
R2和MongoDB有不同的实时上传进度实现, 因为 vercel 对请求体大小有 4.5MB 的限制, 而 cloudflare workers 为 100MB. 因此,MongoDB的上传速度比其他三种存储方案慢.
7 File Storage Architecture
文件存储架构
| Storage | File | Metadata |
|---|---|---|
R2 |
Cloudflare R2 (ArrayBuffer) | Cloudflare R2 |
MongoDB |
file Collection (Base64) |
meta Collection |
File0 |
File0 (Blob) | File0 |
Supabase |
Supabase Storage (Blob) | Supabase Postgres |