Linux 与服务器运维 / 系统课时
服务怎样等待网络环境准备好
服务怎样等待网络环境准备好
服务依赖网络时,最常见的误区是把某个 Target 到达等同于“互联网已经可用”。systemd 只能协调本机启动阶段;网络管理器何时认为网络在线,以及某个 DNS、网关或远端接口是否真的可访问,是不同层次的问题。本篇给出可落地的等待策略。
学习目标
- 区分
network.target、network-online.target与远端服务真正可访问这三个层次。 - 能为需要网络的服务正确配置
Wants=与After=。 - 能判断何时还需要 wait-online、应用重试或专门的上游就绪检查。
network.target 不等于网络已经可用
network.target 主要表示本机网络管理栈已经进入启动流程,它并不保证网卡已经拿到地址,更不保证默认路由、DNS 或外部服务可用。只写 After=network.target,解决的是本机 Unit 的排序问题,不是等待联网完成。
对启动时确实需要已配置网络的服务,更常见的关系是:
[Unit]
Wants=network-online.target
After=network-online.target这里仍然是两件事:Wants= 把 network-online.target 拉入事务,After= 让当前服务排在它之后。只写 After=network-online.target 时,目标不会因为这一条排序关系而自动被当前服务拉入。
network-online.target 依赖谁来判断在线
network-online.target 本身不会探测公网。它需要网络管理实现提供相应的 wait-online 服务,在启动期间延迟该 Target 的到达。以 NetworkManager 为例,NetworkManager-wait-online.service 会等待 NetworkManager 完成其启动期网络处理,再允许 network-online.target 到达。

如果主机使用 NetworkManager,可以先确认管理器处于活动状态,再检查对应等待服务是否启用:
systemctl is-active NetworkManager.service
systemctl is-enabled NetworkManager-wait-online.service预期输出(NetworkManager 正在运行且 wait-online 已启用时)
active
enabled如果第二行不是 enabled,需要结合发行版默认策略确认是否应该启用它。使用 systemd-networkd 的主机则检查 systemd-networkd.service 与 systemd-networkd-wait-online.service,不要在同一台机器上机械启用并未负责网络配置的等待服务。
为需要网络的服务声明启动关系
下面是一个最小可验证示例。它不访问外网,只验证当前服务会在 network-online.target 之后启动。
sudo tee /etc/systemd/system/demo-network-client.service >/dev/null <<'EOF'
[Unit]
Description=Demo network client
Wants=network-online.target
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/bin/true
RemainAfterExit=yes
EOF
sudo systemctl daemon-reload
sudo systemctl start demo-network-client.service
systemctl is-active demo-network-client.service预期输出
active这份配置只建立启动期同步关系。它能避免服务过早启动,但不能证明某个外部 API 已经可以连接,也不能在网络后来掉线时自动重新触发 network-online.target。
真正需要等的是本机网络还是某个上游
决定方案前先明确“准备好”的对象。不同需求不应该都塞给 network-online.target。
| 实际需求 | 更合适的做法 |
|---|---|
| 只要本机网络配置完成即可启动 | Wants=network-online.target + After=network-online.target |
| 必须等 NetworkManager 或 networkd 完成启动期配置 | 确保对应 wait-online 服务参与启动 |
| 必须能访问特定 DNS、数据库或 HTTP API | 应用重试,或专门的就绪检查 Unit |
| 运行期间网络可能短暂断开 | 应用自行处理重连,并结合 Restart= 策略 |
对于长期运行的网络客户端,通常不应把“远端永远可用”假设放进启动顺序。远端服务可能在本机启动完成后重启、切换或中断,所以应用本身仍要有超时与重试能力。wait-online 解决的是启动期同步,而不是持续的网络健康监控。
例如,一个能在连接失败后自行退出的客户端,可以让 systemd 负责重新拉起:
[Service]
Restart=on-failure
RestartSec=5s这是片段示例,需要合并到实际服务的 [Service] 段。它的生效行为是:进程以失败状态退出后,systemd 等待 5 秒再尝试启动;验证时可在测试环境暂时阻断上游连接,再用 systemctl status <SERVICE> 观察重启计数与当前状态。这样,启动期由 network-online.target 解决“不要太早”,运行期由应用重试与 systemd 重启策略解决“网络会变化”。