完成安装

三种部署方式都通过两步向导初始化系统。打开 https://example.com/install；尚未配置 HTTPS 的隔离环境可先使用 HTTP。

1. 数据库配置

填写数据库地址、端口、专用用户名、密码和数据库名。普通安装与同机宝塔通常使用 127.0.0.1:3306；Compose 安装使用 mysql:3306。

保持“不覆盖”。只有明确要重新初始化可丢弃的数据库时才选择“覆盖”，已有表和业务数据会被替换。

点击“下一步”后，系统检查 ngram 配置、创建表，并生成数据库配置与 SDK 服务端密钥。提示分词长度错误时，修改 MySQL 的 [mysqld] 配置并重启数据库，再继续。

2. 设置管理员

设置后台管理员登录名和强密码，点击“完成”。管理员账号用于后台管理，与聊天用户账号分开。

安装完成后进入 /admin/login，/install 将不再开放。

3. 检查访问与实时连接

1. 登录管理后台，确认数据库读取正常。
2. 在后台 WebSocket 设置中检查公网地址，HTTPS 站点使用 wss://example.com/ws。
3. 按 SDK 认证与登录为两个业务账号取得凭证，完成首个会话。
4. 刷新、断线重连后检查消息、未读与历史记录。

安装生成的文件

文件	内容
config/database.php	数据库连接
plugin/sdk/config/auth.php	SDK 开关、签发 Secret 与 Token 密钥

这两份文件需随部署保留，不放进公开资源目录、不提交到仓库，也不打进客户端。更新系统不重新运行安装 SQL，见进程与版本更新。