快速开始

从零到线上运行，约 5 分钟。

前置条件

Node.js 18+
一个 Vercel 账号（免费）
（可选）GitHub 账号与 Vercel CLI

1. 获取代码

git clone https://github.com/tanle-mtr/filebox.git
cd filebox
npm install

2. 配置环境变量

复制示例文件并填入你自己的值：

cp .env.example .env.local

BLOB_READ_WRITE_TOKEN：Vercel Blob 读写令牌（创建 Store 后获得，见「部署」页）
ADMIN_PASSWORD：管理后台登录密码

3. 本地运行

npm run dev

打开 http://localhost:3000，即可上传文件并生成取件码。

4. 部署上线

详见部署到 Vercel。核心三步：

创建 Blob Store（vercel blob create-store）
配置环境变量（ADMIN_PASSWORD）
vercel --prod

上线后请务必设置 ADMIN_PASSWORD，否则管理后台不可用。

5. 验证

访问首页 → 上传文件 → 得到 6 位取件码
新开浏览器（无痕窗口）→ 输入取件码 → 下载文件
访问 /admin → 输入管理员密码 → 查看分享列表与设置