宝塔伪静态配置本质是手动编写Nginx的location与rewrite规则;WordPress需确保root路径一致且location /中含try_files $uri $uri/ /index.php?$args;,Typecho等程序推荐用try_files替代if,ThinkPHP需关闭fastcgi_split_path_info,Laravel则需保留;保存后须重载配置、执行nginx -t验证语法,并检查防跨站设置。

宝塔面板里配伪静态,本质就是往 Nginx 配置里加 location 块和 rewrite 规则——不是点点按钮就完事,填错一行就 404 或跳转循环。
WordPress 的 rewrite 规则为什么总 404?
宝塔默认的 WordPress 伪静态模板本身没问题,但实际失效常因两个硬伤:root 路径没对齐、或 location / 块里漏了 try_files。Nginx 不像 Apache 有 .htaccess 自动兜底,它必须明确告诉“找不到文件时去哪找入口”。
- 确认站点根目录路径和 Nginx 配置里的
root值完全一致(比如/www/wwwroot/your-site),大小写、末尾斜杠都不能差 - 在
location /块内必须有这行:try_files $uri $uri/ /index.php?$args;,缺了它,所有带参数的链接(如分类页、搜索)全挂 - 别把规则塞进
server块顶层——必须包在location /或独立的location ~ \.php$外层,否则优先级错乱
Typecho / Halo / Z-BlogPHP 的 rewrite 怎么写才不跳首页?
这类 PHP 博客程序依赖 index.php 统一入口,但重写规则稍有偏差就会强制跳回 /。核心是让非静态资源全部交由 index.php 解析,同时放行真实存在的文件(CSS/JS/图片)。
- 通用安全写法:
if (!-e $request_filename) { rewrite ^(.*)$ /index.php$1 last; }—— 注意是$1不是$2,括号只捕获一次 - 更推荐用
try_files替代if(Nginx 官方不建议在server级用if):try_files $uri $uri/ /index.php?$uri&$args; - 务必检查程序是否启用「固定链接」功能——Typecho 要在后台开启,Z-BlogPHP 要在「网站设置 → URL 地址格式」里选「静态化」,否则规则生效也没用
ThinkPHP/Laravel 的 PATH_INFO 模式怎么适配宝塔?
这些框架默认走 index.php/xxx 路径,但宝塔新建站点时若选了「Laravel」模板,会自动加 fastcgi_split_path_info,而 ThinkPHP 5.1+ 反而需要关掉它,否则 $_SERVER['PATH_INFO'] 为空。
- Laravel:保留宝塔自动生成的
location ~ \.php$块,重点确认里面有fastcgi_split_path_info ^(.+\.php)(/.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info; - ThinkPHP:删掉上面两行,改用
fastcgi_param PATH_INFO $request_uri;(或按 TP 文档用fastcgi_param PATH_INFO $path_info;,需配合set $path_info "";提前定义) - 所有框架都得确保
index.php在root下真实存在,且 Nginx 用户(通常是www)有读取权限,否则直接 500
伪静态保存后不生效?先查这三处
改完规则点保存,页面还是 404,大概率不是规则写错,而是配置没加载或被覆盖。
- 看宝塔右上角「重载配置」按钮有没有变灰——没变灰说明还没点,点了才真正写入
/www/server/panel/vhost/nginx/xxx.conf - 用命令行验证语法:
nginx -t,报错会直接指出哪行、哪个文件有问题,比瞎猜快十倍 - 检查是否启用了「防跨站攻击」:宝塔站点设置里如果开了,会自动加
php_admin_value open_basedir,可能把index.php所在路径拦在外面,临时关闭测试下
规则生效的前提,是 Nginx 认得清请求该进哪个 server 块、哪个 location 块——路径匹配顺序、正则贪婪性、last/break 的跳转逻辑,随便一个细节不对,流量就拐去别处了。别迷信模板,每次改完拿 curl -I 实测几个典型 URL 最靠谱。


















