← 返回系统组成地图
本层包含几条并行的能力：NetworkManager 管理 Wi-Fi 与有线连接，BlueZ 管理蓝牙，Avahi 发现局域网服务，UFW 管理主机通信规则。它们不是“先后安装就能联网”的步骤，也不是彼此的替代品。
以使用网络打印机为例： NetworkManager 先建立可用的网络连接；在支持发现的网络与设备上，Avahi 帮助找到打印服务；CUPS 随后处理打印队列和任务。通信还会受到防火墙与网络隔离策略影响，能发现打印机不等于任务一定能送达。
以蓝牙耳机为例： BlueZ 负责设备发现、配对与连接，之后还需要 PipeWire 与 WirePlumber 处理声音与路由。这个过程通常不需要先连接 Wi-Fi。
因此，无法连接无线网络、找不到局域网服务、蓝牙已连接却无声，应沿不同协作路径定位。防火墙规则无法替代连接管理，也不能修复没有被系统识别的无线硬件。
以下逐一介绍本分类已收录的全部组件，涵盖用途、原理、配置、排查、注意事项与学习资料。点击目录中的名称可跳转到相应正文。
本分类已收录的全部 4 个组件
管理 Wi-Fi 和有线连接；网络面板是面向用户的操作入口。
- 包名
networkmanager- 收录状态
- 核心清单
- Omarchy 配置或入口
Super + Ctrl + W
用途与日常使用
管理有线和无线连接配置、地址与连接状态。日常连接 Wi-Fi 时，Omarchy 网络面板提供操作入口；命令行工具则适合查看设备状态、分析配置和定位连接失败的阶段。
工作原理与协作关系
它区分网络设备与保存的连接配置。设备显示已连接，不等于路由或 DNS 一定正常。本快照的 Omarchy 配置启用 NetworkManager，并清理会竞争的旧 networkd 配置，避免多个管理者争用同一网络接口。
配置与定制
可以通过网络面板、nmtui 或 nmcli 管理连接配置。地址、DNS 和自动连接应分别理解；某个 Wi-Fi 的配置有误时，通常应先检查该连接，而不是直接覆盖全局配置或安装另一套网络管理器。
常见问题与排查思路
按设备状态、地址与路由、DNS 的顺序检查。没有出现无线设备时，先关注硬件、固件和无线开关；已经连接却无法上网时，再继续检查后续网络层，避免反复输入密码却忽略真正原因。
能力边界与修改注意事项
配置和诊断输出可能暴露网络标识信息，求助时应去除凭据。不要让多个网络管理器同时管理一个接口；改动远程连接所依赖的配置前，也应考虑连接中断后的恢复方式。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi networkmanager
nmcli device status
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
Linux 蓝牙协议栈；配对与蓝牙音频还涉及桌面和声音组件。
- 包名
bluez- 收录状态
- 核心清单
用途与日常使用
提供 Linux 蓝牙支持，处理控制器与配对设备。理解蓝牙问题时，先分清发现设备、配对和连接，再分析耳机播放或输入设备交互等应用层功能。
工作原理与协作关系
蓝牙守护进程通过 D-Bus 提供接口，桌面面板和 bluetoothctl 都是它的客户端。耳机即使成功连接，声音仍需要 PipeWire 与 WirePlumber 协作；蓝牙连接成功不保证音频输出选择正确。
配置与定制
日常配对可使用桌面面板。控制器开关、设备信任与音频配置选择是不同设置，并非一个总开关就能解决所有问题。修改前先确认操作的是哪个控制器与设备。
常见问题与排查思路
先确认控制器存在且已开启，再看配对与连接状态。只有声音异常时，应继续检查音频路由，不必立刻删除配对。设备能否被其他主机发现，也能帮助区分外设状态与本机配置问题。
能力边界与修改注意事项
删除配对会清除已有信任关系，需要重新配对。可发现状态会使本机向附近设备暴露，应按实际需要使用。不同蓝牙设备支持的功能并不相同，不能把耳机的设置照搬到键盘。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi bluez
bluetoothctl show
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
通过 mDNS/DNS-SD 发现局域网服务。
- 包名
avahi- 收录状态
- 核心清单
用途与日常使用
通过 mDNS/DNS-SD 发现局域网中的兼容服务，例如打印机。它让应用更容易找到附近设备，而不需要为每台设备手动记住和输入地址。
工作原理与协作关系
发现过程依赖局域网组播与服务广播。NetworkManager 负责先建立网络连接，打印等应用再使用发现结果。发现服务和真正连接服务是两步：能看到设备名称，不代表后续通信一定成功。
配置与定制
选择监听接口或发布哪些服务时，需要查看守护进程设置。优先理解发行版现有配置，区分“发现别人提供的服务”和“把本机服务广播出去”，避免为解决查找问题而无意扩大服务暴露范围。
常见问题与排查思路
先检查设备是否位于合适的网络，以及访客网络隔离或组播过滤是否阻止发现。修改互联网 DNS 往往不能解决局域网发现问题；还应确认目标服务确实在广播。
能力边界与修改注意事项
它不是互联网 DNS 服务器，也不是文件共享服务本身。服务名称和广播内容可能向同一网络的其他设备透露信息；功能边界应与真正提供文件、打印等服务的程序分开理解。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi avahi
systemctl status avahi-daemon --no-pager
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
主机防火墙管理；防火墙规则与 Wi-Fi 连接是不同层面的问题。
- 包名
ufw- 收录状态
- 核心清单
用途与日常使用
通过较简明的命令界面管理主机防火墙策略，用于控制允许进入或转发的流量。它关心的是通信规则，而不是 Wi-Fi 是否连接成功。
工作原理与协作关系
把策略转成 Linux 数据包过滤规则。容器网络可能引入自己的规则，因此 Docker 的端口发布和转发行为，需要与普通主机入站规则分别理解。
配置与定制
添加规则前先查看当前策略，明确端口、协议、来源和方向。解决某个服务访问问题时，应针对该服务调整，而不是添加大范围例外。
常见问题与排查思路
先确认应用确实在监听且网络路由正常。放行规则不能启动已停止的服务器，也不能修复 DNS；应先定位通信在哪一步失败。
能力边界与修改注意事项
远程访问规则变更可能断开管理连接。不要把关闭全部防护作为例行测试；保留现有规则与恢复方式，并考虑容器网络的额外行为。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi ufw
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
搜索所有组件 · 官方软件包清单索引
本页随共享组件目录更新；收录范围基于目录标注的源码快照，不代表所有版本或全部间接依赖。