七牛云配置教程：AccessKey、Bucket 与区域选择的完整填写指南

学完这篇，你能在 Clara BBS 后台把七牛云对象存储一次填对，图片附件直接走云上，不再占服务器空间。

第一步：先把三样东西从七牛控制台拿出来

登录七牛云控制台 portal.qiniu.com，按下面顺序取三样：

AccessKey 和 SecretKey：右上角头像 → 「密钥管理」。AK 是一串公开的字母数字，SK 相当于密码。这两个是配对的，缺一个都签不了名。

Bucket 名称：左侧「对象存储 Kodo」→「空间管理」→ 新建空间。空间名就是 Bucket，全局唯一，只能用小写字母、数字、短横线。注意它不是你写的备注名，备注随便写，Bucket 必须填那个真正的空间名。

区域：新建空间时选的存储区域，创建后不能改。常见的有华东-浙江（z0）、华北-河北（z1）、华南-广东（z2）、华东-浙江2（cn-east-2）、北美（na0）、亚太-新加坡（as0）。以控制台该空间概览页显示的为准，别凭记忆填。

注意：SecretKey 不要发到群里、不要截图带进工单、不要写进公开的配置文件。一旦泄露，立刻在密钥管理里重置。

第二步：后台「系统设置 → 云存储」逐项粘贴

进 Clara BBS 后台 → 「系统设置」→「云存储」，打开开关，驱动选七牛，然后把三样东西对着填：

• AccessKey：粘贴 AK
• SecretKey：粘贴 SK
• Bucket：粘贴空间名
• 区域：选对应区域项（如果下拉里没有你要的，说明系统版本较老，先升级后台文件再执行一次「系统工具 → 数据库升级」）
• 访问域名：下一步拿到后再回来填

Clara BBS 是保存即生效的，不用编译、不用清缓存，填完直接点保存就行。

注意：粘贴时最容易带进首尾空格和换行，尤其是从记事本复制的 SK。填完先用眼睛核对一遍字符数，比后面一个个排查报错省事。

第三步：绑定访问域名并做 CNAME 解析

七牛默认给的测试域名有时效、还会限速，正式站必须绑自己的域名：七牛「空间管理」→ 选中空间 → 「域名管理」→ 绑定域名（国内节点需要域名已备案）→ 七牛会给你一个 CNAME 目标 → 去你的域名解析处加一条 CNAME 记录指向它。

解析生效后回到 Clara BBS 后台，把访问域名填成 `https://你的域名`，结尾不要带斜杠。

注意：如果你是 www 和裸域一起用，建议后台「基本设置」里的站点地址也统一成同一个主域名，避免会话和图片地址来回跳。

第四步：实测一张图

发一个带图片的帖子，上传后看图片地址是不是你绑定的那个域名。如果失败，页面会给具体原因，按提示查：

• `no such bucket` → Bucket 名填错了
• 签名相关报错（400 类）→ 区域和空间实际所在地不一致，或 AK/SK 不配对
• 403 → 空间是私有读，公开访问需要开签名；图省事就把空间权限设为公开读

注意：换了云存储不等于绕过了上传限制。后台「系统设置 → 上传」里「允许的扩展名」（管图片）和「附件允许的扩展名」（管附件）是两个独立字段，都要包含你要传的格式；另外 PHP 的 `upload_max_filesize` 和 `post_max_size` 仍要大于文件体积（宝塔默认 2M，手机照片常超，建议调到 30M 以上）——云存储只是把文件从服务器中转走，不是把 PHP 限制取消。

注意：切换云存储前，别急着删服务器 uploads 目录里的老图，先确认旧帖图片仍是本地路径，删了会集体挂图。稳妥做法是保留一段时间再清理。

小结

1. 三样必填项：AccessKey、SecretKey 来自「密钥管理」，Bucket 来自「空间管理」，区域创建后不可改。
2. 入口：后台「系统设置 → 云存储」，保存即生效，无需清缓存。
3. 访问域名要绑定 + CNAME 解析，填 `https://域名` 不带斜杠。
4. 报错先分三类看：bucket 名错、区域与 AK/SK 不匹配、空间私有读。
5. 上传白名单和 PHP 大小上限是两套独立开关，云存储不会替你处理。