CMS伪静态设置完整教程：零基础也能轻松上手

CMS 伪静态设置完整教程：零基础也能轻松上手

伪静态本质：URL 重写，把带index.php?id=123这种动态地址，转为/article/123.html简洁链接，利于 SEO，提升 URL 可读性;并不是生成真实静态 HTML 文件。核心一句话：分两步，服务器写重写规则 + CMS 后台开启伪静态，两步缺一不可，只改后台会直接 404。

        一、前置准备(新手必看)

确认服务器环境：Nginx / Apache / IIS(宝塔面板最常用，新手优先宝塔)

确认你的 CMS：WordPress、PbootCMS、迅睿、易优、织梦、帝国等，不同 CMS 官方自带对应伪静态代码，优先用官方规则

网站目录：找到网站根目录(public/wwwroot/ 域名文件夹)

重要提醒：操作前备份网站 + 数据库，防止配置出错导致网站打不开

二、方案 A：宝塔面板(推荐零基础，最简单)

步骤 1：进入网站伪静态设置

登录宝塔 → 网站 → 找到你的域名 → 【设置】→【伪静态】

步骤 2：选择对应 CMS 模板(优先)

下拉菜单，直接选择你的 CMS 名称(WordPress/PbootCMS/ 易优 EyouCMS / 迅睿等)，点击保存。宝塔自动写入对应规则，无需手动复制代码。

如果下拉列表没有你的 CMS，切换到【自定义】，粘贴 CMS 官网给的伪静态代码，保存。

步骤 3：进入 CMS 后台开启伪静态(最容易漏掉)

登录 CMS 后台，找到：系统设置 / URL 设置 / SEO 设置，打开伪静态开关，选择不带 index.php 的 URL 格式，保存。

很多人只在宝塔配置，后台没开伪静态，访问直接 404!

步骤 4：测试验证

清除浏览器缓存，打开文章页，看 URL 是否不再出现index.php?。 ✅ 成功：页面正常打开，链接简洁;❌ 404：规则不对、后台没开启、PHP PATHINFO 未开启。

三、方案 B：三大服务器手动伪静态规则(无宝塔面板用)

注意：下面是通用 PHP CMS 基础规则，优先去你 CMS 官网复制专属规则，不同程序规则有差异!

1、Nginx 环境(Linux 服务器最常用)

编辑站点 nginx 配置文件，在server{}内部添加：

location / {

if (!-e $request_filename) {

rewrite ^(.*)$ /index.php?s=$1 last;

break;

}

}

保存，重载 Nginx(nginx -t先检测语法，无误再重载)

二级目录部署网站：修改rewrite ^/cms/(.*)$ /cms/index.php?s=$1 last;

2、Apache 环境(虚拟主机常用，.htaccess)

在网站根目录新建.htaccess文件(注意文件名前面带点，Windows 新建容易隐藏后缀)，写入：

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]

上传到网站根目录;必须开启 rewrite 模块，否则.htaccess 无效。

3、IIS 环境(Windows 服务器)

根目录新建web.config文件，写入 rewrite 规则：

前提：服务器安装 IIS URL Rewrite 组件，虚拟主机一般服务商已预装。

四、通用排错(90% 新手踩坑问题)

❌ 问题 1：配置伪静态后，页面 404

排查顺序：

CMS 后台有没有开启伪静态开关(最高发!)

服务器重写模块是否启用：Apache rewrite / Nginx rewrite /IIS rewrite 组件

伪静态规则和 CMS 不匹配(不要混用 WordPress 规则给 PbootCMS)

网站部署在二级子目录，规则没有修改目录路径

Nginx 需要开启 PATHINFO，否则路径参数无法传递

❌ 问题 2：首页正常，内页 404

大概率：PATHINFO 没开启，或者伪静态规则缺少参数传递，检查 Nginx PHP 配置。

❌ 问题 3：静态资源(图片 /css/js)打不开

规则错误，正确规则会跳过真实存在的文件、文件夹，不对图片、静态文件做重写;删除错误规则，替换官方原版伪静态代码。

❌ 问题 4：后台打不开

部分 CMS 后台需要排除重写，在伪静态规则增加后台目录排除，或者直接用原动态地址访问后台。

五、重要注意事项

虚拟主机用户：无法修改 Nginx/Apache 主配置，Apache 上传.htaccess;IIS 上传 web.config即可;部分主机商禁用 rewrite，需要联系空间商开启。

更换 CMS、迁移服务器：伪静态规则要跟着环境更换，Nginx 规则不能直接给 Apache 使用。

伪静态不适合超大高并发网站：大量 URL 重写会轻微消耗服务器 CPU;高流量站点可搭配页面静态缓存。

上线前：测试全部栏目、文章、分页、TAG 标签链接，避免死链影响 SEO。

旧网站升级伪静态：一定要做 301 重定向，把旧动态链接 301 跳转新伪静态链接，防止收录丢失。

六、最简操作总结

备份网站

服务器添加对应 CMS 伪静态规则(宝塔一键模板优先)

CMS 后台开启伪静态，保存 URL 配置

清除缓存，测试所有页面链接

旧链接做 301 重定向保护收录