部署与运维

选择部署方式

本地开发用于阅读和修改源码；生产自托管用于长期业务运行。生产环境需要稳定访问域名、持久化数据目录和备份计划。安装入口见私有化部署指南。

本地启动

准备 Go、Node.js 和可用的 Docker 或 Podman Compose 环境，在源码目录运行：

git clone https://github.com/kageos/kageos.git
cd kageos
./scripts/dev.sh

打开 http://localhost:5173，使用 system 和启动摘要中的密码。详细依赖版本以仓库贡献指南为准。私有 .kageos/ 文件包含配置和密钥，不要提交到 Git。

生产上线检查

1. 使用正式域名访问，确认 HTTPS 证书可信。
2. 检查平台服务和用户应用运行时，不能只检查首页。
3. 完成一次登录和一个低风险业务操作。
4. 验证持久化位置、磁盘空间和独立备份副本。
5. 记录版本、安装方式和恢复路径。

在源码部署中，使用 kagectl doctor、status、verify 和日志逐层检查。通过安装器安装的实例，按其管理命令说明执行，避免混用不同部署方式的数据目录。

升级前后

升级前备份并校验，记录当前镜像版本和回滚路径。升级后重复健康检查及业务验证。如果有错误，先定位最早失败项，不要通过清空数据库、存储卷或工作空间来尝试修复。

TLS 文件、配置和业务数据都属于需要保护的持久状态。备份与恢复说明了归档和恢复预检方法。