宝塔面板如何配置子目录绑定站点_修改Nginx配置规则

冬辰姑娘_1003

冬辰姑娘_1003

2026-03-25

760人浏览

原创

子目录绑定404的主因是nginx配置遗漏alias或root路径计算错误:必须用末尾带/的alias,加fastcgi_param script_filename $request_filename;,将location /subdir/块置于正则匹配之前,并透传https状态。

宝塔面板如何配置子目录绑定站点_修改nginx配置规则

子目录绑定后访问 404,Nginx 配置漏了 alias 或 root 路径计算

宝塔默认不支持直接“子目录绑定站点”,所谓绑定,本质是靠 Nginx 的 location + alias(或 root)把请求映射到另一个物理路径。很多人直接复制根站配置改路径,结果所有静态资源、PHP 脚本全 404——因为 alias 和 root 对 URI 的处理逻辑完全不同。

正确做法是:用 alias,且末尾必须带 /,URI 中的路径前缀会被完全剥离,剩余部分拼到 alias 值后面;而 root 是把整个 URI 拼上去,极易多出一层目录。

  • 错误写法:alias /www/wwwroot/subsite/ → 实际访问 /subdir/index.php 会去找 /www/wwwroot/subsite/subdir/index.php
  • 正确写法:alias /www/wwwroot/subsite/ + location /subdir/ { ... } → 请求 /subdir/css/app.css 映射为 /www/wwwroot/subsite/css/app.css
  • PHP 支持必须加 fastcgi_param SCRIPT_FILENAME $request_filename;,否则 SCRIPT_FILENAME 仍按主站 root 解析,导致 No input file specified

PHP 子目录站点无法执行,SCRIPT_FILENAME 没重写

即使文件路径映射对了,PHP-FPM 仍可能报 No input file specified.。这是因为宝塔默认的 fastcgi_param SCRIPT_FILENAME 是基于 root 和 fastcgi_script_name 拼的,而用了 alias 后,这个拼接结果就错了。

必须显式覆盖该参数,让 PHP 知道真实文件在哪:

  • 在 location ~ \.php(.*)$ 块内,添加:fastcgi_param SCRIPT_FILENAME $request_filename;
  • 不能写成 $document_root$fastcgi_script_name —— 此时 $document_root 还是主站的,不是子目录的
  • 如果子目录里还要支持 PATH_INFO(如 ThinkPHP),得额外补上:fastcgi_param PATH_INFO $fastcgi_path_info;

静态资源 403 或 MIME 错误,location 优先级和正则顺序搞反了

宝塔自动生成的配置里,location ~ .*\.(js|css|png|jpg|gif|swf|ico|pdf|shtml|htm)$ 这类正则匹配通常写在最前面,它会优先于你写的 location /subdir/ 匹配。结果就是:所有 /subdir/xxx.js 请求被当成静态资源处理,但没走 alias,直接按主站 root 找文件,自然 403 或返回错误 MIME 类型。

Nginx Hosting
Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式,无需登录、无需令牌、无需用户操作。

下载

解决办法只有两个字:调序。

  • 把你的子目录 location /subdir/ { ... } 块,**挪到所有正则 location ~ 之前**
  • 或者改用更精确的前缀匹配:location ^~ /subdir/ { ... }(^~ 表示前缀匹配且优先于正则)
  • 避免用 location /subdir(无结尾斜杠)——它会匹配 /subdirectory,造成意外交叉

HTTPS 下子目录跳转回 HTTP,$_SERVER['HTTPS'] 判断失效

子目录站点里用 if ($_SERVER['HTTPS'] !== 'on') 强制跳转,结果死循环或跳错协议。这不是 PHP 问题,是 Nginx 没透传 HTTPS 状态。宝塔反向代理或 CDN(如 Cloudflare)后,真实请求是 HTTP,SSL 在前置层终止,PHP 拿不到 HTTPS=on。

必须由 Nginx 主动注入环境变量:

  • 在子目录 location 块内加:fastcgi_param HTTPS on;(仅当确定前端是 HTTPS 时)
  • 更稳妥的做法是检查 X-Forwarded-Proto:fastcgi_param HTTPS $http_x_forwarded_proto;
  • 同时确保主站配置里已开启「强制 HTTPS」并勾选「反向代理已处理 HTTPS」,否则宝塔会自动插入冲突的重定向规则

子目录绑定不是点点鼠标就能通的事,路径映射、PHP 入口、匹配优先级、协议透传,四个环节只要一个断掉,整个就挂。尤其 alias 的斜杠、SCRIPT_FILENAME 的重写、location 的顺序,这三个地方改完一定要 reload Nginx 并用 curl -I 看响应头和状态码,别只刷浏览器。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

40

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

140

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

140

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

100

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

100

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

120

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

320

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

220

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

180

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习