概述

EBAOZU V4 采用标准化的配置驱动部署模式。完成源码上传与 PHP 扩展安装后，需依次完成数据库初始化、.env 配置文件修改与授权文件部署。

---

步骤一：创建并初始化 MySQL 数据库

1. 打开宝塔面板【数据库 -> 添加数据库】：
   • 数据库名：例如 ebaozu_db
   • 用户名 / 密码：建议生成强密码并记录
   • 字符集：必须选择 utf8mb4
2. 点击【导入 -> 从本地上传】选择交付包中的数据库结构文件（如 ebaozu_v4.sql），点击【导入】执行数据写入。

---

步骤二：配置 .env 环境变量文件

在站点根目录下复制或编辑 .env 文件（可从交付包中的 .example.env 或 .env.example 复制）：

cp .example.env .env

APP_DEBUG = false

[APP]
DEFAULT_TIMEZONE = Asia/Shanghai
APP_KEY = # 请生成并填写 32 位随机字符 #

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
HOSTPORT = 3306
USERNAME = ebaozu_db       # 宝塔创建的数据库用户名
PASSWORD = your_db_pwd     # 宝塔创建的数据库密码
DATABASE = ebaozu_db       # 数据库名
PREFIX = eb_
CHARSET = utf8mb4
DEBUG = false

[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD =           # 若 Redis 设置了密码请填写，无密码留空
SELECT = 0

[CACHE]
DRIVER = redis
PREFIX = eb_cache_
TAG_PREFIX = eb_tag_

---

步骤三：配置商业授权证书 (license.key)

商业发布包基于专属证书验证运行：

1. 核验扩展状态： 确保 PHP 已成功加载 ebaozu_loader 扩展（执行 php --ri ebaozu_loader 有正常输出）；
2. 确认授权证书： 交付发布包中已内置您的客户专属授权证书，文件位于：config/ebaozu/license.key。若缺失或需更换，请将官方发放的 license.key 放置到该目录；
3. 设置严格权限（最小权限原则）：

   chmod 600 config/ebaozu/license.key
   chown www:www config/ebaozu/license.key

   IMPORTANT

   授权证书为加密二进制格式，请勿使用任何文本编辑器打开保存，以免因编码转换损坏证书数据。后续续期只需覆盖此文件并重载服务。

---

步骤四：确认安装锁定状态

系统出厂默认包含安装锁文件 public/install/install.lock，以防止外部通过浏览器未授权重装。确保该文件存在即可，无需额外操作。