Omarchy 故障排查：启动、黑屏、网络、声音与登录

先保存证据、缩小范围，再修改系统。记录最后正常时间、刚完成的更新/配置和稳定复现步骤；一次只验证一个假设。如果 ISO 写盘或安装器在首次成功启动前停止，应改看安装停止与失败排查。

1. 建立诊断基线

先运行只读命令：

date
uname -a
omarchy debug
systemctl --failed
journalctl -b -p warning..alert --no-pager

-b 是本次启动；若问题发生在上一次启动，再查看：

journalctl -b -1 -p warning..alert --no-pager

公开输出前删除用户名、主机名、IP、Wi-Fi 名称、序列号、挂载路径和令牌。不要只截最后一行错误。

2. 更新后无法启动或桌面损坏

1. 在固件启动菜单选择 Limine；
2. 选择更新前日期/版本的快照；
3. 进入快照后确认问题是否消失；
4. 点击恢复通知，或运行：

omarchy-snapshot restore

若能登录但默认包或配置广泛损坏，可在备份用户修改后运行：

omarchy reinstall

它会回到 stable、重装默认包并重置 Omarchy 默认配置，不用于恢复 /home 文件。完整边界见快照与系统恢复。

3. 黑屏、显示比例或外接屏

先检查线缆、输入源和另一台显示器。按 Ctrl + Alt + F2 尝试进入 TTY；能看到 TTY 说明系统已启动，问题更可能在图形会话或显示配置。

收集显卡、驱动和显示信息：

lspci -k | rg -A3 'VGA|3D|Display'
hyprctl monitors all
journalctl -b | rg -i 'drm|gpu|nvidia|amdgpu|i915|hypr'

应用界面普遍过大时，官方建议检查 ~/.config/hypr/monitors.lua。1x 显示器可把：

local omarchy_gdk_scale = 2

改为 1，再重启受影响应用。修改前先备份文件，不要同时改刷新率、缩放和显卡参数。

4. Wi-Fi 或 DNS

按层验证，不要把“浏览器打不开”直接当成 Wi-Fi 断开：

nmcli device status
ip -brief address
ip route
ping -c 3 1.1.1.1
resolvectl query omarchy.org

• 没有网卡/链路：先处理驱动、飞行模式或硬件；
• 有地址但无默认路由：检查网络连接；
• 能 ping IP、DNS 查询失败：检查 DNS/VPN/代理与系统时间；
• 仅一个网站失败：不要重置整个网络。

临时故障可先用 Super + Space → Update → Hardware → Wi-Fi 重启对应子系统；蓝牙、音频、触控板也有各自入口。

5. 声音与蓝牙

点击顶栏扬声器图标确认主输出和每应用音量。查看 PipeWire/Pulse 设备：

wpctl status
systemctl --user --failed
journalctl --user -b | rg -i 'pipewire|wireplumber|bluez'

部分笔记本会自动启用扬声器调音，可检查或关闭：

omarchy audio tuning status
omarchy audio tuning off

优先用 Update → Hardware → Audio/Bluetooth 重载单个子系统，不必先重启整机。

6. btop 提示 Terminal size too small

社区在 Omarchy 4.0.1 上复现过：把 Foot 终端字体从默认值调大后，Super + Ctrl + T 打开的 btop 悬浮窗口可能不足 80 列 × 24 行，于是 btop 拒绝绘制。该问题在 2026-09-04 仍是开放 issue，不能把其中的个人窗口规则当成官方通用修复。

先做无破坏验证：

1. 在普通全屏终端直接运行 btop；
2. 若全屏能打开，问题更可能是悬浮窗口尺寸而非 btop 安装；
3. 对快捷键打开的窗口按 Super + T 改为平铺，或暂时减小终端字体；
4. 用 stty size 查看实际行列数；
5. 记录显示缩放、终端和字体大小后再提交问题。

不要盲目复制固定的 1100×740 窗口规则：它可能在 720p 或高缩放屏幕上溢出。参考：GitHub issue #8702。

7. 密码正确但 login/sudo 被拒绝

连续输错会触发 faillock。从锁屏按 Ctrl + Alt + F2 进入 TTY，登录 root 后仅重置自己的实际用户名：

faillock --user your-username
faillock --reset --user your-username

把 your-username 换成真实用户名。若磁盘解锁阶段就失败，这不是 faillock，也不能靠此命令重置 LUKS 密码。

8. 求助时提供什么

附上硬件型号、Omarchy 版本、复现步骤、预期/实际结果、最近改动、已尝试步骤和完整脱敏错误。可在 Discord 的 #omarchy-help 求助；上传 omarchy debug 前必须先审查敏感信息。

来源：Omarchy Troubleshooting、System Snapshots。