AlmaLinux 10 没有 NetworkManager-dispatcher 子包:资产在主包里
在 almalinux:10 容器(aarch64;10.2,NetworkManager 1.56.0-3.el10_2)中实际执行:dnf search 无匹配确认、rpm -ql NetworkManager 的 dispatcher 资产清单、systemd service 单元内容读取、nm-dispatcher 二进制 --help、strings 提取环境变量符号、man 页动作列表读取。原始日志:plans/content-expansion/evidence/logs/alma-nm-dispatcher.log。
本页没有实测:dispatcher 脚本的真实触发运行(需网络事件 + systemd + NM 服务运行)、生产脚本示例的端到端验证。相关段落标注「待实机验证」。
EL10 没有 dispatcher 子包(实测)
Section titled “EL10 没有 dispatcher 子包(实测)”$ dnf search NetworkManager-dispatcherNo matches found.这就是 EL10 与旧教程最大的差异。在 EL8/EL9 时代,NetworkManager-dispatcher 是一个独立的子包,需要显式安装。EL10 把它合并进了主包——你装 NetworkManager 就自动有了 dispatcher 功能。
不过这并不意味着 dispatcher 服务默认就在跑:它由 D-Bus 按需激活(有网络事件时 NM 通过 D-Bus 拉起),空闲后自动退出。
dispatcher 资产在主包哪里
Section titled “dispatcher 资产在主包哪里”rpm -ql NetworkManager | grep dispatcher 的完整输出(实测):
| 路径 | 用途 |
|---|---|
/etc/NetworkManager/dispatcher.d/ | 用户脚本目录(含 no-wait.d/ pre-down.d/ pre-up.d/) |
/usr/lib/NetworkManager/dispatcher.d/ | 包提供的脚本(同子目录结构) |
/usr/lib/systemd/system/NetworkManager-dispatcher.service | systemd 服务单元 |
/usr/libexec/nm-dispatcher | dispatcher 二进制 |
/usr/share/dbus-1/system-services/org.freedesktop.nm_dispatcher.service | D-Bus 服务定义 |
/usr/share/dbus-1/system.d/nm-dispatcher.conf | D-Bus 权限配置 |
/usr/share/man/man8/NetworkManager-dispatcher.8.gz | man 页 |
systemd service 关键参数
Section titled “systemd service 关键参数”Type=dbusBusName=org.freedesktop.nm_dispatcherExecStart=/usr/libexec/nm-dispatcherKillMode=processType=dbus 意味着 D-Bus 激活——NM 有事件时通过 D-Bus 拉起服务,处理完毕且无排队脚本后自动退出。KillMode=process 确保脚本 spawn 的长进程不被 systemd 清理。
脚本接口约定
Section titled “脚本接口约定”dispatcher 脚本收到两个位置参数($1 = 接口名,$2 = 动作名),并通过环境变量获取详细信息:
| 环境变量 | 内容 |
|---|---|
NM_DISPATCHER_ACTION | 当前动作名(如 up、dhcp4-change) |
CONNECTION_UUID / CONNECTION_ID | 连接的 UUID 与名称 |
DEVICE_IFACE / DEVICE_IP_IFACE | 控制接口与 IP 接口名 |
IP4_GATEWAY / IP4_NAMESERVERS / IP4_DOMAINS | IPv4 网关/DNS/搜索域 |
DHCP4_option“ | DHCP 选项(如 DHCP4_HOST_NAME) |
IP6_name / `DHCP6_`name | IPv6 同理 |
完整动作列表:pre-up、up、pre-down、down、vpn-pre-up、vpn-up、vpn-pre-down、vpn-down、hostname、dhcp4-change、dhcp6-change、connectivity-change、dns-change、reapply、device-add、device-delete。
脚本放置与优先级
Section titled “脚本放置与优先级”# 写一个最小脚本(示例:接口 UP 时记录到 syslog)sudo tee /etc/NetworkManager/dispatcher.d/50-log-up <<'EOF'#!/bin/bashif [ "$2" = "up" ]; then logger -t nm-dispatcher "$1 is up"fiEOFsudo chmod 755 /etc/NetworkManager/dispatcher.d/50-log-up脚本约束(man 页原文口径,待实机验证):root 所有、不可被 group/other 写入、不可 setuid。/etc 侧优先于 /usr/lib 侧同名脚本;所有脚本按字母序执行。
- dispatcher 脚本的真实触发运行与环境变量实际值(待实机验证);
no-wait.d与普通目录的行为差异(man 页有说明但未实测);device-add/device-delete的 generic 连接场景;- NetworkManager 停止时 dispatcher 是否仍运行。