CloudFlare-ImgBed免费无限图床小白部署教程

基于 CloudFlare 的开源文件托管解决方案，支持 Telegram Bot、Cloudflare R2、S3 等存储渠道，实现低成本文件托管，简单说就是白嫖到底！

渠道类型：

Telegram Bot 完全免费、无限容量大于20MB文件需分片存储我们这里主要就是白嫖TG来储存，唯一现在就是单张图片不能大于20MB
Cloudflare R2 无文件大小限制、企业级性能超出10G免费额度后收费，需要绑定支付方式
S3 兼容存储选择多样、价格灵活根据服务商定价

部署完成后进阶教程：给免费图床加个速：CloudFlare-ImgBed 配置国内 CDN，实现免费 CDN 加速图床功能

第一步：Fork 项目

访问 CloudFlare ImgBed 项目，点击右上角的 “Fork” 按钮，将项目 Fork 到自己的 GitHub 仓库。

第二步：创建 Pages 项目

1. 访问 Cloudflare Dashboard 关联仓库

2. 配置项目设置

项目名称：cloudflare-imgbed（或自定义）
生产分支：main（默认）
构建命令：npm install 重要：v2.0 新构建命令，旧版本构建命令不适用
构建输出目录：/（默认）

重要提醒：v2.0 版本的构建命令已变更为 npm install，请务必确保填写正确，否则部署会失败。

3. 部署项目

点击 “保存并部署”，等待首次部署完成（约 2-3 分钟），部署成功后即可通过 Cloudflare 生成的临时域名访问。

Cloudflare-ImgBed 中 KV vs D1 数据库配置对比

核心配置与使用差异表

对比维度	Cloudflare KV 数据库	Cloudflare D1 数据库
配置难度	极低，项目默认适配，仅绑定 KV 命名空间即可用	较高，需手动建库/表、修改代码适配 SQL 语句
每日免费核心额度	写入/删除/列出：各 1000 次；读取：10 万次	写入：10 万行；读取：500 万行
超额度后上传/访问影响	图片可正常上传、访问（文件存 R2/Telegram）	图片可正常上传、访问（文件存 R2/Telegram
超额度后后台管理影响	超出 1000 次写入：新上传图片无法在后台查看/删除/管理	仅极端场景（日传超 10 万张）才会超额度，新上传图片无法在后台查看/删除/管理

核心使用场景与选型建议

优先选 KV 的场景（90% 个人用户）
- 核心诉求：仅作为图床使用，能正常上传/访问图片即可，后台管理（查看/删除）非核心需求；
- 优势：配置最简单、上传/访问速度极快、支持大文件，即便单日上传超 1000 张：
  - ✅ 图片仍可正常上传、访问（文件实际存在 R2/Telegram）；
  - ❌ 仅超出 1000 张的部分无法在后台查看/删除，对纯图床使用几乎无影响；
- 适配性：单日上传超 1000 张后，后台管理已无实际意义（手动管理 1000+ 张图片本身效率极低），完全契合“纯图床”定位。
选 D1 的场景（小众需求）
- 核心诉求：需在后台批量筛选/统计图片（如“按日期筛选上传记录”“统计各存储渠道图片数量”）；
- 优势：额度极高（日写入 10 万行），几乎不会触发超限额，支持数据回溯恢复；

关键结论

若仅把 Cloudflare-ImgBed 当“纯图床”用（核心是传图/访问，后台管理可有可无），KV 是最优解：配置简单、速度快、支持大文件，超 1000 次仅影响后台管理，不影响核心功能；
若需高频在后台管理/统计图片，且仅传小文件，可选择 D1，但需接受配置复杂

第三步：配置数据库（必需）

数据库用于存储文件元数据，是项目运行的核心组件，可选 KV 数据库和 D1 数据库。由于 KV 数据库配置更简单，此处以 KV 数据库为例（可理解为用于储存配置文件和文件关联数据）。

1. KV 数据库配置：创建 KV 命名空间

在 Cloudflare Dashboard 中选择 “存储和数据库”，点击 “KV”，再点击 “创建命名空间”
输入命名空间名称：img_url（建议使用此名称，后续绑定需对应一致）

注意：若你不使用 R2 存储渠道，可跳过下方 R2 渠道配置步骤。

2. R2 渠道配置（可选）

进入 Cloudflare “R2 对象存储” 页面，点击 “创建存储桶”，存储桶名称可自定义（示例中使用 img-r2），按提示完成创建即可。

第四步：Telegram（电报）设置

1. 逻辑和原理

简单来说，就是在 Telegram 中创建一个专属频道，将机器人添加为频道管理员，后续上传的文件会自动存储到该频道中，实现无限免费存储扩容。

2. 添加机器人

打开 Telegram，搜索 @BotFather，向其发送 /newbot，按提示给机器人起一个名称（需以 Bot 或 -bot 结尾，且不能与现有机器人重名，重复会有提示），创建成功后记录机器人的 API Token（后续需用到）。

/newbot 回车发送。

botfarther会反馈

Alright, a new bot. How are we going to call it? Please choose a name for your bot.

输入你要创建的bot名字。例如peiqi123_bot,回车发送

它会反馈 Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.

我再输入 peiqi123_bot。这是这个机器人的名字。

它会反馈Done! Congratulations on your new bot. You will find it at******