在虚拟机中先行体验 Omarchy：UEFI、virtio 配置与 Hyprland 常见陷阱

想要体验 Omarchy 却不想直接清空笔记本电脑的物理硬盘？虚拟机是绝佳的起点。Omarchy 官方文档将虚拟机视为一等公民（尤其是针对无人值守部署），刷写到 U 盘的同一份官方 ISO 镜像可以直接用于虚拟磁盘。本文将带你安全地完成首次体验：关键固件配置、契合官方范式的 Proxmox/QEMU virtio/UEFI 架构，以及在资源不足或配置有误时 Hyprland 常见的显示问题与避坑技巧。

这是一篇针对体验与试用 Omarchy 的实战指南。在将系统安装到物理机裸机之前，请务必参阅官方入门指南。

你正在安装的系统

Omarchy 是一套基于 Arch Linux、围绕 Hyprland 与（4.0 Quattro 版本起采用的）Quickshell 桌面环境打造的 omakase 体验系统。系统通过官方 ISO 镜像安装，安装程序支持全盘安装（Full-disk）或空闲空间安装（Free-space）；在一次性测试虚拟机中，通常建议选择在专门创建的虚拟磁盘上进行全盘安装。

启动前验证 ISO 镜像（来自 v4.0.0 发布说明）：

• 下载地址：https://iso.omarchy.org/omarchy-4.0.0.iso
• SHA256 校验和：9224fab3720560f771969a99a499e5f7e0f8e2d6a0681d872d52f05fb5003da4

截至 2026 年 8 月，官方 ISO 下载地址正常可用（文件大小约 6.27 GB / 5.84 GiB），SHA256 与官方发布页面一致。在下载完成后请务必在本地进行哈希校验。

在进行任何涉及磁盘分区的实验前，请确保宿主机重要数据已做好备份。分配独立虚拟磁盘的虚拟机是风险最低的探索路径。

虚拟机运行 Omarchy 常见故障原因（速查清单）

初次启动遇到的大多数问题并非系统本身缺陷，而是虚拟固件或输入配置不匹配：

1. 传统 BIOS / SeaBIOS — Omarchy 强制要求 UEFI 引导。请使用 OVMF（或宿主机虚拟化平台提供的 UEFI 固件），切勿使用传统 SeaBIOS。
2. 未关闭 Secure Boot / TPM — 官方入门指南明确要求：安装 Omarchy 必须关闭 Secure Boot 和/或 TPM。对于默认预置 Secure Boot 密钥的虚拟机，需关闭安全启动或在 EFI 磁盘配置中指定 pre-enrolled-keys=0（详见下文 Proxmox 范例）。
3. LUKS 解密界面无法使用蓝牙键盘 — 全盘加密机制在开机启动阶段无法识别蓝牙键盘。请在宿主机端使用有线键盘或 2.4 GHz 接收器键盘并透传为标准 HID 设备，或直接在虚拟机控制台窗口中输入密码。
4. 虚拟机规格过低 — 官方文档未设定硬性最低内存标准，但若 Hyprland 桌面出现卡顿或掉帧，建议在排查配置文件前先将虚拟机规格提升至 4~8 GB 内存及 4 vCPU。
5. 误选目标磁盘 — 全盘安装会格式化所选驱动器。在虚拟机中操作时，请确认选中目标为虚拟磁盘而非透传的物理硬盘。

路径 A — 交互式图形/向导安装（适合首次体验）

1. 创建 UEFI 虚拟机

符合官方无人值守/Proxmox 标准的基础配置参数：

通用 QEMU/libvirt 说明： 可参考 Baeldung 关于 QEMU UEFI 启动指南 配置 OVMF 固件及 virt-manager 的 UEFI 选项。在 Proxmox 环境中推荐搭配 OVMF + Q35 架构。

2. 挂载 Omarchy 4.0 ISO 并启动

启动虚拟机后，系统将直接进入安装向导。

3. 完成安装向导（及进阶快捷键）

根据入门指南：

• 依次完成键盘布局、用户信息及安装确认等步骤。
• 为他人装机模式： 在向导的首个界面（键盘布局选择）按下 Ctrl + C，系统将进入“为新所有者准备设备”模式 —— 个人设置推迟至首次开机时进行。
• 非加密安装模式（仅限特殊测试）： 在磁盘格式化确认界面按下 Ctrl + C 可切换至不加密安装。默认采用加密方案，这也是推荐的安全规范。
• 选择虚拟磁盘并确认。在高性能存储上通常 1 分钟内即可完成，老旧设备上通常在 5 分钟以内。

4. 首次启动

• 若启用了加密，启动时输入设置的 LUKS 密码。支持宿主机通过 VGA/串口/SPICE 控制台输入。
• 解密完成后即可直接进入 Hyprland 桌面。Omarchy 原生设计不包含传统登录管理器界面（Display Manager Greeter）。

5. 登录后必记的三个核心快捷键

根据 Quattro 官方快捷键体系：

桌面没有传统的 Dock 栏或桌面图标，这是原生设计；一切均可通过菜单或快捷键快速唤起。

路径 B — 无人值守自动化安装（集群与批量测试）

官方支持通过挂载第二块卷标为 cidata 的磁盘直接传入预配置文件，无需重新打包 ISO 即可跳过安装向导全自动安装。

cidata 驱动器所需核心文件：

• user_configuration.json
• user_credentials.json 或用于推迟配置的空文件 defer-provisioning

可选配置文件包括 git 用户名/邮箱、加密标志、authorized_keys 及 tailscale_authkey。用户密码哈希可通过以下命令生成：

openssl passwd -6 "yourpassword"

生成配置 ISO 镜像（官方范例）：

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

官方 Proxmox 配置范例

摘自官方无人值守安装手册：

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

关键特性说明：

• 启动顺序特意将磁盘置于第一位（空盘时自动转入光驱引导，安装后直接从硬盘启动）。
• 若配置中包含 authorized_keys，安装程序会自动启用 sshd 服务并放行对应防火墙端口。
• 加密模式下的首次启动说明： 即使是无人值守安装，首次开机依然需要手动输入磁盘解密密码；cidata 中的密码明文存储，请妥善保管该配置镜像。

虚拟机环境下的 Hyprland / Wayland 避坑指南

显示与 3D 硬件加速

• 优先选用支持硬件加速的 virtio 显示适配器。
• 在 VirtualBox 或 VMware 环境下，请确保启用了 EFI 固件并分配了充足的显存。KVM/QEMU 与 Proxmox 在 Wayland 兼容性上表现最佳。

屏幕缩放与应用界面过大问题

Omarchy 默认在显示器配置中通过 GDK_SCALE 设定为 2 倍高分屏缩放。在标准的 1080p 1 倍缩放虚拟机窗口中，GTK 窗口可能会显得异常巨大 —— 可通过编辑 ~/.config/hypr/monitors.lua 调整缩放比例，无需重装系统。

macOS 宿主机 (Apple 芯片 / UTM)

在 macOS 上使用 UTM 或 Apple 虚拟化框架时，请选择 UEFI 引导与 virtio-gpu。需注意 ARM 架构转译 x86_64 存在一定的性能损耗。

何时切换至裸机物理机安装

建议在虚拟机中熟练掌握以下操作后再考虑实体机部署：

1. 顺畅完成 LUKS 解密并自如切换工作区（Super + 1..4）。
2. 熟练通过 Super + Space 唤起菜单启动应用和调整系统配置。
3. 执行一次主菜单的 Update > Omarchy 系统更新并成功重启验证。

随后即可参阅入门指南制作正式的物理机安装 U 盘。