搭建私人图床:Cloudflare R2 + CloudFlare-ImgBed 完全指南
本教程将引导您完成从准备到部署的全过程,最终获得一个支持拖拽上传、安全稳定且完全由自己掌控的私人图床。
第一步:获取核心项目
- 访问 GitHub。

- 在搜索框中输入
CloudFlare-ImgBed 并搜索。 - 找到对应的开源项目,点击右上角的
Fork 按钮,将该项目克隆到您自己的 GitHub 仓库中。这是您图床的“心脏”。
第二步:在 Cloudflare 上创建 Pages 项目
- 登录您的 Cloudflare 控制台。
- 在左侧导航栏中,点击
Workers 和 Pages。 - 选择
创建项目 -> Pages。 - 点击
连接到 Git,关联您的 GitHub 账户。 - 授权后,选择您刚刚
Fork 的CloudFlare-ImgBed项目仓库。 - 点击
开始部署,让 Cloudflare 自动构建项目。
第三步:准备存储和数据库(在 Pages 构建时进行)
- 创建 R2 存储桶(用于存放图片):
- 在 Cloudflare 控制台左侧导航栏,进入
R2。 - 点击
创建存储桶。 - 为存储桶命名,例如
my-img-bed,然后创建。
- 在 Cloudflare 控制台左侧导航栏,进入
- 创建 KV 数据库(用于管理图片链接):
- 在控制台左侧导航栏,进入
Workers KV。 - 点击
创建命名空间。 - 为其命名,例如
img_url,然后创建。这能确保您的图片链接永久有效。
- 在控制台左侧导航栏,进入
第四步:配置 Pages 项目(关键步骤)
- 回到
Pages 项目页面,找到您刚刚部署的项目,进入其 设置。 - 在左侧找到
绑定 选项。- 添加 KV 命名空间绑定:
- 变量名称:输入
img_url。 - KV 命名空间:选择您创建的
img_url。
- 变量名称:输入
- 添加 R2 存储桶绑定:
- 变量名称:输入
img_r2。 - R2 存储桶:选择您创建的
my-img-bed。
- 变量名称:输入
- 添加 KV 命名空间绑定:
第五步:设置安全环境变量(为图床上锁)
- 在 Pages 项目设置的同一页面,找到
环境变量 选项。 - 添加以下变量以增强安全性:
AUTH_CODE:设置一个您自定义的 上传授权码。只有知道此码才能上传图片。BASIC_USER:为您图床的后台管理页面设置一个 用户名。BASIC_PASS:为您图床的后台管理页面设置一个 密码。
第六步:重新部署并绑定域名
- 所有配置完成后,返回 Pages 项目概览页,点击
重新部署 以使配置生效。 - 部署成功后,进入
自定义域 设置。 - 点击
设置自定义域,绑定您自己的域名(例如img.yourdomain.com)。按照提示完成 DNS 验证。
大功告成!
完成以上六步后,您的私人图床就搭建完成了。您可以通过绑定的域名访问图床:
- 登录页:使用您设置的
BASIC_USER和BASIC_PASS登录后台。 - 上传页:在后台,您可以享受拖拽上传的便捷,并使用
AUTH_CODE进行安全的 API 调用。
从此,您就拥有了一个高性能、高可靠性、完全自主控制的图片托管服务,彻底告别第三方图床的费用和稳定性困扰。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...




