运行安装向导
运行安装向导
基座代码部署并启动后（见部署后端基座），数据库、.env 配置、管理员账号都不用手写。浏览器打开安装地址，跟着四步走完，就能直接登录后台。
安装向导是内置的静态页 am-serve/public/install.html，通过 /api/install/* 接口工作，安装阶段不依赖任何登录态。
打开向导
| 场景 | 地址 |
|---|---|
| 本地开发 | http://127.0.0.1:8787/install.html |
| 服务器部署 | http://<你的域名或IP>:8787/install.html（经 Nginx 同域反代后用 http://你的域名/install.html） |
未安装时访问站点根目录会自动引导到安装向导；也可直接访问上面的地址。
四步流程
步骤 1 · 用户协议
阅读《软件许可协议》，滚动到底部后「我已阅读并同意」才可勾选，点「同意并继续」。
步骤 2 · 环境检测
自动扫描服务器环境，逐项给出通过 / 未通过：
| 检测类别 | 内容 |
|---|---|
| PHP 版本 | 要求 >= 8.4 |
| PHP 扩展 | pdo_mysql、redis、openssl、zip、gd、fileinfo |
| PHP 函数 | exec、shell_exec、putenv、proc_open、pcntl_* 系列（多进程/信号/进程控制） |
| 目录权限 | runtime/、public/ 可写，.env 可写（或父目录可写） |
必须项未通过会拦截
标注为「必须」的项目有任一未达标时，「下一步」按钮不可点。按提示修复环境（多为放开 php.ini 扩展或补目录权限）后点「重新检测」。带「建议」标记的项不影响继续。
步骤 3 · 系统配置
分五组填写，每组都能即时验证：
- 站点配置 —— 站点域名、时区、调试模式（生产建议关闭
APP_DEBUG）。 - 数据库配置 —— 地址 / 端口 / 库名 / 用户名 / 密码 / 表前缀（默认
am_）。点「测试数据库连接」验证；库不存在时向导会自动建库；若检测到同前缀已有表，会红字警告「安装将覆盖这些表数据」。 - Redis 配置 —— 地址 / 端口 / 密码（无密码留空）。点「测试 Redis 连接」验证。
- 管理员账号 —— 用户名 + 密码（至少 6 位，需二次确认）。这是登录后台的超级管理员。
- 后台入口 —— 见下方后台入口安全。
数据库与 Redis 两项连接测试都通过、管理员信息填写合法后，「下一步」才可点。
步骤 4 · 执行安装
点「开始安装」，向导按顺序执行并实时显示进度，全部完成即出现「安装成功」页，展示后台地址与管理员账号。
向导到底替你做了什么
点「开始安装」后，后端 InstallService 依次完成以下动作（了解即可，无需干预）：
| 序 | 动作 | 说明 |
|---|---|---|
| 1 | 建立数据库连接 | 用你填的账号连接 MySQL，CREATE DATABASE IF NOT EXISTS 自动建库 |
| 2 | 导入表结构 | 执行 install/install.sql，创建 20+ 张系统表（表名带 am_ 前缀） |
| 3 | 导入内置数据 | 执行 install/seed.sql，写入菜单、字典、系统配置等初始数据 |
| 4 | 创建超级管理员 | 用你填的用户名/密码建账号，并授予全部菜单权限 |
| 5 | 生成并写入 .env | 自动填充数据库、Redis、时区，并生成随机 JWT 密钥 |
| 6 | 应用后台入口设置 | 按你选的入口方式改名，并把 install.html 停用为 install.html.bak |
| 7 | 写入安装锁 | 生成 runtime/install.lock 并在 .env 置 APP_INSTALL=true，双重防重复安装 |
你不需要再手动做的事
- 不用编辑
.env（向导已写好数据库/Redis/JWT）。 - 不用手动导入
install.sql/seed.sql（向导已执行）。 - 不用去 phpMyAdmin 建库（库不存在会自动建）。
后台入口安全
「系统配置」最后一步可选后台访问入口，用于隐蔽后台地址、避免被扫描发现：
| 方式 | 效果 |
|---|---|
| 随机生成（推荐） | 生成形如 manage_1a2b3c4d.html 的入口文件，/ 首页不再跳转后台 |
| 自定义 | 你指定一个 xxx.html（字母开头，仅字母/数字/_/-，不能用保留名 install.html） |
| 保持默认 | 入口仍为 index.html，访问 / 直达后台 |
选了随机/自定义，务必立刻收藏入口地址
安装成功后页面会醒目地显示入口地址（如 https://你的域名/manage_1a2b3c4d.html）。此后只有这个地址能进后台，忘记时可查看 am-serve/.env 里的 APP_ENTRY_FILE。
安装完成后
- 重启服务使配置生效：
php start.php restart。 - 用向导里设置的管理员账号登录后台。
- 生产环境确认
.env的APP_DEBUG为关闭、JWT密钥为随机值（向导已随机生成）。
重新安装 / 换环境
向导装好后会自我锁定（install.html 已改名、安装锁已写入）。如需重装：
- 删除
am-serve/.env与am-serve/runtime/install.lock； - 把
am-serve/public/install.html.bak改回install.html； - 重启服务，重新访问安装向导。
重装会重建数据表
重装会重新执行建表与导入，若沿用同一个数据库，原有数据将被覆盖。仅在新环境或确认可清空时使用。