# 文档

> 了解如何用 ansible-vms 定义和管理 KVM 虚拟机。

---

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

---

用 Ansible 与 libvirt 定义和管理 KVM 虚拟机的完整指南。

- [快速开始](/docs/getting-started/) — 安装依赖并创建第一台虚拟机
- [虚拟机定义](/docs/vm-definition/) — 在 `vms.csv` 中配置虚拟机
- [虚拟机生命周期](/docs/vm-lifecycle/) — 列出、启动、停止、重启和销毁虚拟机
- [基础镜像](/docs/base-images/) — 下载 Linux 与 Windows 基础镜像
- [网络](/docs/network/) — 网桥网络、DHCP 与静态 IP
- [数据盘](/docs/data-disks/) — 挂载、扩容与热插拔数据盘
- [快照](/docs/snapshots/) — 创建、恢复与删除快照
- [用户账户](/docs/setup-user/) — 创建带免密 sudo 的 SSH 用户
- [虚拟机控制台](/docs/vm-console/) — VNC/SPICE 与串口控制台访问
- [远程桌面](/docs/remote-desktop/) — Windows 虚拟机的 RDP 访问
- [防火墙](/docs/firewall/) — 托管的 nftables 防火墙
- [macOS 虚拟机](/docs/macos/) — 免键盘启动的黑苹果客户机
- [macOS 基础镜像](/docs/macos-base-image/) — macOS 基础镜像的制作过程
{.cards}

---

本节页面：

- [快速开始](/zh/docs/getting-started/): 安装依赖并创建第一台 KVM 虚拟机。
- [虚拟机定义（vms.csv）](/zh/docs/vm-definition/): 通过 vms.csv 中的每一行配置虚拟机。
- [虚拟机生命周期](/zh/docs/vm-lifecycle/): 列出、启动、停止、重启和销毁虚拟机。
- [基础镜像](/zh/docs/base-images/): 为虚拟机下载 Linux、Windows 与 macOS 基础镜像。
- [网络](/zh/docs/network/): 虚拟机的网桥网络、DHCP 与静态 IP 配置。
- [数据盘](/zh/docs/data-disks/): 挂载、扩容、格式化数据盘，以及管理额外磁盘。
- [快照](/zh/docs/snapshots/): 创建、列出、恢复和删除虚拟机快照。
- [用户账户](/zh/docs/setup-user/): 在 Linux 虚拟机上创建带 SSH 密钥和免密 sudo 的用户。
- [虚拟机控制台](/zh/docs/vm-console/): 通过 SPICE 或 VNC 访问虚拟机显示控制台。
- [远程桌面](/zh/docs/remote-desktop/): Windows 虚拟机的 RDP 访问。
- [防火墙](/zh/docs/firewall/): 在 Debian 与 RedHat 系主机上用 nftables 管理宿主机防火墙。
- [macOS 虚拟机](/zh/docs/macos/): 与 Linux、Windows 虚拟机并行的免键盘黑苹果 macOS 客户机。
- [macOS 基础镜像](/zh/docs/macos-base-image/): 在 Debian 12 上用 OSX-KVM 从零制作 macos-sonoma-base.img。
