# 好站站企业建站引擎 - 宝塔源码部署文档
## 一、环境要求
| 项目 | 要求 |
|------|------|
| 操作系统 | CentOS 7+ / Ubuntu 18+ / Alibaba Cloud Linux |
| 宝塔面板 | 已安装（建议 7.0+） |
| PHP版本 | PHP 8.3+ |
| MySQL版本 | MySQL 5.7+ / 8.0 |
| 域名 | 已解析到服务器 IP |
---
## 二、创建站点
1. 宝塔面板 → **网站** → **添加站点**
2. 填写你的域名（如：`github.engine.haozhanzhan.com`）
3. PHP 版本选择 **PHP 8.3+**（如果没有，先在软件商店安装 PHP 8.3）
4. 点击 **提交**
记录网站根目录路径，例如：`/www/wwwroot/github.engine.haozhanzhan.com`
---
## 三、上传源码
### 3.1 下载源码包
从 GitHub 下载 `haozhanzhan-engine-main.zip`
### 3.2 上传并解压
1. 宝塔面板 → **文件**
2. 进入网站根目录（如：`/www/wwwroot/github.engine.haozhanzhan.com`）
3. 上传 `haozhanzhan-engine-main.zip`
4. 右键解压
5. 将解压后的 `haozhanzhan-engine-main` 文件夹内**所有文件**移动到根目录
6. 删除空文件夹和压缩包
---
## 四、设置网站目录
1. 宝塔面板 → **网站** → 找到你的站点 → 点击 **设置**
2. 点击 **网站目录**
3. 修改 **运行目录** 为 `/public`
4. 点击 **保存**
---
## 五、设置伪静态
1. 点击 **伪静态**
2. 选择 **Laravel**（或输入以下内容）：
```nginx
location / {
try_files $uri $uri/ /index.php?$query_string;
}
```
3. 点击 **保存**
---
## 六、配置 PHP 扩展
1. 网站 → 点击你的站点 → 查看 PHP 版本
2. 点击 **PHP 版本** → **设置**
3. 点击 **PHP 扩展**
4. 确保以下扩展已启用：
| 扩展 | 说明 |
|------|------|
| `pdo_mysql` | 数据库连接 |
| `openssl` | 加密 |
| `json` | JSON 处理 |
| `fileinfo` | 文件信息 |
| `mbstring` | 多字节字符串 |
| `tokenizer` | 代码解析 |
如未启用，点击 **安装** 或 **开启**。
---
## 七、配置 SSL 证书（HTTPS）
1. 站点 **设置** → **SSL**
2. 选择 **Let's Encrypt**
3. 勾选你的域名
4. 点击 **申请**
5. 开启 **强制HTTPS**
---
## 八、安装好站站
### 8.1 访问安装页面
`https://你的域名/install.php`
### 8.2 填写数据库信息
先在宝塔面板 → **数据库** → 创建数据库，然后填写：
| 字段 | 值 |
|------|-----|
| 数据库主机 | `127.0.0.1` |
| 端口 | `3306` |
| 数据库名 | 你创建的数据库名 |
| 用户名 | 你创建的数据库用户名 |
| 密码 | 你创建的数据库密码 |
### 8.3 填写管理员信息
| 字段 | 值 |
|------|-----|
| 姓名 | `管理员`（可自定义） |
| 邮箱 | `admin@example.com` |
| 密码 | `不少于6位` |
### 8.4 开始安装
点击 **开始安装**，等待完成。
---
## 九、验证
访问 `https://你的域名/admin/login`
输入管理员账号密码登录，后台正常显示 ✅
---
## 十、常见问题
**Q：PHP 版本不够 8.3？**
宝塔软件商店 → PHP → 安装 PHP 8.3。
**Q：install.php 访问 404？**
检查网站运行目录是否设置为 `/public`。
**Q：数据库连接失败？**
确认数据库主机填写 `127.0.0.1`，不是 `mysql`。
**Q：storage 目录不可写？**
SSH 执行：
```bash
cd /www/wwwroot/你的域名
chmod -R 775 storage bootstrap/cache
```
---
## 十一、联系支持
官网：https://haozhanzhan.com