七牛云存储配置指南：为平台图片资源开启CDN加速

为什么平台需要单独配置云存储

外卖平台跑起来之后，图片是所有资源里最”吃”服务器的东西：商家的菜品图、门店头图、平台首页的轮播 banner、用户头像……一张高清菜品图几百KB，一个门店几十上百个商品，图片总量很快就会膨胀到几个G甚至更多。

如果所有图片都堆在平台自己的服务器上，会带来两个明显的问题：一是服务器磁盘和带宽压力大，图片一多加载就慢，用户刷菜单转圈圈，下单意愿直接打折扣；二是图片流量挤占了接口带宽，高峰期订单接口都可能被拖慢。

云存储 + CDN 就是为解决这个问题而生的：图片上传到七牛云这样的专业对象存储服务，用户访问时由 CDN 节点就近分发，速度快、不占自己服务器带宽。海狐外卖系统支持为平台单独配置云存储，整个接入过程在七牛云官网和平台后台两处完成，跟着下面的步骤走，半小时内就能配好。

配置前的准备

开始前请确认两点：

已经注册七牛云账号（官网：https://www.qiniu.com/），并完成实名认证——创建存储空间需要账号处于可用状态
手上有平台总后台的管理员权限，因为最后一步参数要填到总后台

第一步：登录七牛云，创建对象存储

打开七牛云官网并登录，进入主面板，点击**「创建对象存储」**。

进入创建界面后，按页面要求填写各项信息即可。其中存储空间名称可以随意填写——不过建议按”平台名+用途”的方式命名（例如 seafox-images），方便日后在七牛后台一眼认出这是哪个业务的存储空间，避免多个项目混用时找错 bucket。

创建完成后，这个存储空间就是平台所有图片的”仓库”了。

[图片说明：七牛云主面板创建对象存储入口]

第二步：获取 AccessKey 与 SecretKey

接下来要找到一对关键的密钥，平台后台靠它来向七牛云上传文件。

进入七牛云的个人面板 → 密钥管理页，在密钥列表中找到对应的 AccessKey 和 SecretKey，复制备用。

这两串密钥相当于平台操作你七牛账号的”钥匙”，注意：

复制时前后不要带空格，后台粘贴后建议核对首尾字符
SecretKey 不要泄露给无关人员，更不要在群聊、工单里明文发送
如果怀疑密钥泄露，第一时间回密钥管理页重置

第三步：配置 Http 前缀

Http 前缀的作用是拼出上传图片后的完整访问路径，格式一定要完整正确。

打开刚创建的存储资源，找到测试域名，复制其中的域名部分，拼接成完整的前缀格式。注意格式必须包含协议头和结尾的斜杠，例如：

http://p3ipoi9q3.bkt.clouddn.com/

这就是一个格式完整的 Http 前缀。少了 http:// 开头或者结尾的 /，拼出来的图片地址就是错的，前台会出现图片裂图、加载失败。

这里有一个重要建议：测试域名适合调试，正式运营最好绑定自己的域名。测试域名通常有时效和访问限制，长期用自家域名更稳定，也更利于品牌一致性。

另外，如果需要使用七牛的文件名前缀功能（可以简单理解为给文件分文件夹，比如把商品图和 banner 图分开存放），只要在 Http 前缀的最后附上文件名前缀即可。

第四步：绑定自定义域名（推荐）

在第二步创建完对象存储之后，可以顺手把自定义域名绑定好：

在存储资源页面点击**「域名管理」→「绑定域名」**
按页面提示配置基本信息
提交后会得到需要解析的域名信息——注意这里要解析两条记录：一条用于验证域名所有权，另一条是自定义域名本身
把这两条记录拿到你域名的 DNS 解析服务商处添加解析
解析生效后，回到平台后台，把解析好的自定义域名填入云存储配置中

绑定完成后，图片访问地址就变成了你自己的域名，速度和稳定性都更有保障。

[图片说明：七牛云域名管理绑定域名界面]

第五步：在海狐外卖系统后台填入参数

最后一步回到海狐外卖系统。登录平台总后台，进入：

系统设置 → 平台设置 → 云存储设置

把前面几步准备好的参数逐项填入：

AccessKey / SecretKey：第二步获取的密钥对
Http 前缀：第三步拼接好的完整前缀（如使用自定义域名，这里填自定义域名拼出的前缀）

保存后，平台新上传的图片（商品图、轮播图等）就会自动传到七牛云，并通过 CDN 加速访问。配置完成后建议立刻上传一张测试图验证：上传成功、前台能正常打开、地址是七牛的域名，说明整条链路已经打通。

常见问题 FAQ

1. 存储空间名称有什么命名要求？

没有硬性要求，可以随便填写。但强烈建议按”业务+用途”的方式命名并随手记录，一个账号下建多个空间时，规范的命名能帮你快速区分，避免把测试图片传到了正式空间。

2. 不绑定自定义域名，直接用测试域名可以吗？

可以临时用，但不建议长期用。测试域名受平台策略限制，可能出现时效或访问异常，直接影响前台图片显示。正式环境请按第四步绑定自己的域名，稳定且可控。

3. 图片上传后前台显示裂图，可能是什么原因？

优先检查 Http 前缀格式：必须以 http://（或 https://）开头、以 / 结尾，中间是完整域名。任何一个部分缺失都会导致拼接出的图片地址非法。其次确认密钥是否填对、存储空间状态是否正常。

4. 文件名前缀是什么？怎么理解？

可以把它理解为”虚拟文件夹”。比如前缀填 http://你的域名/goods/，上传的商品图地址就会自动带上 goods/ 这一段，方便按业务归类管理图片。不需要分类就不填，保持前缀以域名根路径结尾即可。

5. 绑定域名时要解析几条记录？

两条。一条用于验证域名所有权（证明这个域名确实是你的），另一条是你的自定义域名本身。两条都解析成功并生效后，才能把自定义域名填进后台使用。如果只解析了一条，绑定会失败或一直显示验证中。