自建用户指南 · 核对日期 2026-10-27
一步一段,
让智能体帮你搭好图床。
Cloudflare 是提供网站网络、安全与云服务的平台;R2 是其中存放图片、PDF 的云端仓库。下面的术语说明可随时通过页面目录返回查看。
先读本阶段步骤,再点“复制本阶段提示词”,粘贴给具备浏览器或开发能力的智能体。每步验收通过后再继续,已有配置优先复用。
这里的“提示词”是给智能体的任务说明,不是下载工具的领取口令。已有自己的图床地址和上传令牌,可直接从第 7 阶段开始。下载客户端不会获得作者的存储空间或管理权限。
本教程主线:桌面客户端 → 你的图床服务端 → R2。上传和管理受保护,按本文设置的文件链接可以公开读取。“私有图床”不是所有图片都禁止公网访问。
所有示例均使用占位符。不要把密码、令牌、卡号、安全码、短信验证码或恢复码粘贴到聊天中;它们由你在官方页面或软件内填写。智能体没有操作权限时,应给你逐步指导,不能假称已经完成。
先看懂这些词,再动手
Cloudflare 是一个提供网站网络、安全与云服务的平台。R2 是它旗下存放图片、PDF 等文件的云端仓库。
可以叫它一声“赛博大善人”:R2 标准存储有免费额度,公网出网流量不收费;存储和请求超出额度仍会计费。查看官方计费说明。
- 图床
- 把图片或文件上传后,返回一个可分享链接的服务。
- 存储桶(Bucket)
- R2 里的一个文件容器,类似专门放这套图床文件的“大文件夹”。
- API(接口)
- 软件之间办事的入口;桌面工具通过它向网页图床提交文件。
- 令牌(Token)
- 给软件用的通行证。上传令牌允许上传;部署令牌用于配置服务;统计授权用于看用量,三者不能混用。
- 域名 / 子域名
- 方便记忆的网址名称;如 example.com 是域名,img.example.com 是给图床用的子域名。
- 公网访问
- 拿到文件链接的人能从互联网打开它。公开文件不代表公开上传和管理权限。
- Worker / 部署
- Worker 是运行在 Cloudflare 云端的小程序;部署就是把图床程序放上去,让它开始提供服务。
- KV(键值存储)
- 保存配置和文件说明的“小账本”;图片和 PDF 本体仍放在 R2 里。
- HTTPS / TLS
- 让传输中的数据加密,减少被旁路偷看的风险;不是把公开文件变成只有你能看。
- GitHub / Fork / Actions
- GitHub 存放项目代码;Fork 是复制一份到自己账户;Actions 按流程构建和部署。
先确定你要搭哪一套
目标:复用现有服务,避免重复开通和误改网站。
- 准备可接收验证邮件的邮箱、Cloudflare 账号(已有就复用),采用 GitHub 仓库部署时准备 GitHub 账号。
- 准备自己的域名,用子域名做图床;没有域名可先验证平台提供的测试入口,不要求先购买域名。
- 明确要的是带网页管理后台的图床;R2 只是文件存储,并不自动包含上传页、管理员登录和历史记录。
- 把图片、运营文档和安装包分开管理。发布工具的下载站与个人图床无需使用同一个桶。
完成标志:列清已有资源、缺少资源及待本人操作的步骤。
查看完整提示词
请协助我搭建一套带网页管理后台、能连接桌面客户端的个人图床,架构固定为“桌面客户端 → 图床服务端 → Cloudflare R2”。现在只做第 1 阶段准备。 先检查当前工作目录、项目文档及浏览器已登录账户,复用已有图床、Worker、R2 和域名,不重复创建。不读取或回显无关凭证。 列出我已有的资源、还缺的资源、是否需要本人登录。优先评估成熟项目 CloudFlare-ImgBed 的许可证、维护状态、部署文档和本客户端接口兼容性,不另造框架,不改成 S3 直连方案。 域名示例统一写 img.example.com,桶名写 my-imgbed-files;不要使用作者教程的真实账号配置。没域名先说明测试入口的限制,不自动购买。 输出简单步骤及每步的验证方法;只有缺少必要信息时再问我。不要购买套餐、修改现有网站或删除数据。
注册 Cloudflare,验证邮箱
目标:进入自己的正确账户,邮箱验证完成。
- 进入 Cloudflare 官方注册页。已有账号直接登录,先确认账户归属。
- 本人填写邮箱和密码、完成页面要求的验证。智能体可说明位置,不代收密码或验证码。
- 打开邮箱中的验证邮件,点击官方验证链接。没有收到时查看垃圾邮件,并在个人资料的邮箱设置中重发。
- 回到控制台,确认邮箱状态已验证;域名托管、R2 开通是后续独立步骤。
完成标志:能进入控制台,邮箱显示已验证。
查看完整提示词
请只协助第 2 阶段:注册或登录 Cloudflare 并验证邮箱。 先检查当前浏览器是否已登录正确账户;已有账号就复用,不重复注册。只从 Cloudflare 官方网站进入注册和登录。 未注册时,引导我填写自己的邮箱和密码并完成验证。所有密码、验证码及恢复码由我本人输入,不索取、不读取、不记录、不回显。 注册后指导我到邮箱点击验证链接;未收到邮件先查垃圾邮件,再说明 My Profile → Email Address → Send verification email 的重发入口,以当前界面为准。 验收:控制台可访问且邮箱状态已验证。明确汇报通过与未完成项,不因注册成功就声称 R2 已开通。不购买其他套餐。
开通 R2:支付方式与费用要看清
目标:完成 R2 订阅开通,不误开其他付费产品。
- 在控制台进入 Storage & databases → R2 → Overview(中文界面通常为“存储和数据库 → R2 对象存储”)。若已能创建桶,不用重复开通。
- 新账户通常需要完成 R2 订阅结算,添加有效支付方式。大家常说的“绑卡”就在这个环节;以当前页面提供的卡或钱包选项为准。
- 如果已有支付方式,先本人核对是否可用;需要新填时,本人在官方页面填写支付信息与真实账单资料,完成银行或支付平台验证。不要将这部分截图发给智能体。
- 某品牌银行卡在支持列表里,不代表某一家银行发行的具体卡一定通过。失败时查看官方页面和发卡行提示,不反复盲试,不找陌生人代绑。
- 最终确认前核对订阅产品是 R2、免费额度、超额单价和条款。开通 R2 不要求先把域名套餐升级到 Pro。
- 本人完成订阅确认后,返回 R2 概览,确认出现创建存储桶入口。仅银行验证通过,不等于 R2 订阅已经开通。
“免费额度”不是费用上限
- 标准存储:每月免费 10 GB-month,超额 $0.015 / GB-month。
- A 类操作:每月免费 100 万次,超额 $4.50 / 百万次。
- B 类操作:每月免费 1000 万次,超额 $0.36 / 百万次。
- R2 公网出网流量费为 0。低频存储不适用上述免费层;Workers、KV 等其他服务有各自额度与计费。
- GB-month 按存储量和时间计量,不是每个月删除旧文件。费用以官方账单为准;预算提醒也不是自动停用的硬限制。
绑支付方式不等于立即产生实际用量账单;可能出现临时预授权,应与真实扣费区分。具体支付选项、税费和结算条款以当时官方页面为准。
查看完整提示词
请协助第 3 阶段:开通 Cloudflare R2,并详细解释支付方式要求。 先检查当前账户 R2 是否已开通;已开通就验证创建桶入口,不重复订阅。 未开通时进入官方 R2 Overview。用当前官方定价解释标准存储每月免费 10 GB-month、A 类 100 万次、B 类 1000 万次以及超额计费;明确免费额度不是费用封顶,R2 出网免费不等于所有 Cloudflare 服务免费。不要升级域名 Pro 套餐。 若要求添加支付方式,说明页面当前可选方式和字段含义,让我本人填写卡号、安全码、账单地址、短信验证码或钱包验证;不要索取、读取、截图、保存或发送这些信息。已有支付方式先核对,不重复添加;不要保证某张国内卡必然可用,不推荐代绑服务。 最终订阅前让我本人核对产品、金额与条款并确认。若失败,记录脱敏后的错误文本,查官方说明,不连续重试支付。 验收:R2 概览可打开并出现创建存储桶入口。将支付验证、订阅开通和实际使用分开报告;完成后不要擅自创建桶或购买其他服务。
创建标准存储桶,准备元数据资源
目标:让文件存储和图床配置各有正确位置。
- R2 中选择 Create bucket,名称示例
my-imgbed-files。保留 Standard 标准存储类,确认后创建;已有目标桶先复用。 - 保持桶默认私有。本文由图床 Worker 读取文件,不需要为桶启用
r2.dev公网入口。 - 本教程采用 KV 路线:创建 KV 命名空间供配置和元数据使用。所用上游版本若改为 D1,按它的实际部署文档选择,不同时盲目创建两套。
- 在自己的私有部署配置中记录资源对应关系,公开教程只用占位符。不要把账户 ID、资源 ID 和管理员凭证混作同一类信息。
完成标志:目标桶为 Standard,元数据资源存在,绑定名称与代码要求一致。
查看完整提示词
请协助第 4 阶段:为图床服务端准备 R2 与元数据资源。 先阅读当前 CloudFlare-ImgBed 版本的部署文档,检查目标账户已有资源,避免重复创建。R2 桶使用我确认的名称和 Standard 标准存储,示例 my-imgbed-files。保持公共访问关闭,不添加 r2.dev 或桶自定义域名。 本文采用 KV 路线,按项目实际配置创建或复用 KV;如果项目版本要求 D1,请先说明区别,再采用一条兼容路径,不同时无目的地创建。 核对 R2 binding 与 KV binding 的代码名称(本文示例分别为 img_r2 和 img_url),将资源值保存在私有部署配置,不放进前端、日志或公开截图。 使用 Worker binding 时不要求我先生成 S3 Access Key。验收目标桶存储类、资源归属、绑定名称均正确,给出脱敏完成清单。
部署带登录保护的网页图床
目标:有可用后台和上传接口,而不只是一个空桶。
- 按 图文教程和 网页服务端上游项目文档部署,检查当前版本的许可证与部署要求。
- 在部署平台的秘密配置中填写管理员密码、访问码或部署令牌。管理员密码、Cloudflare 部署 Token、图床上传 Token 各有用途。
- 绑定上一阶段的 R2 与 KV。本文 Worker 方案把图床域名接到 Worker,不把桌面工具改成 S3 直连。
- 检查构建、资源绑定和 Secret 写入结果,实际打开后台登录。部署命令成功不等于全部功能通过。
- 后台启用 R2 上传渠道,先验证一张无敏感信息的小图片。
完成标志:上传成功且桶内有对应对象;未授权用户不能上传、删除或读取管理 API。
查看完整提示词
请协助第 5 阶段:部署 CloudFlare-ImgBed 网页图床服务端。 先读取当前上游 README、许可证、Workers 部署说明及我的现有配置,复用成熟实现,不重写图床。保留“桌面客户端 → 图床服务端 → R2 binding”的架构。 确认实际部署方式、R2/KV 绑定名称以及所需最小部署权限;使用平台 Secret 管理密码和令牌,不把真实值写进 Git、前端代码、命令回显或截图。需要凭证时让我在对应官方页面自行填写。 先配置管理员认证和上传保护,再开放服务。核对构建、部署及 Secret 写入均成功;后台启用 R2 渠道。 用一张非敏感测试图片实测上传、R2 对象存在及返回链接;同时实测匿名上传和管理 API 被拒绝。每项标注通过或错误,不用构建成功替代功能验收。 上游默认接口与桌面扩展可能不同,逐项验证上传、列表和删除兼容性;不支持的功能明确告知,不伪称开箱即用。
配置子域名,验证公网文件链接
目标:图片可匿名打开,管理和上传继续受保护。
- Worker 方案:进入 Workers & Pages → 对应 Worker → Settings → Domains & Routes → Add → Custom Domain,选择自己账户内有效域名区域。
- 使用
img.example.com这样的独立子域名,先查已有 DNS,避免覆盖主站或其他服务。实际为 Pages 部署时,使用 Pages 的域名流程。 - 等待域名和 HTTPS 生效。不要把 R2 S3 API 地址当作文件链接,也不要把图床子域名误绑到存储桶。
- 复制服务端返回的完整链接,在无痕窗口打开。测试中文、空格、
%、#;URL 中特殊字符必须正确编码。 - 桶显示“公共访问已禁用”与 Worker 能公开读取文件并不矛盾;不要遇到 404 就盲目公开整个桶。
完成标志:文件无登录可读取,后台仍需登录,错误文件路径返回正确状态。
查看完整提示词
请协助第 6 阶段:设置图床子域名和公网访问。 先判断我的服务端实际是 Worker 还是 Pages,再使用对应的域名绑定流程。域名示例 img.example.com,必须指向图床服务端,不指向 R2 桶或 S3 endpoint。 只操作本图床子域名,先检查已有 DNS 和域名绑定;若冲突,说明具体影响,不删除无关记录。等待 HTTPS 正常后继续。 测试后台登录、无登录不能上传或删除、测试图片匿名可打开。保留 R2 桶私有,由 Worker binding 读写。 用带中文、空格、百分号和井号的演示文件验证 URL 编码,复制实际返回链接,不手工拼接未编码的路径。 若 404,分别检查后台 SPA 回退、/file 路由、对象键与编码、R2 绑定;不要靠反复刷新或公开整个桶掩盖问题。输出脱敏的逐项验收结果。
领取客户端,连接自己的图床
目标:先跑通上传与复制,再配置独立的用量统计。
- 在 领取区输入有效口令,下载 Windows 64 位程序,放在有写入权限的目录。不要把别人的
data配置目录一起复制过来。 - 在自己的图床后台创建专用 API Token。先给上传权限;需要同步时加列表权限,确需删除云端文件时再给删除权限。
- 客户端设置选择“图床 API”,填自己的图床地址与刚创建的上传令牌,不填 Cloudflare 全局 API Key。
- 先上传一个小文件,确认文件名、链接和预览;再测试带子目录的文件夹和 PDF。
- 统计仪表盘需单独授权。图床上传令牌不能自动读取 Cloudflare 账户统计;按客户端实际授权入口操作。
完成标志:小图上传、链接匿名访问和历史同步分别通过;统计授权单独报告。
查看完整提示词
请协助第 7 阶段:连接拾玖图床桌面客户端。 指导我从官方领取页输入有效口令并下载,将程序放在可写目录;不要索取领取口令或保存临时下载链接到公开记录。 使用“图床 API”方式,地址示例 https://img.example.com,上传令牌由我在软件内填写。区分图床 Token、Cloudflare API Token 和 R2 S3 密钥,不能混用,不要求全局 API Key。 上传权限按最小需要配置;需要同步列表才增加对应权限,永久删除权限仅在确有需要时添加。 实测小图上传、保留文件名、复制链接、未登录打开、历史同步,再测试子文件夹与 PDF。客户端与上游接口有不兼容时说明具体功能,不修改其他数据。 仪表盘授权独立验证。若走 API Token 路线,查代码与官方文档确认所需 Account Analytics Read 等最小权限并限制到目标账户。不要把上传成功说成统计授权已成功。
最后验收,再开始日常使用
目标:能上传、能核对、能恢复,更新时保留数据。
- 用演示图片核对“目录名+原文件名主体+时间戳”,选中多条链接粘贴到表格,确认逐行对应。
- 用测试记录验证移入回收站和恢复;清空会永久删除,不拿正式产品图试验。
- 主窗口拖入可预览确认,悬浮窗按当前版本行为直接上传;用非敏感文件先试一次。
- v1.4.22 及更早版本首次手动升级时先确认旧程序位置并退出,以
blues19-ImgBed.exe替换原主程序,保留原data文件夹;不要只把带不同版本名的新文件放在旁边。v1.4.23 起可在设置检查更新,每次下载更新仍需有效口令。 - 定期看官方用量和账单。统计缓存、刷新延迟、当前存储快照和月度计费用量要区分,仪表盘不是费用封顶开关。
查看完整提示词
请协助第 8 阶段:完成图床整体验收并指导日常更新。 先备份重要配置和历史,在演示数据上检查批量上传、中文及特殊字符、文件名与链接对应、选中链接逐行粘贴表格、历史日期与大小、回收站恢复。不要对真实文件执行永久删除。 检查匿名文件读取与受保护的上传/管理边界;公开报告只用示例域名、脱敏截图,不出现账号 ID、邮箱、桶内部名称、后台地址、密码、令牌或本机路径。 说明主窗口预览确认与悬浮窗直接上传的区别。更新前结束上传并备份,保留 data。旧版先手动覆盖主程序;支持内置更新的版本使用设置中的检查更新,每次下载都由我输入有效口令。 不得关闭 TLS 证书验证,不跳过更新签名和哈希检查。失败时保留旧版与数据,记录脱敏错误再定位。 最后给我通过/未通过/未测清单及简短操作说明,明确用量统计不等于账单,不宣称永久零费用或绝对不会错配。
卡在哪一步,就从那一步继续
提示词不会替你自动授权账户,也不能保证所有智能体都支持浏览器操作。遇到登录、验证码、支付或服务限制,由你在官方页面完成必要操作。可把脱敏后的错误文字交给智能体分析,不需要发送完整账号截图。