> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 单二进制安装

> 通过二进制入口完成 AiOS bootstrap 与本地开发验证的快速开始说明。

# 单二进制安装

## 适用对象

本页面适用于希望快速体验 AiOS 安装入口、开发者本地验证流程或 bootstrap 调试的人。

## 目标与范围

本页说明如何通过单二进制入口启动 AiOS，但必须注意：

* 这是 bootstrap / 开发验证入口
* 不是最终生产运行方式

## 核心概念

* 单二进制入口负责启动最小控制面与安装流程
* 正式运行目标仍是 K3s 中的镜像化服务

## 当前运行模式说明

`cmd/aios` 当前支持两类运行模式理解：

* `bootstrap`：允许在没有 PostgreSQL 的情况下启动，用于安装、bring-up、本地验证和结构调试
* `persistent`：要求 PostgreSQL，当前需要持久化任务读取的控制面能力在这个模式下才算完整接线

这意味着“服务能启动”不等于“所有控制面读写能力都已完整可用”。

如果你只是做 bootstrap 演练，`bootstrap` 是有效路径；如果你要验证依赖任务持久化状态的控制面行为，就应先准备 PostgreSQL 并按 persistent 方式启动。

## 标准流程

1. 准备依赖环境
2. 启动 `cmd/aios`
3. 通过健康检查确认服务启动
4. 用它继续进入 bootstrap/安装流程

## CLI 示例

```bash theme={null}
go run ./cmd/aios
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz
```

## Web UI 路径

服务启动后，可通过 Web UI 进入安装/bootstrap 入口页（后续完善）。

## 常见问题 / 风险提示

* 当前单二进制启动只适合开发和 bootstrap，不应被理解为最终生产部署形态。
* 后续正式运行应把控制面服务部署到 K3s 中。
* 某些当前控制台读接口依赖持久化任务状态；在 bootstrap 下，它们不应被理解为“只是没有数据”，而应理解为未进入完整持久化能力集。

## 相关页面

* [开始使用](/getting-started/index)
* [轻量模式初始化](/getting-started/bootstrap-light-mode)
* [Web UI 操作手册](/operations/web-ui-guide)