# Proxmox
### 1. 准备
{% stepper %}
{% step %}
**下载 CUBE OS 镜像**
访问此 [仓库](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) 以下载最新的 CUBE OS 镜像并在下载后解压。
对于 Proxmox VE 9，下载磁盘镜像归档（通常为 `sdcard.vmdk.xz`).
解压以获得 `.vmdk` 文件。
{% endstep %}
{% step %}
**准备一个 Proxmox VE 主机**
* 正在运行的 **Proxmox VE** 主机并具有管理员访问权限（Web UI + Shell/SSH）
* 如果你尚未安装 Proxmox VE，请按照官方 [指南](https://www.proxmox.com/en/products/proxmox-virtual-environment/get-started).
* 推荐的虚拟机资源：
* **CPU**：2 个核心
* **内存**：4096 MB（4 GB）或更多
{% endstep %}
{% step %}
**Zigbee 适配器（可选）**
如果你需要添加 Zigbee 设备，请准备一个 Zigbee 加密狗。已测试的 Zigbee 加密狗包括：
你可以在 Proxmox 中将该加密狗直通到虚拟机（见下面的可选部分）。
{% endstep %}
{% endstepper %}
### 2. 在 Proxmox 中创建虚拟机
{% stepper %}
{% step %}
在 Proxmox Web UI 中，点击 **创建虚拟机**.
{% endstep %}
{% step %}
**常规 -** 设置虚拟机 ID 和名称，例如 `CUBE OS`.
{% endstep %}
{% step %}
**操作系统 -** 选择 **不要使用任何介质**.
{% hint style="info" %}
CUBE OS 以预构建的磁盘镜像提供。在 Proxmox 中，你将 **导入磁盘镜像** 然后从其启动。
{% endhint %}
{% endstep %}
{% step %}
**系统 -** 推荐设置：
* **BIOS**: `OVMF（UEFI）`
* **EFI 磁盘**：添加一个 EFI 磁盘（默认大小即可）
* **预启动密钥**：取消选中
{% hint style="info" %}
就像 VirtualBox/VMware 指南一样， **需要 UEFI**。如果无法启动，请再次检查 BIOS 是否设置为 **OVMF（UEFI）**.
{% endhint %}
{% endstep %}
{% step %}
**磁盘 / CPU / 内存 / 网络**
* **磁盘**：不要 **创建一个新的空磁盘。你将在下一节导入 CUBE OS 磁盘镜像。** ：2 个核心（CPU 类型
* **CPU**host `推荐）` 网络
* **内存**：4096 MB（4 GB）或更多
* **桥接**:
* **vmbr0**: `（或你的局域网桥接）` 模型
* **VirtIO（半虚拟化）**: `为了使局域网发现和`
{% hint style="warning" %}
cube.local `能够可靠工作，避免使用 NAT 风格的网络。使用一个` 桥接的 **网络连接到你的家庭/办公局域网。** 3. 将 CUBE OS 磁盘镜像导入到 Proxmox
{% endhint %}
{% endstep %}
{% endstepper %}
### 你将导入已解压的 CUBE OS 镜像（例如
CUBE-OS.vmdk `）并将其作为虚拟机的启动磁盘附加。`找到合适的存储（
{% stepper %}
{% step %}
**local`，而不是`local-lvm `在 Proxmox Web UI 左侧边栏，点击`).** （而不是 **，而不是** 上传 **在 Proxmox Web UI 左侧边栏，点击**).
{% endstep %}
{% step %}
**到 `.vmdk` 点击 `，而不是`**
1. 导入 **在你的计算机上选择已解压的磁盘镜像，例如：**
2. sdcard.vmdk
* `等待上传完成（800+ MB 可能需要一段时间）`
3. 完成后，你应该在
内容 **列表中看到该文件。** 附加导入的磁盘并将其设置为启动磁盘。
{% endstep %}
{% step %}
**在 CUBE OS 虚拟机中：** 转到
1. 硬件 **选择已导入的**
2. 添加 **→** 导入硬盘 **然后转到**
3. 选项 → 启动顺序 **并将导入的磁盘设置为第一个启动设备。** 4. 启动 CUBE OS
{% endstep %}
{% endstepper %}
### 点击以
{% stepper %}
{% step %}
该虚拟机并打开 控制台 **等待片刻，让 CUBE OS 初始化。**.
{% endstep %}
{% step %}
启动完成后，你应该在控制台上看到
IP 地址 **显示。** 打开 CUBE OS Web 界面
{% endstep %}
{% step %}
访问
* http\://\/ `，或`尝试：
* [访问成功后，可在设置页面查看一个简短 ID。随后可使用](http://cube.local)
cube-{short id}.local `访问 CUBE OS Web 管理页面，这在同一局域网中区分多个 CUBE OS 实例时很有用。`5.（可选）Zigbee USB 加密狗直通（Proxmox）
{% endstep %}
{% endstepper %}
### 将 Zigbee 加密狗插入 Proxmox 主机。
{% stepper %}
{% step %}
在虚拟机中，转到
{% endstep %}
{% step %}
硬件 → 添加 → USB 设备 **优先按**.
* 供应商/设备 ID **选择（如果你更换 USB 端口，比按端口更稳定）。** 如果你的加密狗暴露串行接口，它也可能出现在
* 添加 → 串口 **下，视你的设置而定。** 重启虚拟机（如有需要），然后在 CUBE OS 中添加 Zigbee 设备。
{% endstep %}
{% step %}
（完）
{% endstep %}
{% endstepper %}
