海洋CMS对接对象存储OSS怎么配置？附件远程存储

海洋CMS 对接对象存储 OSS，本质是把附件从服务器本地 /uploads 目录搬到 OSS Bucket，并且在"上传写入"和"页面读取"两个环节同时改写路径；配置能否成功，取决于三件事：RAM 子账号的最小权限 AK、Bucket 的 CORS 与自定义域名、以及数据库里历史附件路径的批量替换规则。

海洋CMS 有内置的 OSS 开关吗？先确认走哪条路线

结论：先看你后台有没有现成的远程附件开关，有就填参数，没有就必须走插件或二次开发，两者工作量差 10 倍以上。

判断方法：登录海洋CMS 后台，找"系统设置 / 附件设置 / 远程附件"这类菜单项，看里面是否有"存储引擎 / 对象存储 / OSS"的下拉选项。如果只有 FTP 远程附件，说明这个版本走的是 FTP 协议，OSS 并不直接兼容 FTP（OSS 的 FTP 网关已停止新用户开通），不能用 FTP 那套填。

两条路线：

• 路线 A（后台自带）：直接填 AccessKeyId、AccessKeySecret、Bucket 名、Endpoint、自定义域名，保存后上传一个测试附件验证。
• 路线 B（二开）：在附件上传函数里接入阿里云 PHP SDK，命令是 composer require aliyuncs/oss-sdk-php，然后在上传成功后把返回的 URL 写入数据库，而不是写本地相对路径。

OSS 侧要怎么配？Bucket、AK、CORS、域名四步

结论：OSS 侧必须配全四样东西，少一样就会出现"能上传但打不开"或"本地正常线上 403"。

1. Bucket 与地域：Bucket 要和你的 ECS 同地域，PHP 侧用内网 Endpoint oss-cn-<region>-internal.aliyuncs.com，走内网不产生外网下行流量费；外网 Endpoint 是 oss-cn-<region>.aliyuncs.com。比如杭州就是 oss-cn-hangzhou-internal.aliyuncs.com。

1. AK 最小权限：不要用主账号 AK。在 RAM 里建子账号，只授予该 Bucket 的 oss:PutObject、oss:GetObject、oss:DeleteObject 三个 Action，Resource 精确到 acs:oss:*:*:你的bucket名/*。

1. CORS 跨域：如果前端有 JS 直传或编辑器跨域预览，在 Bucket 的"跨域设置"里加规则——来源填 https://你的域名，允许方法勾 GET、POST、PUT、HEAD，允许 Headers 填 *，暴露 Headers 至少加上 ETag。

1. 自定义域名：CNAME 到 Bucket 的外网域名，国内节点绑定的域名必须已备案。建议在 OSS 控制台开启"强制 HTTPS"。

上传和读取的代码要改哪几处？

结论：只改上传函数不够，读地址的地方不改，页面里还是旧域名。

• 上传环节：在接收 $_FILES 的处理函数里，把 move_uploaded_file 换成 SDK 的 $ossClient->uploadFile($bucket, $object, $tmpPath)，$object 建议按 uploads/年月日/文件名 组织，和原来目录结构保持一致，方便日后回迁。
• 读取环节：附件路径通常存在内容表和附件表里，字段值形如 /uploads/2024/0512/xxx.jpg。页面输出时统一替换为 https://oss.yourdomain.com/uploads/...，最省事的做法是在数据库层做一次批量替换：UPDATE 表名 SET 字段名 = REPLACE(字段名, '/uploads/', 'https://oss.yourdomain.com/uploads/');，执行前先 SELECT 确认影响行数并备份。
• 私有 Bucket：如果不开公共读，就要在输出时用 SDK 生成签名 URL，默认有效期 3600 秒，过期链接会返回 403。

配置完附件打不开、图片 403 怎么排查？

结论：按"域名解析 → 权限 → 防盗链 → CORS"的顺序查，八成问题在防盗链。

常见原因：Bucket 读写权限是"私有"但代码没生成签名 URL；防盗链 Referer 白名单没加 *.你的域名；绑定的自定义域名没解析或没备案；CDN 回源地址填的是外网 Endpoint 导致回源失败。

另外提醒一个成本坑：Bucket 存储类型选"低频访问"时，最短存储周期是 30 天，提前删除要补收费用，附件频繁替换的站点建议直接用标准存储。

历史附件怎么迁？

结论：迁移要用官方工具做增量同步，不要手动拖文件。

用 ossutil 命令：ossutil cp -r ./uploads oss://你的bucket/uploads --update，--update 表示只传比目标新的文件，适合先全量再增量。迁完后先在测试环境跑一遍改路径的 SQL，确认图片、视频、下载附件三类都能打开，再对生产库执行。

归纳一下：海洋CMS 对接 OSS 的完整链路是"确认有无内置开关 → 配好 Bucket/AK/CORS/自定义域名 → 改写上传与读取两处代码 → 数据库批量替换路径 → ossutil 同步历史文件"。四步里任何一步省掉，都会在上线当天暴露成图片 404 或 403。