宝塔面板二级目录配置教程详解

本文详细讲解了如何在宝塔面板已有的主域名网站下，通过二级目录（如 example.com/blog 或 example.com/api）安全、独立地部署另一套程序——无论是 Node.js 服务还是 WordPress/Laravel 等 PHP 应用，都提供了精准适配的配置方案：针对动态服务推荐反向代理并透传关键请求头，针对 PHP 程序则通过伪静态重写、入口文件路径修正和运行目录隔离实现彻底解耦；同时涵盖 SSL 继承与 HTTPS 正确识别、Cookie 作用域控制及多维度验证方法，确保子目录应用真正“独立运行、互不干扰”，是运维人员和开发者绕过宝塔默认限制、高效拓展站点功能的实用指南。

如果您希望在宝塔面板已有的主域名网站下，通过二级目录（如 example.com/blog 或 example.com/api）部署一套独立运行的程序（如 WordPress、ThinkPHP、Node.js 服务等），需绕过默认的根目录继承逻辑，实现子目录级独立运行环境。以下是具体配置步骤：

一、创建独立子目录并上传程序文件

为避免与主站程序冲突，需在网站根目录下新建专用子目录，并将目标程序完整上传至该目录，确保其具备独立入口文件（如 index.php、server.js 等）和可执行权限。

1、登录宝塔面板，进入【网站】页面，点击对应主站右侧的【根目录】按钮，打开文件管理器。

2、在根目录中点击【新建目录】，输入子目录名称（如 blog、api、admin），注意名称须全部小写、无空格及特殊字符。

3、进入该新建目录，点击【上传】，将已准备好的独立程序压缩包拖入并解压，或逐个上传源文件。

4、选中上传后的程序文件，右键【权限】，设置目录权限为 755，文件权限为 644；若含 runtime、storage、logs 等可写目录，单独设为 755 或 775。

二、配置子目录为独立应用（反向代理方式）

适用于需完全隔离运行环境的程序（如 Node.js、Python Flask、Java Spring Boot），通过 Nginx 反向代理将子目录请求转发至本地指定端口，不依赖主站 PHP/Python 运行环境。

1、在宝塔面板【网站】列表中，点击主站右侧【设置】→【反向代理】→【添加反向代理】。

2、代理名称填写子目录标识（如 blog-proxy）；目标URL填写 http://127.0.0.1:3000（替换为您的程序实际监听地址与端口）。

3、在【发送域名】栏填写 $host；勾选【启用代理】后，点击【提交】。

4、返回【配置文件】选项卡，在 location /blog {…} 块内手动插入以下规则（将 blog 替换为您的子目录名）：
proxy_set_header X-Forwarded-Prefix /blog;
proxy_set_header X-Original-URI $request_uri;

三、配置子目录为独立PHP站点（伪静态+入口隔离）

适用于 WordPress、Laravel、Typecho 等 PHP 程序，需屏蔽主站 rewrite 规则影响，启用子目录专属路由解析，并确保 index.php 能正确识别子目录路径。

1、进入主站【设置】→【网站目录】，将【运行目录】修改为 /blog（与子目录名一致），点击【保存】。

2、切换至【伪静态】选项卡，清空原有规则，粘贴对应程序的子目录适配版伪静态规则（以 Laravel 为例）：
if (!-d $request_filename && !-f $request_filename){
  rewrite ^/blog/(.*)$ /blog/index.php?$1 last;
}

3、打开子目录下的 index.php，查找 define('APP_PATH', __DIR__ . '/application/'); 类似语句，在其上方添加：
$_SERVER['SCRIPT_NAME'] = '/blog/index.php';
$_SERVER['SCRIPT_FILENAME'] = __DIR__ . '/index.php';

四、配置子目录SSL与强制HTTPS访问

当主站已启用 HTTPS 时，子目录默认继承证书，但需确保反向代理或 PHP 程序能正确识别 HTTPS 协议头，避免混合内容或跳转异常。

1、进入主站【SSL】页面，确认已成功部署有效证书，并勾选【强制HTTPS】。

2、若使用反向代理，需在代理配置中追加：
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Ssl on;

3、对于 PHP 程序，在子目录入口文件（如 index.php）顶部添加：
if ($_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
  $_SERVER['HTTPS'] = 'on';
}

五、验证子目录程序独立性与路径兼容性

完成配置后，必须验证子目录是否真正脱离主站上下文运行，包括资源加载路径、Cookie 作用域、Session 隔离及动态链接生成是否正确指向子目录前缀。

1、访问 https://example.com/blog（替换为您的域名和子目录名），观察页面是否完整加载，无 404 或空白。

2、打开浏览器开发者工具 → 【Network】，刷新页面，检查所有 JS/CSS 请求 URL 是否均以 /blog/ 开头，且状态码为 200。

3、点击页面内任意内部链接，确认跳转地址仍保留在 /blog/ 下，未跳转至根目录或出现重复 /blog/blog/ 路径。

4、提交表单或执行登录操作，检查 Cookie 的 Path 字段是否为 /blog/，而非 /，确保与主站 Session 不互通。

今天关于《宝塔面板二级目录配置教程详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！