WordPress + AList 双系统 CDN 缓存终极配置指南教程

WordPress + AList 双系统 CDN 缓存终极配置指南

宝塔+Nginx+阔彩聚合(金山云)实战优化 | 图片视频缓存365天,动态接口零污染

适用对象:使用 宝塔 + Nginx 搭建 WordPress 或 AList,并通过 阔彩聚合接入金山云 CDN 的用户。
目标效果:静态资源高速缓存,动态页面实时响应,网站与文件站共存不冲突。

前言:为什么需要精准的 CDN 缓存规则?

很多站长在使用 CDN 加速 时,常常陷入两个极端:

  • ❌ 全局缓存 → 导致登录失败、评论无效、AList 下载链接过期
  • ❌ 完全不缓存 → 浪费了 CDN 的加速能力,图片视频加载缓慢

本文将为你提供一套 经过实战验证的双系统缓存方案,分别针对:

  1. WordPress 子比主题站点
  2. AList / OpenList 文件管理系统

确保:

  • 图片、视频等静态资源被 CDN 长期缓存(365天)
  • 所有动态接口(如登录、评论、API、下载跳转)绝不缓存
  • 支持未来接入百度网盘、迅雷、夸克等多种存储源
  • 适用于 阔彩聚合 + 金山云 CDN 节点

一、环境说明

组件 版本/类型
服务器管理 宝塔面板(最新版)
Web 服务 Nginx(非 Apache)
网站程序 WordPress + 子比主题(Zibll)
文件系统 AList / OpenList(v3/v4 均适用)
CDN 服务 阔彩聚合 → 金山云 CDN 节点

⚠️ 注意:本文方案基于 Nginx 架构设计,.htaccess 文件在此环境下无效!

二、核心原则

资源类型 是否缓存 建议缓存时间
.jpg, .png, .webp 等图片 ✅ 是 365天
.mp4, .mkv, .webm 等视频 ✅ 是 365天
.css, .js, 字体文件 ✅ 是 30~180天
文章页、首页、PHP 页面 ❌ 否 不缓存
/wp-login.php, /admin-ajax.php ❌ 否 不缓存
AList 的 /api/*, /d/*, /fs/* 接口 ❌ 否 不缓存

✅ 规则顺序至关重要:先匹配静态资源,再排除动态路径,最后兜底不缓存根目录。

三、方案一:WordPress 子比主题 CDN 规则

适用于你的主站,目标是:只缓存媒体库中的图片与视频,其他全部不缓存

CDN 缓存规则(请在阔彩或金山云后台添加)

类型 内容 缓存时间 是否缓存
文件后缀 jpg,jpeg,png,gif,bmp,tiff,webp,svg,ico,heic,avif 365天
文件后缀 mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts,mpeg 365天
路径 /wp-admin/* 不缓存
路径 /wp-login.php* 不缓存
路径 /wp-comments-post.php* 不缓存
路径 /wp-cron.php* 不缓存
路径 /xmlrpc.php* 不缓存
路径 /wp-admin/admin-ajax.php* 不缓存
路径 /* 不缓存

💡 提示/* 为兜底规则,确保所有未明确列出的请求均不被缓存。

四、方案二:AList / OpenList 专用 CDN 规则

适用于你挂载百度网盘、迅雷、夸克等资源的文件门户系统,目标是:缓存封面图与预览视频,但绝不缓存任何动态接口

CDN 缓存规则(独立设置或共用域名下按路径区分)

类型 内容 缓存时间 是否缓存
文件后缀 jpg,jpeg,png,gif,webp,avif,bmp,svg 365天
文件后缀 mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts 365天
文件后缀 css,js 30天
文件后缀 woff2,woff,ttf,eot 180天
路径 /api/* 不缓存
路径 /d/* 不缓存
路径 /raw/* 不缓存
路径 /list/* 不缓存
路径 /dl/* 不缓存
路径 /search* 不缓存
路径 /login* 不缓存
路径 /register* 不缓存
路径 /logout* 不缓存
路径 /fs/* 不缓存
路径 /admin/* 不缓存
路径 / 不缓存

✅ 此规则兼容 AList v3/v4 及所有网盘类型(本地/百度/迅雷/夸克/阿里云盘等)。

五、源站 Nginx 配置(宝塔面板操作)

由于你使用的是 Nginx.htaccess 无效。必须手动在配置文件中添加缓存头,帮助 CDN 正确识别可缓存资源。

操作步骤:

  1. 登录宝塔面板
  2. 进入【网站】→ 选择你的站点 →【设置】→【配置文件】
  3. server { ... } 区域内,找到 include enable-php.conf; 这一行
  4. 在其下方插入以下代码:
# === 静态资源缓存策略 ===
# 图片、视频长期缓存
location ~* \.(jpg|jpeg|png|gif|webp|avif|bmp|svg|mp4|mkv|webm|mov)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

# CSS、JS 缓存1个月
location ~* \.(css|js)$ {
    expires 1M;
    add_header Cache-Control "public";
}

# 字体文件缓存半年
location ~* \.(woff2|woff|ttf|eot)$ {
    expires 6M;
    add_header Cache-Control "public";
}
  1. 点击【保存】
  2. 返回宝塔首页 → 重启 Nginx(建议“平滑重启”)

✅ 完成后,静态资源将携带 Cache-Control: public, immutable 头,极大提升 CDN 缓存命中率。

六、给阔彩客服的标准沟通模板(直接复制发送)

如果你无法自行配置 CDN 规则,可将以下内容发给阔彩技术支持:

你好,我是用户 [你的账号],域名是 yourdomain.com,请帮我配置金山云 CDN 缓存规则如下:

允许缓存的文件类型(开启缓存)
- 图片:jpg,jpeg,png,gif,webp,avif,bmp,svg,ico
- 视频:mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts,mpeg
- 其他:css(30天), js(30天), woff2/ttf(180天)

禁止缓存的路径(全部设为“不缓存”)
/wp-admin/*
/wp-login.php*
/wp-comments-post.php*
/wp-cron.php*
/xmlrpc.php*
/wp-admin/admin-ajax.php*
/api/*
/d/*
/raw/*
/list/*
/dl/*
/search*
/login*
/register*
/logout*
/fs/*
/admin/*
/*

请确保规则顺序正确,静态资源在前,动态路径在后。谢谢!

七、如何验证配置是否生效?

方法 1:浏览器开发者工具(F12)

  • 访问一张图片或视频
  • 查看 Network 标签页,响应头应包含:
    Cache-Control: public, immutable
    Age: 1000+ (表示已被 CDN 缓存)
    X-Cache: HIT from jscdn

方法 2:在线 CDN 检测工具

方法 3:清除缓存测试

  • 修改一篇文章内容
  • 刷新页面,确认能立即看到更新(说明动态页未被缓存)

结语:让 CDN 真正为你所用

本文提供的两套方案,已在实际部署中验证稳定运行。它不仅解决了“缓存导致功能异常”的痛点,还充分发挥了 CDN 在静态资源加速上的优势。

无论你是个人博客站长,还是搭建了 AList 文件门户的技术爱好者,这套配置都能让你的网站体验更上一层楼。

📌 建议收藏本文,未来迁移或重装时可快速复用。

💬 欢迎在评论区留言交流使用心得,或提出优化建议。我们一起打造更高效的网络环境!

作者:点了不玩了 / 发表于Acg小栈(www.mhyyun.cn)
发布时间:2025年11月7日
分类

WordPress + AList 双系统 CDN 缓存终极配置指南

宝塔+Nginx+阔彩聚合(金山云)实战优化 | 图片视频缓存365天,动态接口零污染

适用对象:使用 宝塔 + Nginx 搭建 WordPress 或 AList,并通过 阔彩聚合接入金山云 CDN 的用户。
目标效果:静态资源高速缓存,动态页面实时响应,网站与文件站共存不冲突。

前言:为什么需要精准的 CDN 缓存规则?

很多站长在使用 CDN 加速 时,常常陷入两个极端:

  • ❌ 全局缓存 → 导致登录失败、评论无效、AList 下载链接过期
  • ❌ 完全不缓存 → 浪费了 CDN 的加速能力,图片视频加载缓慢

本文将为你提供一套 经过实战验证的双系统缓存方案,分别针对:

  1. WordPress 子比主题站点
  2. AList / OpenList 文件管理系统

确保:

  • 图片、视频等静态资源被 CDN 长期缓存(365天)
  • 所有动态接口(如登录、评论、API、下载跳转)绝不缓存
  • 支持未来接入百度网盘、迅雷、夸克等多种存储源
  • 适用于 阔彩聚合 + 金山云 CDN 节点

一、环境说明

组件 版本/类型
服务器管理 宝塔面板(最新版)
Web 服务 Nginx(非 Apache)
网站程序 WordPress + 子比主题(Zibll)
文件系统 AList / OpenList(v3/v4 均适用)
CDN 服务 阔彩聚合 → 金山云 CDN 节点

⚠️ 注意:本文方案基于 Nginx 架构设计,.htaccess 文件在此环境下无效!

二、核心原则

资源类型 是否缓存 建议缓存时间
.jpg, .png, .webp 等图片 ✅ 是 365天
.mp4, .mkv, .webm 等视频 ✅ 是 365天
.css, .js, 字体文件 ✅ 是 30~180天
文章页、首页、PHP 页面 ❌ 否 不缓存
/wp-login.php, /admin-ajax.php ❌ 否 不缓存
AList 的 /api/*, /d/*, /fs/* 接口 ❌ 否 不缓存

✅ 规则顺序至关重要:先匹配静态资源,再排除动态路径,最后兜底不缓存根目录。

三、方案一:WordPress 子比主题 CDN 规则

适用于你的主站,目标是:只缓存媒体库中的图片与视频,其他全部不缓存

CDN 缓存规则(请在阔彩或金山云后台添加)

类型 内容 缓存时间 是否缓存
文件后缀 jpg,jpeg,png,gif,bmp,tiff,webp,svg,ico,heic,avif 365天
文件后缀 mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts,mpeg 365天
路径 /wp-admin/* 不缓存
路径 /wp-login.php* 不缓存
路径 /wp-comments-post.php* 不缓存
路径 /wp-cron.php* 不缓存
路径 /xmlrpc.php* 不缓存
路径 /wp-admin/admin-ajax.php* 不缓存
路径 /* 不缓存

💡 提示/* 为兜底规则,确保所有未明确列出的请求均不被缓存。

四、方案二:AList / OpenList 专用 CDN 规则

适用于你挂载百度网盘、迅雷、夸克等资源的文件门户系统,目标是:缓存封面图与预览视频,但绝不缓存任何动态接口

CDN 缓存规则(独立设置或共用域名下按路径区分)

类型 内容 缓存时间 是否缓存
文件后缀 jpg,jpeg,png,gif,webp,avif,bmp,svg 365天
文件后缀 mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts 365天
文件后缀 css,js 30天
文件后缀 woff2,woff,ttf,eot 180天
路径 /api/* 不缓存
路径 /d/* 不缓存
路径 /raw/* 不缓存
路径 /list/* 不缓存
路径 /dl/* 不缓存
路径 /search* 不缓存
路径 /login* 不缓存
路径 /register* 不缓存
路径 /logout* 不缓存
路径 /fs/* 不缓存
路径 /admin/* 不缓存
路径 / 不缓存

✅ 此规则兼容 AList v3/v4 及所有网盘类型(本地/百度/迅雷/夸克/阿里云盘等)。

五、源站 Nginx 配置(宝塔面板操作)

由于你使用的是 Nginx.htaccess 无效。必须手动在配置文件中添加缓存头,帮助 CDN 正确识别可缓存资源。

操作步骤:

  1. 登录宝塔面板
  2. 进入【网站】→ 选择你的站点 →【设置】→【配置文件】
  3. server { ... } 区域内,找到 include enable-php.conf; 这一行
  4. 在其下方插入以下代码:
# === 静态资源缓存策略 ===
# 图片、视频长期缓存
location ~* \.(jpg|jpeg|png|gif|webp|avif|bmp|svg|mp4|mkv|webm|mov)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

# CSS、JS 缓存1个月
location ~* \.(css|js)$ {
    expires 1M;
    add_header Cache-Control "public";
}

# 字体文件缓存半年
location ~* \.(woff2|woff|ttf|eot)$ {
    expires 6M;
    add_header Cache-Control "public";
}
  1. 点击【保存】
  2. 返回宝塔首页 → 重启 Nginx(建议“平滑重启”)

✅ 完成后,静态资源将携带 Cache-Control: public, immutable 头,极大提升 CDN 缓存命中率。

六、给阔彩客服的标准沟通模板(直接复制发送)

如果你无法自行配置 CDN 规则,可将以下内容发给阔彩技术支持:

你好,我是用户 [你的账号],域名是 yourdomain.com,请帮我配置金山云 CDN 缓存规则如下:

允许缓存的文件类型(开启缓存)
- 图片:jpg,jpeg,png,gif,webp,avif,bmp,svg,ico
- 视频:mp4,mkv,avi,wmv,flv,webm,mov,m4v,3gp,ts,mpeg
- 其他:css(30天), js(30天), woff2/ttf(180天)

禁止缓存的路径(全部设为“不缓存”)
/wp-admin/*
/wp-login.php*
/wp-comments-post.php*
/wp-cron.php*
/xmlrpc.php*
/wp-admin/admin-ajax.php*
/api/*
/d/*
/raw/*
/list/*
/dl/*
/search*
/login*
/register*
/logout*
/fs/*
/admin/*
/*

请确保规则顺序正确,静态资源在前,动态路径在后。谢谢!

七、如何验证配置是否生效?

方法 1:浏览器开发者工具(F12)

  • 访问一张图片或视频
  • 查看 Network 标签页,响应头应包含:
    Cache-Control: public, immutable
    Age: 1000+ (表示已被 CDN 缓存)
    X-Cache: HIT from jscdn

方法 2:在线 CDN 检测工具

方法 3:清除缓存测试

  • 修改一篇文章内容
  • 刷新页面,确认能立即看到更新(说明动态页未被缓存)

结语:让 CDN 真正为你所用

本文提供的两套方案,已在实际部署中验证稳定运行。它不仅解决了“缓存导致功能异常”的痛点,还充分发挥了 CDN 在静态资源加速上的优势。

无论你是个人博客站长,还是搭建了 AList 文件门户的技术爱好者,这套配置都能让你的网站体验更上一层楼。

📌 建议收藏本文,未来迁移或重装时可快速复用。

💬 欢迎在评论区留言交流使用心得,或提出优化建议。我们一起打造更高效的网络环境!

作者:点了不玩了 / 初登于Acg小栈(www.mhyyun.cn)
发布时间:2025年11月7日
标签:#WordPress优化 #CDN配置 #AList教程 #子比主题 #宝塔面板 #通义千问 #Qwen3-Plus

感谢通义千问的大力支持

© 版权所有,转载请注明出处。技术因分享而更有价值。

© 版权所有,转载请注明出处。技术因分享而更有价值。

© 版权声明
THE END
喜欢就点个赞收藏一下吧
点赞5 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容