Cloudflare Pages搭建CloudFlare-ImgBed图床

使用开源项目：https://github.com/MarSeventh/CloudFlare-ImgBed

官方文档：https://cfbed.sanyue.de/

基于Cloudflare Pages 部署

Cloudflare Pages 是推荐的部署方式，提供免费托管、全球 CDN 加速和无需服务器维护的优势。

所需材料

可以绑定的信用卡（建议使用真实有效的信用卡信息）
一个托管到Cloudflare的域名

Fork 项目

访问 CloudFlare ImgBed 项目
点击右上角的 “Fork” 按钮
选择您的 GitHub 账户
确认 Fork 完成

创建 Pages 项目

登录 Cloudflare Dashboard
选择左侧菜单的 “计算和AI” -> “Workers & Pages”
点击 “创建应用程序”
在最下方 Looking to deploy Pages? 选择 “Get started”
在 “导入现有 Git 存储库” 处点击 “开始使用”

连接 GitHub 仓库

如果首次使用，需要授权 Cloudflare 访问 GitHub
选择您 Fork 的 CloudFlare-ImgBed 仓库
点击 “开始设置”

配置项目设置

配置项	值	说明
项目名称	`cloudflare-imgbed`（或自定义）	项目标识符
生产分支	`main`	生产环境分支
构建命令	`npm install`	重要：v2.0 新构建命令
构建输出目录	`/`	保持默认

v2.0 版本的构建命令已变更为 npm install，请确保使用正确的构建命令。

部署项目

点击 “保存并部署”
等待首次部署完成（约 2-3 分钟）

配置数据库

数据库用于存储文件元数据，是必需的组件，可选数据库为 KV 数据库和 D1 数据库。两者对比如下表所示，根据自己使用场景从其中选择一种配置即可。

特点	KV 数据库	D1 数据库
读写性能	高	较低
免费额度	少	多
大文件上传	支持	不支持

D1 数据库配置

创建 D1 数据库

在 Cloudflare Dashboard 中选择 “存储和数据库”
点击 “D1 SQL 数据库”
点击 “创建数据库”
输入数据库名称：img_d1（建议使用此名称）
点击 “创建”

初始化 D1 数据库

创建完成后，点击进入数据库详情页
选择 “控制台” 选项卡
访问项目仓库复制内容，在 SQL 输入框中逐段粘贴并执行初始化语句
点击 “执行”

绑定 D1 到项目

返回您的 Pages 项目
选择 “设置” → “绑定”
点击 “添加” → “D1 数据库”
填写绑定信息：
- 变量名称：img_d1（必须与此名称一致，与项目代码中的环境变量名对应）
- D1 数据库：选择刚创建的数据库
点击 “保存”

重新部署

绑定数据库后需要重新部署以生效：

进入项目的 “部署” 页面
找到最新的部署记录
点击右侧的 “…” 菜单
选择 “重试部署”
等待部署完成

配置项目

存储渠道配置

部署完成后访问您的域名，进入管理后台配置存储渠道。

访问管理后台

访问 https://your-domain/dashboard（请将 your-domain 替换为您自己的域名）

管理后台默认无需密码，登录后请及时设置管理员用户名和密码。

配置 R2 渠道

服务器部署时默认添加了 Cloudflare R2 存储方式，以下步骤仅针对 Cloudflare 部署方式：

在项目设置中绑定 R2 存储桶：
- 选择 “设置” → “绑定”
- 添加 “R2 存储桶”
- 变量名称：img_r2
- R2 存储桶：选择已创建的存储桶
在管理后台配置：
- 进入 “系统设置” → “上传设置”
- 配置 R2 渠道参数
- 如需图像审查，填入 R2 公开访问链接

请注意Cloudflare R2 的免费额度限制，超过后可能会产生费用。

安全提醒

部署完成后请立即设置强密码，避免未授权访问
定期备份数据库和重要配置文件
监控流量使用情况，避免超出免费额度产生额外费用

故障排除

如果部署失败，请检查构建日志中的错误信息
如果无法访问管理后台，请确认环境变量配置正确
如果上传功能异常，请检查R2存储桶权限设置

使用建议

建议定期清理不需要的图片文件以节省存储空间
可以设置防盗链规则防止资源被滥用
对于重要图片，建议启用备份机制

清夏晚风的博客