跳转到内容
搜索 AlmaLinux 文档

    浏览当前文档目录

    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 服务运行)、生产脚本示例的端到端验证。相关段落标注「待实机验证」。

    Terminal window
    $ dnf search NetworkManager-dispatcher
    No matches found.

    这就是 EL10 与旧教程最大的差异。在 EL8/EL9 时代,NetworkManager-dispatcher 是一个独立的子包,需要显式安装。EL10 把它合并进了主包——你装 NetworkManager 就自动有了 dispatcher 功能。

    不过这并不意味着 dispatcher 服务默认就在跑:它由 D-Bus 按需激活(有网络事件时 NM 通过 D-Bus 拉起),空闲后自动退出。

    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.servicesystemd 服务单元
    /usr/libexec/nm-dispatcherdispatcher 二进制
    /usr/share/dbus-1/system-services/org.freedesktop.nm_dispatcher.serviceD-Bus 服务定义
    /usr/share/dbus-1/system.d/nm-dispatcher.confD-Bus 权限配置
    /usr/share/man/man8/NetworkManager-dispatcher.8.gzman 页
    Type=dbus
    BusName=org.freedesktop.nm_dispatcher
    ExecStart=/usr/libexec/nm-dispatcher
    KillMode=process

    Type=dbus 意味着 D-Bus 激活——NM 有事件时通过 D-Bus 拉起服务,处理完毕且无排队脚本后自动退出。KillMode=process 确保脚本 spawn 的长进程不被 systemd 清理。

    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_DOMAINSIPv4 网关/DNS/搜索域
    DHCP4_option“DHCP 选项(如 DHCP4_HOST_NAME)
    IP6_name / `DHCP6_`nameIPv6 同理

    完整动作列表: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。

    # 写一个最小脚本(示例:接口 UP 时记录到 syslog)
    sudo tee /etc/NetworkManager/dispatcher.d/50-log-up <<'EOF'
    #!/bin/bash
    if [ "$2" = "up" ]; then
    logger -t nm-dispatcher "$1 is up"
    fi
    EOF
    sudo 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 是否仍运行。