# 怎么开始：纳管主机并跑通第一轮

## 核心定义
> 纳管主机并跑通第一轮是指通过安装软件、添加主机、扫描主机并查看结果，完成从安装到初步使用的一个最小闭环过程。

## 核心洞察（TL;DR）
- 完成纳管主机的最小闭环过程
- 通过GUI路径添加主机并执行扫描
- 执行带审批意识的操作，先进行低风险操作，再尝试中风险操作
- 使用日志/告警进行AI诊断（可选）
- 了解常见卡点及处理方法

## 关键事实与数据
- 关键事实1: 安装软件时，需要下载macOS的`.dmg`文件或团队分发的安装包，并拖到应用程序中启动
- 关键事实2: 扫描主机时，需要确保主机在线状态和基础信息完整
- 关键事实3: 执行操作时，低风险命令可执行，中/高风险操作需要管理员审批

## 正文
# 怎么开始：纳管主机并跑通第一轮

目标：从安装到「加主机 → 扫描 → 看结果」的最小闭环。

## 1. 安装

### 桌面 UI（推荐上手）

1. 从 Release 下载 macOS `.dmg`（或按团队分发的安装包）。  
2. 拖到「应用程序」后启动。  
3. 首次启动会初始化数据目录（默认 `~/.agus/`，可用 `AGUS_HOME` 或设置修改）。  

### 依赖提示

- 若启用 Chroma 等向量侧车，需本机 **Docker** 可用（以当前版本说明为准）。  
- SSH 目标需网络可达，并准备好密钥或账密（优先密钥）。  

## 2. 第一轮 GUI 路径

1. 打开 **Hosts（主机）**：添加一台你有权限的测试机。  
2. 填写别名、地址、端口、用户与认证方式 → 保存。  
3. 点 **Scan / 扫描**（文案以界面为准）：生成环境/拓扑类报告。  
4. 到概览或报告页确认：主机在线状态、基础信息不是空白。  

**成功标准**：主机列表有该节点；扫描任务结束有可读摘要或报告入口。

## 3. 试一次「带审批意识」的执行

1. 选中主机，进入执行/终端类功能（或使用 CLI，见下篇）。  
2. 先跑**低风险**只读命令（如查看磁盘、服务状态）。  
3. 再尝试中风险操作：应出现确认；高风险应要求管理员审批。  

不要在第一天就对生产做无确认的批量变更。

## 4. 用日志/告警练手 AI 诊断（可选）

1. 准备一段脱敏后的错误日志或告警原文。  
2. 贴进诊断入口，查看建议是否引用了主机/历史上下文。  
3. **采纳建议前**仍走你的变更流程；AI 输出不等于已授权执行。  

## 5. 常见卡点

| 现象 | 处理 |
|------|------|
| SSH 失败 | 核对地址/端口/密钥权限 `600`；跳板机与 ProxyJump |
| 扫描很慢或空 | 目标负载、超时、权限不足；先对单机缩小范围 |
| Docker / Chroma 起不来 | `docker ps`；看 Agus 日志；可先关闭向量能力只用基础运维 |
| 找不到数据目录 | `echo $AGUS_HOME`；默认 `~/.agus` |

## 6. 建议的验收清单

- [ ] 至少 1 台测试主机纳管成功  
- [ ] 完成 1 次扫描并看到结果  
- [ ] 低风险命令可执行；中/高风险出现确认或审批  
- [ ] 知道数据目录在哪，便于备份  

完成后进入：[CLI 审批与 Skills 怎么用](https://haxitag.com/community/agus/agus_t-agus-eyawxznfox83)。

---
## 引用与溯源
**来源**：哈希泰格 (HaxiTAG)
**原始链接**：[https://haxitag.com/community/agus/agus_t-agus-lz2rxc49eht0](https://haxitag.com/community/agus/agus_t-agus-lz2rxc49eht0)
**来源索引（站内可追溯）**：[麦肯锡](https://haxitag.com/search?q=%E9%BA%A6%E8%82%AF%E9%94%A1)、[普华永道](https://haxitag.com/search?q=%E6%99%AE%E5%8D%8E%E6%B0%B8%E9%81%93)、[Gartner](https://haxitag.com/search?q=Gartner)、[IDC](https://haxitag.com/search?q=IDC)、[Forrester](https://haxitag.com/search?q=Forrester)
**版权声明**：本文由哈希泰格 AI 引擎优化生成，引用请注明出处。