systemd mount 单元依赖网络但网络晚启动的正确 _netdev + After= 配置

15次阅读

正确做法是启用_netdev并显式依赖network-online.target:fstab中添加_netdev及x-systemd.after=network-online.target、x-systemd.wants=network-online.target,或手动unit中配置After=和Wants=,同时确保systemd-networkd-wait-online.service或NetworkManager-wait-online.service已启用。

systemd mount 单元依赖网络但网络晚启动的正确 _netdev + After= 配置

当 systemd mount 单元挂载远程文件系统(如 NFS、CIFS)时,若网络尚未就绪就尝试挂载,会失败并可能被 systemd 标记为“failed”甚至跳过重试。正确做法不是仅靠 _netdev,而是结合 After=Wants= 和合适的网络目标(如 network-online.target),确保挂载单元**明确等待网络真正可用**。

必须启用 _netdev 且挂载点需在 fstab 中声明

_netdev 是内核级标记,告诉 systemd 该设备依赖网络,挂载前需等待网络初始化;但它本身不触发等待逻辑,仅影响 systemd 的默认行为(例如跳过 early mount)。关键前提是:mount 单元必须由 systemd-fstab-generator 自动创建(即该挂载项存在于 /etc/fstab),或手动编写 unit 时显式设置 _netdev(通过 X-Systemd-Options=_netdev 或在 [Mount] 段中写 What=… 并确保 fstab 行含 _netdev)。

  • ✅ 正确 fstab 示例:
    192.168.1.10:/data /mnt/nfs nfs _netdev,defaults,x-systemd.automount,x-systemd.requires=network-online.target 0 0
  • ❌ 错误:仅写 _netdev 但没配网络等待目标 → 挂载仍可能早于 IP 配置完成

用 After=network-online.target + Wants=network-online.target

network.target 仅代表网络服务已启动(如 NetworkManager 或 systemd-networkd 进程 running),但接口未必有 IP 或路由;而 network-online.target 是真正的“网络就绪”信号,由 systemd-networkd-wait-online.serviceNetworkManager-wait-online.service 达成后才激活。因此 mount 单元必须显式依赖它:

  • 若使用自动生成的 unit(来自 fstab):在 fstab 的 options 字段加 x-systemd.after=network-online.target x-systemd.wants=network-online.target
  • 若手写 /etc/systemd/system/mnt-nfs.mount:在 [Unit] 段写
    After=network-online.target
    Wants=network-online.target
  • ⚠️ 注意:Requires=network-online.target 不推荐 —— 若网络服务异常失败,会导致 mount 单元无法启动;Wants= 更柔性,允许降级继续

确保 network-online.target 实际可达

很多系统默认未启用 systemd-networkd-wait-online.service(尤其用 NetworkManager 时)。需确认对应 wait-online 服务已启用并运行:

  • 检查状态:systemctl is-active systemd-networkd-wait-online.servicesystemctl is-active NetworkManager-wait-online.service
  • 启用它(依实际网络管理器):
    sudo systemctl enable systemd-networkd-wait-online.service

    sudo systemctl enable NetworkManager-wait-online.service
  • 可选增强:编辑 /etc/systemd/networkd.conf 或 NM 配置,设置超时和接口过滤(如 WaitOnlineInterfaceRegex=enp0s3|wlan0),避免因未插网线的接口拖慢上线

附加建议:避免 automount 冲突与调试技巧

若同时用了 x-systemd.automount,注意 automount 单元默认不继承 After=,需单独配置 .automount 单元或改用显式 RequireMountsFor=

  • 调试命令:systemctl list-dependencies --reverse mnt-nfs.mount 查依赖反向关系
    systemctl status network-online.target 看谁激活了它
    journalctl -u mnt-nfs.mount -u network-online.target -b 查启动时序
  • 临时验证:重启后执行 systemctl show mnt-nfs.mount | grep -E "(After|Wants)",确认生成的 unit 确实包含 network-online.target
  • 不复杂但容易忽略:fstab 中的 x-systemd.xxx 选项只在 unit 自动生成时生效;手动写的 .mount 文件必须自己写全 [Unit][Mount]

text=ZqhQzanResources