Flyimg · 瞬传・瞬用

基于 Cloudflare Workers + R2 + D1 实现的极简临时图床

自动过期 · 全球加速 · 无感上传 · 免费额度友好

项目介绍

Flyimg（瞬传）是一款前后端分离、无服务器、零成本的临时图片托管服务。

图片上传后会在设定时间自动清理，充分利用 Cloudflare 免费额度，适合个人日常贴图、论坛外链、临时分享等场景。

核心亮点

🚀 直连Worker上传：前端直接调用Worker API，架构简洁、故障点少、延迟更低
🗄️ D1数据库驱动：使用 Cloudflare D1 存储文件元数据，查询高效、清理精准
👤 用户标识系统：通过用户名标识用户，支持查看个人已上传的未过期文件
🛡️ 管理后台：基于 CRON_SECRET 鉴权，查看所有文件、删除文件、一键清理过期文件
🕒 自动过期清理：Cron 定时批量删除，支持自定义过期时间
🎨 明暗双主题：自动适配系统主题，支持手动切换
📱 全响应式：拖拽上传 / Ctrl+V 粘贴 / 点击上传三端友好
💰 完全免费：依赖 Cloudflare 免费层，日常使用几乎不产生费用

架构设计

┌─────────────┐                ┌─────────────┐
│   用户浏览器  │─────直连──────▶│   Worker    │
│  (前端页面)   │◀─────────────│  (API服务)  │
└─────────────┘                └──────┬──────┘
       │                              │
       │ (静态资源)                    │
       ▼                       ┌──────┴──────┐
┌──────────────┐               │             │
│Cloudflare Pages│          ┌────▼───┐   ┌────▼───┐
│  (前端托管)    │          │  R2存储  │   │  D1数据库 │
└──────────────┘          │ (图片文件)│   │ (文件元数据)│
                          └────────┘   └────────┘

前端：纯静态 HTML → 部署在 Cloudflare Pages，仅托管静态资源
API调用：前端直接调用 Worker API（地址通过 WORKER_URL Secret 配置，部署时自动注入 config.js）
后端：Cloudflare Worker → 提供 API 服务，CORS 允许跨域
存储：Cloudflare R2 → 公网直链输出，cacheControl 与 EXPIRE_HOURS 联动
数据库：Cloudflare D1 → 存储文件元数据，驱动查询与清理
清理：Cron 定时触发 → 每小时基于 D1 查询批量删除过期文件

🚀 一键部署指南

只需 5 个 Secrets，Fork 后自动部署，无需本地安装任何工具。

第一步：Fork 仓库

点击本页面右上角的 Fork 按钮
在弹出的页面中直接点击 Create fork
Fork 完成后，你将拥有一个属于自己的仓库副本

第二步：创建 Cloudflare 资源

2.1 注册 Cloudflare 账号

如果你还没有 Cloudflare 账号，请前往 https://dash.cloudflare.com/sign-up 注册（免费）。

2.2 创建 R2 存储桶并开启公共访问

登录 Cloudflare Dashboard
左侧菜单点击 R2 对象存储
点击 创建存储桶，名称填写 flyimg，点击创建
进入刚创建的存储桶 → 设置标签页
找到 公共访问 部分，点击 允许访问
选择 R2.dev 子域名 方式，点击激活
复制显示的公网地址（格式如 https://pub-xxxx.r2.dev），保存好，后面要用

⚠️ 如果提示需要验证域名，请按页面指引完成验证。

2.3 获取 Account ID

登录 Cloudflare Dashboard
点击任意一个域名进入详情页（如果没有域名，点击左侧 Workers 和 Pages 也能看到）
右侧栏 API 区域可以找到 Account ID，复制保存

也可以直接在 URL 中找到：https://dash.cloudflare.com/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 其中那串就是 Account ID。

2.4 创建 API Token

前往 https://dash.cloudflare.com/profile/api-tokens
点击 创建令牌
选择 自定义令牌 → 开始使用
配置如下：
- 令牌名称：flyimg-deploy（随便取）
- 权限：依次添加以下 5 项
  - Account / Workers Scripts / 编辑
  - Account / D1 / 编辑
  - Account / Workers R2 存储 / 编辑
  - Account / Cloudflare Pages / 编辑
  - Account / 账户设置 / 读取
- 账户资源：选择 所有账户 或指定账户
- 区域资源：所有区域
点击 继续显示摘要 → 创建令牌
立即复制生成的令牌值（只显示一次！）

2.5 部署 Worker 并获取 Worker URL

在 Cloudflare Dashboard 左侧点击 Workers 和 Pages
点击创建 → 选择 Hello World 模板
名称填 flyimg-worker，点击部署
部署完成后，在 Worker 详情页可以看到访问地址，格式如 https://flyimg-worker.你的子域名.workers.dev
复制这个地址，保存好，后面要用

💡 如果你已有自定义域名并想绑定到 Worker，也可以填写自定义域名地址（如 https://img.example.com），前提是域名已托管在 Cloudflare 并已配置 DNS 指向该 Worker。

2.6 生成 CRON_SECRET

这是一个你自己设定的随机字符串，用于管理员鉴权和定时任务验证。可以用以下方式生成：

在浏览器控制台输入 crypto.randomUUID() 回车，复制结果
或使用任意密码生成器生成一个 32 位以上的随机字符串
或随便打一串字母数字组合，如 my-s3cr3t-k3y-2024-flyimg

第三步：配置 GitHub Secrets

进入你 Fork 的仓库页面
点击 Settings（设置）
左侧菜单找到 Secrets and variables → Actions
点击 New repository secret，依次添加以下 5 个必填密钥：

Secret 名称	填写内容	获取方式
`CLOUDFLARE_API_TOKEN`	第 2.4 步创建的 API Token	Cloudflare → Profile → API Tokens
`CLOUDFLARE_ACCOUNT_ID`	第 2.3 步获取的 Account ID	Cloudflare Dashboard URL 或 API 页面
`R2_PUBLIC_DOMAIN`	第 2.2 步获取的 R2 公网地址	Cloudflare → R2 → flyimg 存储桶 → 设置 → 公共访问
`CRON_SECRET`	第 2.6 步生成的随机字符串	自己生成
`WORKER_URL`	第 2.5 步获取的 Worker 访问地址	Cloudflare → Workers → flyimg-worker → 详情页

💡 WORKER_URL 可以是 workers.dev 地址，也可以是自定义域名地址（如 https://img.example.com），前端将直接调用此地址。

可选配置型 Secrets（不设置则使用默认值）：

Secret 名称	默认值	说明
`EXPIRE_HOURS`	`12`	图片过期时间（小时），同时决定 R2 cacheControl 的 max-age 值
`MAX_FILE_SIZE`	`20`	单文件大小限制（MB）
`MAX_STORAGE_SIZE`	`1000`	总存储上限（MB）
`ALLOWED_TYPES`	`image/jpeg,image/png,...`	允许的 MIME 类型，逗号分隔
`CORS_ALLOWED_ORIGINS`	`*`（允许所有）	允许的跨域来源，逗号分隔

第四步：触发部署

配置好 Secrets 后，部署会自动触发。你也可以手动触发：

自动触发：向 main 分支推送任何代码变更

手动触发：

进入仓库 → Actions 标签页
左侧选择 Deploy to Cloudflare
点击右侧 Run workflow → Run workflow

第五步：查看部署状态

进入仓库 → Actions 标签页
点击最新的 workflow 运行记录
查看每个步骤的执行状态（✅ 成功 / ❌ 失败）
部署成功后，在运行记录底部的 Summary 区域可以看到所有访问地址

第六步：开始使用

部署成功后：

前端页面：Actions Summary 中显示的 Pages 地址
管理后台：在前端页面点击"管理"按钮，输入你设置的 CRON_SECRET
快捷管理入口：https://前端地址/?token=你的CRON_SECRET

可选配置：限流防护

建议在 Cloudflare Dashboard 中配置 Rate Limiting 防止滥用：

进入 Cloudflare Dashboard → WAF → Rate limiting rules
点击 Create rule
配置：
- Rule name：flyimg-upload-limit
- Field：URI Path
- Operator：equals
- Value：/upload
- Rate：10 requests per 1 minute
- Action：Block
点击 Deploy

部署问题排查

❌ 部署失败：Missing required GitHub Secrets

原因：未配置全部 5 个必需的 GitHub Secrets。

解决：按照上方"第三步"补全所有 Secrets，然后重新触发部署。

❌ 部署失败：Failed to create D1 database

原因：API Token 权限不足或 D1 服务未开通。

解决：

确认 API Token 包含 D1 编辑 权限
在 Cloudflare Dashboard 中手动进入 D1 页面确认服务已开通
手动创建数据库：在 Dashboard → D1 → 创建数据库，名称填 flyimg-db

❌ 前端页面打开但上传失败

可能原因：

WORKER_URL 填写错误 → 确认格式为 https://xxx.workers.dev 或自定义域名
Worker 未正确部署 → 在 Dashboard 检查 Worker 是否存在
R2 公共访问未开启 → 在 R2 存储桶设置中开启

❌ 管理后台提示"未授权"

原因：输入的 CRON_SECRET 与 GitHub Secret 中配置的不一致。

解决：确认使用的是你配置在 GitHub Secrets 中的 CRON_SECRET 值。

❌ 图片上传成功但无法访问

原因：R2 公共访问未正确配置。

解决：

进入 R2 存储桶 → 设置 → 公共访问
确认已激活 R2.dev 子域名访问
检查 R2_PUBLIC_DOMAIN 是否以 https:// 开头

功能详情

上传功能

支持 JPG、PNG、GIF、WebP、SVG 格式
单文件最大 20MB（可配置）
可选填用户名，未填写则归类为默认用户
上传后生成直链、Markdown、HTML 三种格式

用户文件查看

访问 https://前端地址/[用户名] 查看个人文件
仅显示未过期文件，用户仅有查看权限
支持复制文件链接

管理后台

通过 URL 参数 ?token=CRON_SECRET 进入管理页面
查看所有文件（含已过期但尚未清理的，红色标识）
删除任意文件
一键清理过期文件
统计总文件数、已过期数、有效文件数

权限体系

角色	访问方式	权限
普通用户	免登录	上传文件、通过用户名查看自己的未过期文件
管理员	URL token 参数	查看所有文件（含过期）、删除文件、清理过期文件

API 文档

上传图片

POST /upload
Content-Type: multipart/form-data

参数：
  file     - 图片文件（必需）
  user_tag - 用户名（可选，默认 default）

响应：
{
  "success": true,
  "url": "https://r2-domain/filename.jpg",
  "markdown": "![图片](url)",
  "html": "<img src=\"url\" alt=\"flyimg\">",
  "expireAt": "2025-01-01T12:00:00.000Z",
  "expireHours": 12
}

查询用户文件

GET /my-images?user_tag=xxx

响应：
{
  "success": true,
  "images": [...]
}

查询所有文件（管理员）

GET /all-images
Header: X-Cron-Secret: <CRON_SECRET>

响应：
{
  "success": true,
  "images": [...]
}

删除文件（管理员）

POST /delete
Header: X-Cron-Secret: <CRON_SECRET>
Content-Type: application/json

Body: { "filename": "abc123.jpg" }

响应：
{ "success": true, "message": "文件已删除" }

清理过期文件（管理员）

POST /clean
Header: X-Cron-Secret: <CRON_SECRET>

响应：
{ "success": true, "message": "清理完成，删除了N张过期图片" }

存储统计

GET /stats

响应：
{
  "success": true,
  "totalFiles": 42,
  "totalSize": 10485760,
  "formattedSize": "10 MB",
  "usagePercent": 1,
  "isFull": false
}

配置说明

Worker 环境变量

所有配置项均可通过 GitHub Secrets 设置，未设置时使用默认值：

变量名	默认值	说明
`EXPIRE_HOURS`	`12`	图片过期时间（小时），同时决定 R2 cacheControl 的 max-age 值
`MAX_FILE_SIZE`	`20`	单文件大小限制（MB）
`MAX_STORAGE_SIZE`	`1000`	总存储上限（MB）
`ALLOWED_TYPES`	`image/jpeg,image/png,image/gif,image/webp,image/svg+xml`	允许的 MIME 类型，逗号分隔
`CORS_ALLOWED_ORIGINS`	`*`	允许的跨域来源，逗号分隔

设置方式：在 GitHub 仓库的 Settings → Secrets 中添加对应名称的 Secret，部署时自动生效。

cacheControl 联动机制

R2 上传文件的 cacheControl 值根据 EXPIRE_HOURS 自动计算：

max-age = EXPIRE_HOURS × 3600

EXPIRE_HOURS	cacheControl
4	`public, max-age=14400`
12	`public, max-age=43200`
24	`public, max-age=86400`

R2 文件元数据

上传文件时自动添加以下 R2 自定义元数据：

键	值	说明
`userTag`	用户名	上传该文件的用户标识

数据库结构

images 表

字段	类型	说明
`id`	INTEGER PRIMARY KEY AUTOINCREMENT	自增主键
`filename`	TEXT NOT NULL	文件名（时间戳随机名.扩展名）
`url`	TEXT NOT NULL	R2 公网直链
`size`	INTEGER NOT NULL	文件大小（字节）
`user_tag`	TEXT NOT NULL DEFAULT 'default'	用户名
`expire_at`	TEXT NOT NULL	过期时间（ISO 8601）
`created_at`	TEXT NOT NULL	创建时间（ISO 8601）

索引

索引名	字段	用途
`idx_images_user_tag`	`user_tag`	用户文件查询
`idx_images_expire_at`	`expire_at`	过期文件清理
`idx_images_filename`	`filename`	文件名查询

免费额度说明（Cloudflare）

服务	免费额度	本项目用量
Workers	100,000 请求/天	仅 API 请求
R2	10GB 存储 + 出口免费	图片直链不走 Worker
D1	5GB 存储 + 5M 读/天	元数据查询

日常使用几乎永远用不完免费额度。

工作机制

上传：前端直接调用 Worker API → Worker 校验 → 存入 R2 + D1
访问：直接返回 R2 公网直链，cacheControl 与 EXPIRE_HOURS 联动
查询：通过 D1 数据库按 user_tag 查询，仅返回未过期记录
清理：Cron 每小时查询 D1 中过期记录 → 删除 R2 文件 + D1 记录
管理：X-Cron-Secret 鉴权 → 查看全部/删除/清理

常见问题

1. 图片过期后多久删除？

最多延迟 1 小时（由 Cron 决定），不影响使用。

2. 可以自定义过期时间吗？

可以，设置 GitHub Secret EXPIRE_HOURS 即可。

3. 如何限制文件大小？

设置 GitHub Secret MAX_FILE_SIZE，单位 MB。

4. 图片直链是 R2 还是 Worker？

是 R2 公网直链，不经过 Worker，速度更快更省资源。

5. 相同文件被不同用户上传会怎样？

每个用户上传都会生成独立的文件记录和 R2 对象。

6. 如何进入管理后台？

在前端页面点击"管理"按钮，输入你设置的 CRON_SECRET 即可进入管理后台。也可以通过 URL 参数 ?token=你的CRON_SECRET 直接进入。

7. 如何配置限流？

使用 Cloudflare 原生 Rate Limiting 功能，在 Dashboard 的 WAF 中配置规则，详见上方"可选配置：限流防护"。

8. 部署后如何更新代码？

从上游仓库同步代码即可：在你的 Fork 仓库页面点击 Sync fork → Update branch，推送后自动触发部署。

9. 如何重新部署？

进入仓库 → Actions → Deploy to Cloudflare → Run workflow。

10. WORKER_URL 可以用自定义域名吗？

可以。只要域名已托管在 Cloudflare 并正确指向 Worker，填写 https://img.example.com 这样的地址即可。

项目结构

flyimg/
├── frontend/                # 前端静态资源
│   ├── index.html           # 主页面（上传+用户文件+管理后台）
│   ├── config.js            # 前端配置（Worker地址、显示参数，部署时自动生成）
│   ├── favicon.png          # 网站图标
│   └── _redirects           # Pages 路由规则（SPA支持）
├── worker.js                # Worker 后端 API
├── migrations/              # D1 数据库迁移
│   └── 0001_init.sql        # 初始化表结构
├── wrangler.toml            # Worker 配置
├── .github/
│   └── workflows/
│       └── deploy.yml       # GitHub Actions 自动部署
└── README.md

二次开发

本地开发

安装 Node.js 20+
安装 Wrangler：npm install -g wrangler
登录 Cloudflare：wrangler login
创建 D1 数据库：wrangler d1 create flyimg-db，将 database_id 填入 wrangler.toml
执行迁移：wrangler d1 execute flyimg-db --file=migrations/0001_init.sql --local
启动 Worker：wrangler dev
修改 frontend/config.js 中的 API_BASE 为本地 Worker 地址
用任意静态服务器托管 frontend 目录

自定义修改

修改过期时间：设置 EXPIRE_HOURS Secret
修改文件类型：设置 ALLOWED_TYPES Secret
修改界面文案：编辑 frontend/index.html
添加新 API：在 worker.js 中添加新的路由处理
修改数据库结构：在 migrations/ 中添加新的 SQL 文件

许可证

MIT License

贡献

欢迎提交 Issue 与 PR。

支持

如果你觉得这个项目有用，请点个 Star ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 37 Commits
.github/workflows		.github/workflows
frontend		frontend
migrations		migrations
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
worker.js		worker.js
wrangler.toml		wrangler.toml

Folders and files

Latest commit

History

Repository files navigation

Flyimg · 瞬传・瞬用

项目介绍

核心亮点

架构设计

🚀 一键部署指南

第一步：Fork 仓库

第二步：创建 Cloudflare 资源

2.1 注册 Cloudflare 账号

2.2 创建 R2 存储桶并开启公共访问

2.3 获取 Account ID

2.4 创建 API Token

2.5 部署 Worker 并获取 Worker URL

2.6 生成 CRON_SECRET

第三步：配置 GitHub Secrets

第四步：触发部署

第五步：查看部署状态

第六步：开始使用

可选配置：限流防护

部署问题排查

❌ 部署失败：Missing required GitHub Secrets

❌ 部署失败：Failed to create D1 database

❌ 前端页面打开但上传失败

❌ 管理后台提示"未授权"

❌ 图片上传成功但无法访问

功能详情

上传功能

用户文件查看

管理后台

权限体系

API 文档

上传图片

查询用户文件

查询所有文件（管理员）

删除文件（管理员）

清理过期文件（管理员）

存储统计

配置说明

Worker 环境变量

cacheControl 联动机制

R2 文件元数据

数据库结构

images 表

索引

免费额度说明（Cloudflare）

工作机制

常见问题

1. 图片过期后多久删除？

2. 可以自定义过期时间吗？

3. 如何限制文件大小？

4. 图片直链是 R2 还是 Worker？

5. 相同文件被不同用户上传会怎样？

6. 如何进入管理后台？

7. 如何配置限流？

8. 部署后如何更新代码？

9. 如何重新部署？

10. WORKER_URL 可以用自定义域名吗？

项目结构

二次开发

本地开发

自定义修改

许可证

贡献

支持

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages