上传文件，获取永久直链，全球 CDN 加速分发。单文件部署，零依赖。
| 功能 | 说明 |
|---|---|
| 📤 多方式上传 | 点击选择、拖拽文件、粘贴截图 |
| 📏 实时进度 | 进度百分比 + 上传状态 |
| 🔗 永久直链 | 上传即生成，长期有效 |
| 🔗 短链生成 | 一键生成 /s/xxxxxx 格式短链接 |
| 📋 一键操作 | 复制链接 / 打开 / 下载 |
| 🔒 密码保护 | 通过环境变量 ADMIN_PASSWORD 设置访问密码，未设置则免密访问 |
| 📜 上传历史 | 服务器端保存最近 100 条记录，随时查看（需密码权限） |
| 🌍 全球 CDN | Cloudflare 边缘网络加速 |
支持的文件格式： 图片（jpg/png/gif/webp/svg）、视频（mp4/webm/mkv）、音频（mp3/flac/wav/ogg）、文档（txt/md/json/csv/pdf/m3u/m3u8）、压缩包（zip/7z/rar）等任意格式。
全程在 Cloudflare Dashboard 网页操作，无需安装任何工具。
左侧菜单 → R2 对象存储 → Create Bucket
名称：file-store（或自定义）
区域：选离你近的即可
Workers & Pages → Create Application → Create Worker
名称：file-host → Deploy → Edit Code
→ 删除默认代码 → 粘贴 worker.js 全部内容
→ Save and Deploy
部署成功后你会得到一个地址，类似：
https://file-host.你的用户名.workers.dev
Worker 页面 → Settings → Bindings → Add Binding
┌─────────────────────────────────────┐
│ Variable name: FILE_BUCKET │
│ Type: R2 Bucket │
│ Bucket: file-store (选择) │
│ Save │
└─────────────────────────────────────┘
然后回到 Code & Deploy → 再点 Save and Deploy
⚠️ 这一步必须做！ 不绑定的话上传会报「未配置存储后端」错误。
Worker 页面 → Settings → Variables → Add Variable
│ Type: Secret (推荐) 或 Text
│ Variable name: ADMIN_PASSWORD
│ Value: 你的密码（自行设置，记好）
│ Save
│ 然后回到 Code & Deploy → 再点 Save and Deploy
💡 不设置
ADMIN_PASSWORD则免密码访问，兼容旧版行为。 设置后，访问页面会弹出密码框，验证通过后将 token 存入浏览器本地，刷新不再弹窗。
| 访问地址 | 预期结果 |
|---|---|
你的域名/ |
上传页面（有密码则先弹窗）✅ |
你的域名/status |
返回 JSON：{"status":"ok","r2":true} ✅ |
看到以上正常就可以开始使用了。
所有接口均支持 CORS，可直接从浏览器调用。
| 接口 | 方法 | 参数 | 说明 | 返回 |
|---|---|---|---|---|
/ |
GET | - | 上传页面（密码保护） | HTML |
/status |
GET | - | 服务状态诊断 | JSON |
/verify |
POST | {password} |
验证密码，获取 token | {token} |
/me |
GET | Header: Authorization |
验证 token 是否有效 | {authenticated} |
/upload |
POST | multipart/form-data: file + Header: Authorization |
上传文件（需鉴权） | {key, url, name, size} |
/f/:key |
GET | - | 访问/预览文件 | 文件内容 |
/f/:key?download=1 |
GET | - | 强制下载文件 | 文件下载 |
/shorten?key=:key |
GET | 文件 key | 生成短链接 | {shortUrl, shortCode} |
/history |
GET | - | 获取上传历史（无需鉴权） | {history: [...]} |
/s/:code |
GET | - | 短链跳转 (302) | 重定向到原始链接 |
# 先获取 token
TOKEN=$(curl -s -X POST https://your-worker.workers.dev/verify \
-H "Content-Type: application/json" \
-d '{"password":"你的密码"}' | jq -r '.token')
# 带 token 上传文件
curl -F "file=@test.txt" \
-H "Authorization: $TOKEN" \
https://your-worker.workers.dev/upload
# 返回
{"success":true,"key":"l3abc123_test.txt","name":"test.txt","size":1234,"url":"https://.../f/l3abc123_test.txt"}本项目使用 Cloudflare R2 作为存储后端。
| 项目 | 免费额度 | 说明 |
|---|---|---|
| 存储空间 | 10 GB / 月 | 存储你上传的所有文件 |
| Class A 操作 | 1000 万次 / 月 | 写入（上传）操作 |
| Class B 操作 | 1000 万次 / 月 | 读取（访问）操作 |
| 流量费用 | 免费！不收流量费 | 这是 R2 最大优势 |
| Worker 请求 | 10 万次 / 天 | API 调用次数 |
💡 对于个人使用场景，这些额度完全够用。如果需要更大容量，R2 的付费价格也非常便宜。
| R2 对象 Key | 说明 |
|---|---|
xxxxxxxx_name.ext |
上传的文件（key 格式：时间戳_随机串.扩展名） |
__history__ |
上传历史记录（JSON 数组，最多 100 条） |
__sm__ |
短链映射表（JSON 对象） |
┌──────────┐ POST /upload ┌─────────────┐ PUT ┌─────┐
│ 浏览器 │ ─────────────────→ │ Cloudflare │ ──────────→ │ R2 │
│ (前端) │ ←───────────────── │ Worker │ │Bucket│
└──────────┘ {url, key} │ │ ←─────────┘
│ POST /verify │ │
├─────────────────────→│ │
│ {token} │ │
│←─────────────────────┤ │
│ │ │
│ GET /history │ │
├─────────────────────→│ │
│ {history: [...]} │ │
│←─────────────────────┤ │
│ └─────────────┘
│ GET /f/:key │
├─────────────────────────────→┤
│ 文件内容 │
│←────────────────────────────┤
│ │
│ GET /s/:code │
├─────────────────────────────→┤
│ 302 → /f/:key │
│←────────────────────────────┘
核心设计原则：
- 单个 Worker 文件包含全部逻辑（前端 + 后端 + API），无需构建步骤
- 所有数据存在 R2，Worker 只做路由转发，无状态
- 短链映射数据存储在 R2（
__sm__对象），不需要额外 KV 绑定 - 上传历史存储在 R2（
__history__对象），持久化保存，最多 100 条 - 前端交互使用原生 JavaScript，无任何框架依赖
- 密码验证通过 SHA-256 哈希 token 实现，token 存于浏览器 localStorage
Worker → Settings → Triggers → Custom Domains → Add Custom Domain
→ 输入你的域名（如 file.example.com）
→ 按 Cloudflare 提示配置 DNS CNAME 记录
如果你希望文件直接通过 R2 CDN 分发（绕过 Worker，速度更快）：
R2 → 你的 Bucket → Settings → Public Access → Allow Access
→ 复制公开域名（如 https://pub-xxxxx.r2.dev）
Worker → Settings → Variables → Edit variables
→ 添加环境变量：R2_PUBLIC_DOMAIN = https://pub-xxxxx.r2.dev
→ Save and Deploy
开启后文件 URL 会变成 R2 直链格式：
# 开启前（通过 Worker 中转）
https://file-host.xxx.workers.dev/f/l3abc123_image.png
# 开启后（R2 直接分发，更快）
https://pub-xxxxx.r2.dev/l3abc123_image.png
🔧 上传报错怎么办？
- 先访问
/status检查"r2": true - 如果是
false，说明没绑 R2 → 回去执行第3步 - 如果提示「未找到文件字段」，检查 FormData 的字段名是否为
file - 如果提示「未授权」，检查是否设置了
ADMIN_PASSWORD并正确传入 token
📏 文件大小限制？
- Worker 限制：请求体最大约 25MB（免费计划）
- R2 限制：单个对象最大 500MB
- 如果需要上传超过 25MB 的文件，需要升级 Worker 付费计划，或改用 R2 S3 API 直接上传
🔒 密码保护是怎么工作的？
- 设置
ADMIN_PASSWORD环境变量后，所有访问（页面、上传）都需要先通过密码验证 - 验证方式：前端弹窗输入密码 → 调
/verify接口 → 返回 SHA-256 哈希 token - token 存入浏览器
localStorage，刷新页面自动复用，无需重复输入 - 未设置
ADMIN_PASSWORD则完全免密码，兼容旧版 - token 验证接口：
/me（GET，带Authorization头）
📜 上传历史存在哪里？能保存多少条？
- 上传历史存储在 R2 的
__history__对象中（JSON 数组格式） - 每次上传成功后自动追加，最多保存 100 条，超出自动截断
- 历史记录字段：
{key, name, size, time} - 查看方式：页面 Header 右侧「📜 查看历史」按钮，随时可点
🗑️ 如何删除已上传的文件？
- 方式1：Cloudflare Dashboard → R2 → 你的 Bucket → 手动删除
- 方式2：可通过 R2 S3 API 使用 AWS CLI 批量管理
- 方式3（推荐）：在「上传历史」每条记录旁添加删除按钮（未来版本）
🔐 安全性？
- 开启
ADMIN_PASSWORD后，上传和访问页面均需密码，密码以 SHA-256 哈希 token 形式存于浏览器 - 历史记录接口（
/history）当前无鉴权（可按需自行添加checkAuth调用） - 文件只要知道 key 即可访问，无过期时间（除非手动删除）
- 短链映射同样只要知道 code 即可跳转
MIT License — 自由使用、修改、分发。