安装与实例初始化
本章介绍安装后建立第一个实例的流程，以及初始管理员凭据的处理。
各操作系统的安装包形态与安装步骤不同，见对应章节：
| 操作系统 | 安装包 | 章节 |
|---|---|---|
| Windows | 引导安装程序 | Windows 安装 |
| macOS | 安装包 | macOS 安装 |
| Linux | DEB / RPM | Linux 安装 |
程序目录、数据存放位置与随附数据库的说明，见目录结构。
1.0 兼容边界
1.0 使用独立数据库基线，不支持直接接管 0.x 实例数据库，也不接受 0.x 应用备份导入。需要继续保留旧数据时另存原环境，再建立新实例；详见版本兼容与更新。
1. 安装与实例的关系
安装程序铺设的是运行环境：服务本体、运行时依赖，以及（按需，且本机没有现成数据库时）一份随附的数据库。
安装完成后机器上还没有任何实例，需要至少建立一个实例才能进入控制台。
实例是一套完整、独立的运行环境，拥有自己的数据库、端口与全部数据。同一台机器可运行多个互不影响的实例。业务应用及其数据都保存在所属实例中。
2. 建立第一个实例
首次打开管理页面且机器上没有实例时，自动进入新建实例流程。
2.1 自动生成（推荐用于首次安装）
若检测到随安装部署的数据库，系统会询问是否自动生成实例，提示为「实例名称、目录、服务名、端口与数据库连接都已有默认值。是否直接用默认设置自动生成实例？」。
选择「自动生成」即可跳过四步向导一次建成。需要自定义配置时选择「手动配置」。
2.2 手动配置的四个步骤
第一步：实例信息
| 项目 | 说明 |
|---|---|
| 实例名称 | 必填，全局唯一 |
| 实例标识 | 系统自动生成，一般无需修改 |
| 实例目录 | 默认自动分配，可改到其他位置 |
| 服务名称 | 自动生成，可编辑 |
第二步：数据库设置
检测到随安装部署的数据库时会自动填入连接信息，提示「已检测到随安装部署的 MySQL，已为你填入默认连接」。要使用自有数据库则手工填写主机、端口、库名与账号密码。
⚠️ 数据库类型选择器中虽然同时列出 MySQL 与 PostgreSQL，但当前版本只有 MySQL 能通过连接测试。 选择 PostgreSQL 将无法继续。
点击「测试连接并继续」。连接测试不通过则无法进入下一步，这是在确认账号密码与网络连通性。该步骤只测试连接，不会改动数据库内容。
第三步：访问设置
设置服务监听的端口，默认 8080。端口被占用时系统自动向后探测一个空闲端口并填入。
第四步：确认并创建
汇总显示前面填写的全部配置（密码以掩码显示）。确认后点击「创建并启动」，系统依次执行写入配置、初始化数据库、安装内置组件、注册服务、启动与健康检查，过程中显示进度。
初始化失败会整体回滚。 系统不会留下半成品实例，已创建的内容（含已复制的组件文件）会被自动清理，结果页显示失败原因与日志位置。按提示修正后重新执行即可。
3. 管理员登录凭据
实例创建成功后，页面显示「管理员登录凭据」区块：
| 项目 | 值 |
|---|---|
| 登录名 | admin |
| 初始密码 | 由系统为该实例随机生成 |
🔴 该密码仅显示这一次，请立即复制保存。
界面提示为「该密码仅显示这一次，请立即保存。首次登录后必须修改密码；若已丢失，可在实例列表用「重置管理员」重新生成」。
每个实例的初始密码各不相同，不存在通用的默认密码。
首次登录后系统强制要求修改密码，无法跳过。
密码丢失的处理：在实例列表中对该实例执行「重置管理员」。该操作会恢复登录名 admin 并生成新的随机密码，同样只展示一次。实例处于运行或停止状态均可执行，详见实例管理。
4. 后续步骤
管理员账号建立后，按初始配置顺序搭建组织架构、账号与权限。
建议日常管理使用具名的管理员账号，admin 仅在必要时使用，以便在日志中区分操作人。
5. 使用限制与注意事项
| 限制 | 说明 |
|---|---|
| 初始密码仅展示一次 | 未保存则须重置管理员重新生成 |
| 首次登录强制修改密码 | 无法跳过 |
| 当前仅支持 MySQL | 选择器中的 PostgreSQL 无法通过连接测试 |
| 数据库连接测试不通过无法继续 | 须先解决连接问题 |
| 实例名称全局唯一 | 同一台机器上不可重名 |