Zsens Admin后台框架 宝塔面板详细安装部署教程
教程适用：Linux服务器、宝塔面板、Zsens Admin官方后台框架
部署方式：源码上传 + 宝塔站点配置 + 在线Install安装
运行框架：基于ThinkPHP内核，严格按照ThinkPHP运行目录与伪静态规则配置
---
一、安装环境前置要求
为保证Zsens Admin框架正常运行、无报错、功能完整，服务器需满足以下基础环境：
- 系统：CentOS 7+/Ubuntu 20.04+/Debian 11+（Linux系统）
- PHP版本：PHP8.2–PHP8.5（推荐PHP8.5，兼容框架全部功能）
- 数据库：MySQL5.7 / MySQL8.0
- 环境软件：Nginx、PHP、MySQL、fileinfo、curl、openssl扩展
- 必备权限：网站目录读写权限、伪静态开启、防跨站关闭（按需）
未安装宝塔环境的用户，先在服务器SSH终端安装宝塔面板，安装完成后进入面板安装对应PHP、MySQL、Nginx环境即可。
---
二、第一步：源码上传至网站根目录
1、下载最新版 Zsens Admin官方源码包（请使用官方原版，杜绝盗版修改包）。
2、登录宝塔面板，进入【网站】-【对应站点根目录】。
3、删除站点默认的index.html等自带文件，保证根目录纯净。
4、将Zsens Admin源码压缩包直接上传至网站根目录，不要新建子目录上传。
5、上传完成后，解压压缩包，确保 public、app、config、install 等核心文件夹均在网站根目录，而非二级目录。
重点注意：源码必须放在站点根目录，放子目录会导致运行目录报错、安装页面404、后台无法访问。
---
三、第二步：宝塔新建/配置站点（核心设置）
1、宝塔面板点击【网站】-【添加站点】。
2、输入你的绑定域名（已备案域名，解析至服务器IP）。
3、选择PHP版本（对应环境要求的PHP7.4/8.0版本）。
4、创建数据库（MySQL5.7/8.0，记住数据库名、账号、密码，后续安装必填）。
5、关键配置：运行目录设置为 public
站点创建成功后，进入【站点设置】-【网站目录】，将运行目录修改为 /public，保存设置。
作用：ThinkPHP框架必须指定public为入口目录，可防止源码泄露、路径报错、安装失败。
---
四、第三步：配置ThinkPHP伪静态（必做）
本框架基于ThinkPHP内核，必须配置对应伪静态，否则首页正常、后台404、链接失效。
1、站点设置页面找到【伪静态】选项。
2、伪静态规则下拉选择：ThinkPHP（宝塔自带官方规则，无需手动编写）。
3、点击【保存】，系统自动生成伪静态配置文件。
无伪静态后果：安装完成后后台空白、访问路由报错、功能无法正常使用。
---
五、第四步：目录权限优化（避免安装报错）
为防止读写权限不足导致安装失败、缓存无法写入、配置保存失败，需设置权限：
1、网站根目录及所有子目录权限设置为 755。
2、文件权限设置为 644。
3、宝塔关闭站点【防跨站攻击】（部分服务器开启后会拦截install安装程序）。
4、确保PHP禁用函数已删除 putenv、proc_open、symlink 等框架所需函数。
---
六、第五步：在线访问安装程序
所有配置完成、保存生效后，开始在线安装程序：
1、浏览器访问域名：https://你的域名/install 或 http://你的域名/install。
2、进入Zsens Admin官方安装界面，首先进行环境检测。
3、确保所有环境、扩展、权限均显示✅通过，有红色报错需对应修复后再下一步。
4、阅读并同意协议，点击下一步，填写数据库信息（宝塔新建站点时生成的数据库名、账号、密码）。
5、设置后台管理员账号、密码、邮箱（务必牢记，用于后续登录后台）。
6、确认信息无误，点击【开始安装】，等待数据库自动导入、程序初始化完成。
7、安装成功后，会提示安装完成，可直接跳转后台登录页面。
---
七、安装后安全收尾（必做）
1、安装完成后，删除根目录install安装文件夹，防止恶意重复安装覆盖数据。
2、修改后台默认登录地址，开启登录验证码、登录防护。
3、定期备份网站源码与数据库，避免数据丢失。
---
八、常见安装报错与解决方案
- 访问/install 404：未设置public运行目录 / 伪静态未配置 / 源码上传至子目录
- 环境检测不通过：PHP版本不符、缺少fileinfo/curl扩展、禁用函数未解除
- 数据库连接失败：数据库账号密码填写错误、数据库未创建、IP未授权
- 权限不足写入失败：目录权限过低、开启防跨站攻击，关闭即可
- 安装卡顿空白：服务器PHP超时时间过短，宝塔调整PHP执行超时时间
---
九、教程总结（快速复盘）
1、源码上传网站根目录并解压；
2、宝塔添加站点，绑定域名、创建数据库；
3、设置站点运行目录为public；
4、伪静态选择ThinkPHP规则并保存；
5、优化目录权限、修复环境扩展；
6、浏览器访问 域名/install 完成在线安装。
