海洋CMS如何对接CDN加速？静态资源分发配置

海洋CMS对接CDN不用改程序代码，真正要做的只有三件事：把静态资源换到一个独立的加速域名上、在CDN按文件类型配置不同的缓存时长、把后台和动态HTML排除在缓存之外。做完这三步，源站带宽能压到原来的三成以下，首屏静态资源加载时间基本由CDN边缘节点决定。

海洋CMS对接CDN要改代码吗？

结论：不需要改PHP代码，只需要改CDN配置和模板里的资源引用域名。

海洋CMS的视频、图片、CSS、JS都是通过HTTP直接输出的文件，CDN只认URL路径和文件后缀，不关心你是PHP还是静态页。所以对接方式是「DNS + CDN控制台 + 模板替换」，程序侧零改动。

准备工作：一个源站域名（如 www.example.com，正常解析到源站IP）、一个全新的静态域名（如 static.example.com，只做CNAME到CDN，不解析到源站）。

静态域名和主站域名怎么分离？

结论：主站域名保持回源不缓存，静态域名全量走CDN，两个域名严格分开。

在CDN控制台新增加速域名 static.example.com，源站类型选「IP或域名」，源站地址填源站IP，回源Host填 www.example.com——这一步最关键，回源Host填错，Nginx会匹配不到虚拟主机，返回404或默认站点。

然后在源站Nginx里给静态资源加响应头，让CDN和浏览器都按你的规则缓存：

location ~* \.(css|js|png|jpg|jpeg|gif|webp|svg|ico|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, max-age=2592000";
}
location ~* \.m3u8$ { add_header Cache-Control "public, max-age=300"; }
location ~* \.ts$   { add_header Cache-Control "public, max-age=604800"; }

海洋CMS的静态资源主要集中在模板目录（如 /template/default/）和上传目录，这两类路径都要命中上面的规则。

CDN缓存规则怎么配？

结论：按后缀分档缓存，HTML不缓存、切片长缓存、播放列表短缓存。

具体参数：

• .html、.php、后台目录（海洋CMS后台默认是 /admin/）：缓存时间设为0，强制回源，否则登录状态和后台数据会被缓存污染。
• .css/.js/.jpg/.png/.webp/.svg/.woff2：缓存2592000秒（30天）。
• .m3u8 播放列表：缓存300秒（5分钟），因为切片列表会更新。
• .ts 视频切片：缓存604800秒（7天），这是省带宽的大头。

同时开启「忽略URL参数缓存」要谨慎——海洋CMS的部分静态资源带版本号参数（如 ?v=20240101），忽略参数能显著提升命中率，但如果参数参与内容区分就不能忽略。

海洋CMS模板里的静态资源域名怎么批量替换？

结论：用一条sed命令把模板目录下的绝对路径换成CDN域名，改完清一次模板缓存。

海洋CMS模板中资源引用形如 /template/default/css/style.css，在服务器上执行：

cd /www/wwwroot/你的站点
sed -i 's#href="/template/#href="https://static.example.com/template/#g' template/default/*.html
sed -i 's#src="/template/#src="https://static.example.com/template/#g' template/default/*.html

改完后进入后台清理一次缓存，并强制刷新CDN缓存（提交URL刷新或目录刷新 /template/）。

注意：后台「网站域名」设置仍填主站域名 www.example.com，不要把CDN域名填进去，否则生成的链接和管理入口都会乱。

哪些坑最容易踩？

结论：九成故障出在后台被缓存、HTTPS混合内容和防盗链三处。

第一，后台被缓存：务必在CDN把 /admin/ 目录加入「不缓存」名单，否则会出现登录后跳回登录页。

第二，HTTPS混合内容：主站是HTTPS时，CDN域名也必须配证书并开启HTTPS，模板里所有 http:// 引用要改成 https://，否则浏览器直接拦截资源。

第三，防盗链：视频切片走CDN后要配Referer白名单（填你的主站域名）和URL鉴权，否则流量会被盗刷。

第四，CNAME生效后再测试，用 curl -I https://static.example.com/template/default/css/style.css 检查返回头里是否有 X-Cache: HIT 和正确的 Cache-Control。

整套流程走完，海洋CMS的静态资源和视频分发就完全交给CDN了，源站只承担HTML动态请求和回源穿透，成本结构会明显改善。