宝塔面板如何自定义面板默认模版?创建属于你自己的宝塔面板初始化环境

1次阅读

需修改宝塔面板默认站点模板:一、备份并解压 /www/server/panel/data/default.zip;二、在 default_template/ 中定制 index.php、robots.txt、.user.ini 等文件;三、用 zip -rj default.zip default_template/* 重新打包并覆盖原文件;四、执行 bt restart 后新建站点验证文件与内容是否生效。

宝塔面板如何自定义面板默认模版?创建属于你自己的宝塔面板初始化环境

如果您在安装宝塔面板后希望每次新建站点时自动应用统一的目录结构、默认文件、权限配置及预置脚本,则需修改面板的默认站点模板。以下是实现自定义宝塔面板初始化环境的具体操作步骤:

一、定位并备份原始默认模板文件

宝塔面板的默认站点模板存放于固定路径,直接编辑前需确保原始文件可回滚。该模板控制新建站点时自动生成的根目录内容(如 index.html、.htaccess 或 nginx.conf 片段等)。

1、通过 SSH 登录服务器,执行命令进入模板目录:
cd /www/server/panel/data/

2、确认是否存在 default.zip 文件:
ls -l default.zip

3、立即备份原始模板:
cp default.zip default.zip.bak

4、解压当前模板以便修改:
unzip default.zip -d default_template/

二、构建自定义初始化文件结构

您可按需在本地准备一套符合业务规范的初始文件体系,例如包含标准化的 README.md、统一的 favicon.ico、预设的 robots.txt、基础 PHP 入口文件及安全加固的 .user.ini 文件。所有文件将被压缩为新的 default.zip 替换原模板。

1、进入解压后的模板目录:
cd default_template/

2、删除默认生成的 index.html(若不需保留):
rm -f index.html

3、创建自定义首页文件:
echo “<h1> 欢迎使用 XX 公司标准初始化环境 </h1><p> 此站点已启用 PHP 8.1、OPcache 及防跨站配置。</p>” > index.php

4、写入标准化 robots.txt:
echo “User-agent: *nDisallow: /admin/nDisallow: /api/test/” > robots.txt

5、添加基础 .user.ini(适用于 PHP 站点):
echo “open_basedir=/www/wwwroot/your_domain/:/tmp/:/proc/” > .user.ini

三、重新打包并部署自定义模板

完成文件编辑后,必须将整个目录严格按原始压缩格式重新打包为 default.zip,并放置到指定位置,确保面板识别无误。压缩时不得携带父级目录,且需保持内部路径与原模板一致。

1、返回上一级目录:
cd ..

2、将 default_template 目录下所有内容压缩为 default.zip(关键:-j 参数去除路径层级):
zip -rj default.zip default_template/*

3、校验压缩包内容是否为扁平结构:
unzip -l default.zip | head -10

4、覆盖原模板文件:
cp default.zip /www/server/panel/data/default.zip

5、重启面板服务使模板生效:
bt restart

四、验证新模板是否生效

新建站点操作将触发模板解压逻辑,面板会自动将 default.zip 中的内容释放至新站点根目录。验证过程需排除缓存干扰,确保观察的是真实初始化结果。

1、登录宝塔面板,点击【网站】→【添加站点】

2、输入域名(如 test.yourdomain.com),其余选项保持默认

3、提交创建后,进入该站点根目录:
cd /www/wwwroot/test.yourdomain.com

4、检查关键文件是否存在:
ls -l index.php robots.txt .user.ini

5、访问该域名,确认浏览器显示内容与自定义 index.php 一致:
欢迎使用 XX 公司标准初始化环境

text=ZqhQzanResources