Linux 安装
本章介绍在 Linux 上的安装步骤、安装位置与卸载方式。
提供两种原生安装包：DEB（Ubuntu 18.04 及以上、Debian）与 RPM（CentOS 7、RHEL 7 及以上）。安装脚本不需要联网，适合离线部署。
1. 支持的架构
提供 amd64/x86_64 与 arm64/aarch64 两种。
⚠️ 随附数据库的精简运行时当前仅提供 x86_64 版本。在补齐对应运行时之前，arm64 发行包可能不含随附数据库，此类机器需自行准备 MySQL 8.0。
2. 安装
使用系统的包管理器安装，需要管理员权限：
bash
# Debian / Ubuntu
sudo dpkg -i kimpo_<版本>_amd64.deb
# CentOS / RHEL
sudo rpm -i kimpo-<版本>.x86_64.rpm安装脚本依次执行：激活主程序 → 按需部署随附数据库 → 注册服务 → 启动管理器。
3. 随附数据库
首次安装时，若本机没有正在运行的数据库，安装脚本会自动部署一份精简版 MySQL 8.0 并注册为系统服务 kimpo-mysql.service。
判定规则
| 情形 | 行为 |
|---|---|
| 首次安装且本机无运行中的数据库 | 部署 |
此前已部署过（存在标记文件 /var/lib/kimpo/installer/mysql-provisioned 或 kimpo-mysql.service） | 跳过 |
| 检测到 3306 端口被占用或已有数据库进程 | 跳过，安装照常成功 |
部署后，管理员初始密码写入 /root/kimpo-mysql-login-info.txt，安装结束时终端会打印该路径。
🔴 该文件含明文密码，保存或改密后应立即删除。
随附数据库的版本、改密的两个步骤、升级与卸载时的行为，见目录结构与随附数据库。
4. 安装位置
| 内容 | 路径 |
|---|---|
| 主程序目录（程序本体，全部实例共用，升级整体替换） | /opt/kimpo |
| 实例目录（各实例的配置、数据与日志，升级不动，卸载保留） | /var/lib/kimpo/instances/<实例标识> |
| 管理会话文件（易失，随重启清空） | /run/kimpo/setup |
| 安装交接文件与实例指针索引（持久） | /var/lib/kimpo/setup、/var/lib/kimpo/instances-index |
| 命令行工具 | /opt/kimpo/bin/kimpoctl |
两类目录的区别见目录结构与随附数据库。
5. 建立第一个实例
安装脚本结束时会启动管理器。按机器是否有图形界面选择方式：
有图形界面的机器
bash
sudo /opt/kimpo/bin/kimpoctl setup open在浏览器中打开新建实例向导。
无图形界面的服务器（多数情况）
bash
sudo /opt/kimpo/bin/kimpoctl setup tui使用终端界面完成，功能与网页向导一致，可在纯字符终端中建立实例、启停与修改配置。
setup open 在检测到无图形环境时会自动转为终端界面。
四个步骤（实例信息 → 数据库设置 → 访问设置 → 确认创建）的说明见安装与实例初始化。
正式操作前可先演练：
kimpoctl setup tui --dry-run使用内存中的模拟数据运行终端界面，不连接真实服务，也不需要管理员权限。详见实例管理。
6. 服务与实例管理
每个实例对应一个独立的系统服务，默认名为 kimpo-<实例标识>.service。
除终端界面外，也可直接使用命令行管理：
bash
kimpoctl instance list # 列出全部实例
kimpoctl instance show <实例标识> # 查看实例详情
kimpoctl instance start <实例标识> # 启动
kimpoctl instance stop <实例标识> # 停止完整的命令与用法见实例管理。
7. 卸载
使用包管理器卸载：
bash
sudo dpkg -r kimpo # 或 sudo apt remove kimpo
sudo rpm -e kimpo # 或 sudo yum remove kimpo卸载会逐个停止并注销实例服务、删除服务定义文件，但默认保留：
- 全部实例根目录（配置、密钥、证书、数据、日志），无论位于哪个磁盘；
- 机器级指针索引；
- 实例的系统账号；
- 随附数据库的服务与数据，以及外部数据库。
重新安装后，管理器会依据指针索引重新识别这些实例。需要彻底清除时，在卸载后手工删除上述目录。
8. 下一步
建立实例并妥善保存初始管理员凭据后，按初始配置顺序搭建组织架构与权限。
初始管理员密码由系统随机生成且仅展示一次，详见安装与实例初始化。