一、前期准备

1. 服务器：4核4G及以上，已安装 CentOS 7/8 / Ubuntu 20.04 等系统。
2. 域名：已备案，解析到服务器 IP。
3. 宝塔面板：已安装（宝塔官网 有一键安装脚本）。
4. 公众号 / 服务号（已认证，用于微信登录/支付）。
5. 微信支付商户号（如需原生微信支付；也可后期接入易支付）。
6. 源码包：后端（ThinkPHP）+ 前端（HBuilderX 打包的 H5 源码）。

---

二、宝塔环境安装（如未装）

1. 登录宝塔面板（http://服务器IP:8888）
2. 首次登录推荐安装 LNMP 组合：
   · Nginx（最新稳定版）
   · MySQL 5.7.44（注意选择 5.7.44，默认可能不是）
   · PHP 7.4
   · 不装 FTP，可装 phpMyAdmin

若已安装其他版本，建议在「软件商店」里切换/卸载重装。

---

三、添加站点 & 基础配置

1. 添加站点

· 点击「网站」→「添加站点」
· 域名填写：你的域名（不带 http）
· 根目录：保持默认，例如 /www/wwwroot/你的域名
· PHP版本：选择 PHP-74
· 点击「提交」

2. 申请 SSL 证书（强制 HTTPS）

· 进入网站设置 →「SSL」
· 选择「Let's Encrypt」或「宝塔SSL」
· 勾选「强制HTTPS」

3. 配置伪静态（ThinkPHP）

· 网站设置 →「伪静态」
· 选择 ThinkPHP 模板（或手工输入以下规则）：

```nginx
location / {
    if (!-e $request_filename) {
        rewrite  ^(.*)$  /index.php?s=/$1  last;
        break;
    }
}
```

---

四、部署后端代码

1. 上传源码
   · 进入网站根目录 /www/wwwroot/你的域名
   · 用宝塔「远程下载」或「上传」功能，将后端源码 .zip 上传并解压到当前目录。
2. 导入数据库
   · 宝塔「数据库」→「添加数据库」：填写数据库名、用户名、密码
   · 导入 xxx.sql 文件（phpMyAdmin 或宝塔数据库导入功能）
3. 修改 .env 文件
   · 在网站根目录找到 .env（若没有则创建）
   · 修改数据库连接信息：

DB_HOST=127.0.0.1
DB_NAME=你的数据库名
DB_USER=你的数据库用户
DB_PASS=你的数据库密码
DB_PORT=3306

1. 删除禁用函数 putenv
   宝塔「软件商店」→ PHP 7.4 →「禁用函数」→ 找到 putenv → 删除（必须，否则 ThinkPHP 无法启动）
2. 设置目录权限（可选）
    runtime 目录需要 755 权限，所有者 www


五、前端 H5 打包与上传

1. 用 HBuilderX 修改配置
   打开前端项目
   编辑 request/env.js（或类似文件）：
    请求域名：改为你的 https://你的域名
   公众号 APP ID：改成已认证服务号的 AppID
   选择「发行」→「网站 H5」进行打包（输出到 unpackage/dist/build/h5）
2. 上传至服务器
   在服务器网站根目录下创建 /public/h5 文件夹
   将打包后的所有文件上传到 /public/h5 内（包括 index.html）


六、访问测试

· 前端入口：https://你的域名/h5/#/
· 后台入口：https://你的域名/admin123.php/index/
· 默认帐号：admin
· 默认密码：yunlei199511

建议登录后台后立即修改管理员密码。

七、常见问题

· 如果出现 ThinkPHP 500 错误：检查 .env 配置、putenv 是否删除、runtime 目录权限。
· 微信支付无法使用：检查公众号域名白名单、支付授权目录（需为 https://你的域名/h5/）。
· 如需技术协助：可联系 QQ:3895137989（10元/次搭建服务，对方提供）。
· 开源协议：本项目 MIT 协议，保留版权标识即可商用或二次开发。