macOS 安装

本章介绍在 macOS 上的安装步骤、安装位置与卸载方式。

安装包为 .pkg 格式，Intel 与 Apple 芯片通用。

1. 运行安装程序

双击安装包，使用系统自带的安装器完成安装。安装包含两个组件：

组件	是否可选	说明
Kimpo 平台	必装，不可取消	程序本体
随附 MySQL 数据库	可选	部署一份精简版 MySQL 8.0

关于未签名安装包：测试阶段的安装包未做签名与公证，首次打开若被系统拦截，通过**右键 →「打开」**确认一次即可。

在「安装类型」步骤中，「随附 MySQL 数据库」勾选项有三种状态，由本机情况决定：

本机情况	勾选项状态	含义
未检测到本机数据库	默认勾选，可取消	建议安装随附数据库。取消则需在建实例向导中手工填写自有数据库的连接信息
检测到已有外部数据库	取消且不可选	让位给现有数据库，不重复安装
本机此前已由本产品部署过随附数据库	取消且不可选	继续使用现有数据库，重装与升级均不重复部署

实际部署了随附数据库时，当前用户桌面会生成 Kimpo-MySQL-初始密码简报.txt（无法获取桌面路径时位于 /Users/Shared/），其中包含管理员初始密码与改密方法。

🔴 该文件含明文密码，保存或改密后应立即删除。

随附数据库的完整说明见目录结构与随附数据库。

内容	路径
主程序目录（程序本体，全部实例共用，升级整体替换）	`/Library/Kimpo`
实例目录（各实例的配置、数据与日志，升级不动，卸载保留）	`/Library/Application Support/Kimpo/instances/<实例标识>`
安装状态与实例指针索引	`/Library/Application Support/Kimpo/setup`、`/Library/Application Support/Kimpo/instances-index`
命令行工具	`/usr/local/bin/kimpoctl`（软链至 `/Library/Kimpo/bin/kimpoctl`）

安装完成后有两种方式：

方式	操作
应用图标	`/Applications` 下会出现 Kimpo 应用。双击并确认一次管理员密码，即启动管理器并在浏览器打开新建实例向导
命令行	在终端执行 `sudo kimpoctl setup open`

首次安装且机器上尚无实例时，将直接进入建实例向导。各步骤说明见安装与实例初始化。

无人登录的机器（远程管理或无图形会话）：安装本身不要求有人登录即可完成，但自动打开浏览器需要图形登录会话。远程安装的机器可在安装完成后通过命令行打开，或使用终端界面，见实例管理。

macOS 的安装包没有原生卸载入口，使用随附的卸载脚本：

bash

sudo /Library/Kimpo/libexec/uninstall

该脚本会停用并移除实例的后台服务，但默认保留以下内容：实例目录、日志、系统实例账号，以及随附数据库（服务、/Library/Kimpo/mysql、/Library/Application Support/Kimpo/mysql-data）与外部数据库。

⚠️ 不要手工删除 /Library/Application Support/Kimpo，该目录包含全部实例的数据。应通过卸载脚本处理。确需彻底清除数据时，先执行卸载，再按需手工删除。

建立实例并妥善保存初始管理员凭据后，按初始配置顺序搭建组织架构与权限。

初始管理员密码由系统随机生成且仅展示一次，详见安装与实例初始化。