轻松搞定！Xiuno论坛无缝对接七牛云存储，图片加速飞起来

52JinY 助手

折腾了好几天，终于把xiuno论坛的附件存储对接到七牛云上了，踩了不少坑，来这里记录一下，也给后面有需要的朋友省点时间。

先说一下为什么要做这个对接。我的论坛跑在一台小水管VPS上，磁盘空间只有40G，论坛上线半年多，用户上传的图片和附件已经快把硬盘撑满了。每次后台看到存储占用率往上涨，心里都发慌。本来想直接换个大磁盘的机器，但算了算成本，还不如把附件扔到对象存储里，七牛云有10G免费额度，超出部分也便宜，对个小站来说完全够用。

xiuno本身没有内置对象存储的支持，所以要靠插件来实现。我在官方论坛找了一圈，发现有一个叫做xiuno_qiniu的插件，是社区里的开发者贡献的，代码不算复杂，逻辑就是把用户上传的文件通过七牛SDK转存到bucket里，然后把访问地址替换成CDN域名。整体思路很清晰，但安装过程有几个地方需要注意。

第一个坑是七牛的SDK版本问题。插件依赖的是composer方式引入七牛PHP SDK，如果你的服务器PHP版本是8.0以上，老版本SDK里有些语法会报错，建议直接用composer require qiniu/php-sdk来装最新版，然后把插件里require的路径对应调整一下，这一步我卡了将近半天。

第二个坑是绑定域名的问题。七牛要求访问bucket里的文件必须通过已备案的自定义域名，不能直接用它给的测试域名（那个测试域名30天就失效），所以你得提前把域名CNAME解析指向七牛给你分配的CDN节点。我当时以为随便填个测试域名就行，结果图片全部404，排查了好久才发现根源在这里。建议大家在配置插件之前，先在七牛控制台把域名绑定和CNAME解析都验证通过，再动插件配置。

第三个坑稍微隐蔽一些，是关于原有附件的迁移问题。插件装好之后，新上传的文件会自动走七牛，但历史附件还在本地服务器上。如果你论坛有大量老帖子里的图片，直接切换之后用户会发现老图全挂了。我的解决办法是写了一个简单的批量迁移脚本，扫描附件目录，把本地文件通过七牛SDK批量上传过去，同时更新数据库里的file_path字段。这个脚本我跑了大概两个小时才把几千个附件全部迁移完，期间要注意控制并发，别把七牛的上传QPS限流触发了。

另外说一个小细节，七牛对上传文件大小和类型有默认限制，建议在bucket策略里把允许的文件类型和大小上限配置好，和xiuno后台里的附件上传设置保持一致，不然会出现前端提示上传成功但实际上文件根本没传到七牛的奇怪问题。

整体来说，对接完成之后体验还是挺好的，VPS的磁盘压力一下子小了很多，图片加载速度也因为走了CDN快了不少，特别是用户在南方，原来访问我服务器要跑很长的线路，现在CDN节点就近回源，速度明显提升。

如果有朋友在对接过程中遇到问题，可以在这里留言，我尽量解答。这种东西文档少，主要靠自己摸，多交流总比一个人硬撑强。