# 开始使用

> 用 up 启动 Barn、用 ssh 进入客机，其余管理、排障、镜像、构建与清理按需阅读。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

安装 Barn 后，新用户只需按[快速上手](tutorial/)启动测试环境：

```bash
barn up
barn ssh
```

没有配置文件且没有已有部署时，交互式 `up` 会生成默认配置；它也能准备缺少的宿主依赖与网络。重复执行
`barn up` 可重试未完成的客机初始化，不会重启已经健康运行的 VM。无人值守时，
先执行 `barn setup --yes`，再执行 `barn up`。

公开软件包状态见[当前状态](../about/status/)；开发者与源码审查者可使用
[从源码构建](source-build/)。

其余内容按任务拆开：

1. [日常管理](operations/)：状态、访问、启停、变更、缩容与销毁。
2. [故障排查](troubleshooting/)：诊断信息与常见问题修复。
3. [镜像仓库](images/)：选择镜像、使用镜像站、导入与清理缓存。
4. [从源码构建](source-build/)：开发者构建、检查与本地 PATH。
5. [卸载与清理环境](uninstall/)：移除 deployment、镜像、网络与状态。
6. [自动化与客机脚本](automation/)：无人值守准备、JSON 验收、可重复执行的客机脚本与 Pigsty 衔接。
7. [存储与访问](storage/)：磁盘保留、文件传输、SSH 隧道与 Linux 目录共享。
8. [macOS 虚拟机](macos/)：尚未发布的 `barn mac`，在 Apple 芯片上运行带桌面、SSH、
   共享目录与剪贴板的 macOS 27 客机。

---

本节页面：

- [快速上手](/zh/docs/start/tutorial/): 安装 Barn 0.9.0，用 up 启动 Ubuntu 实验环境，用 ssh 进入，再通过同一份配置增量扩容。
- [日常管理](/zh/docs/start/operations/): 唯一 deployment 的正常生命周期：检查、访问、扩容、变更、停止与销毁。
- [故障排查](/zh/docs/start/troubleshooting/): 面向 setup、网络、镜像、漂移、中断状态与 SSH 的简短安全手册。
- [自动化与客机脚本](/zh/docs/start/automation/): 准备无人值守实验环境，检查 JSON 结果，并在选定客机内运行可重复执行的脚本。
- [存储、文件与服务访问](/zh/docs/start/storage/): 配置测试数据盘，理解保留规则，传输文件，并通过 OpenSSH 访问客机服务。
- [macOS 虚拟机](/zh/docs/start/macos/): 用 barn mac 在 Apple 芯片 Mac 上运行 macOS 27 虚拟机：创建、连接、共享文件与剪贴板，以及清理。
- [镜像仓库](/zh/docs/start/images/): 选择 Guest 镜像、使用镜像站、导入本地 qcow2，并清理缓存。
- [从源码构建](/zh/docs/start/source-build/): 为开发与审查构建 Barn，并运行完整源码检查。
- [卸载与清理环境](/zh/docs/start/uninstall/): 安全移除 Barn deployment、集成、镜像、宿主网络与默认状态目录。