0

0

systemd 服务启动时依赖网络但网络没起来就启动失败怎么写正确依赖

舞夢輝影

舞夢輝影

发布时间:2026-01-17 22:42:08

|

748人浏览过

|

来源于php中文网

原创

应使用Wants=network-online.target与After=network-online.target组合,并启用对应wait-online服务(如systemd-networkd-wait-online.service);避免仅用After=network.target或Requires=network-online.target等错误写法。

systemd 服务启动时依赖网络但网络没起来就启动失败怎么写正确依赖

要让 systemd 服务在真正有网络连接后才启动,不能只依赖 network.targetnetwork-online.target 就完事——因为它们的语义和实际行为容易被误解。关键在于区分“网络接口已配置”和“网络可达”。

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

这是最常用也最推荐的基础写法,但必须配合网络管理器(如 systemd-networkd 或 NetworkManager)正确启用 systemd-networkd-wait-online.serviceNetworkManager-wait-online.service

  • Wants=network-online.target 表示“我需要这个目标被激活”,不强制阻塞,但配合 After 才生效
  • After=network-online.target 确保服务在该目标**完成激活后**才开始启动
  • 注意:network-online.target 本身不会自己就绪,它依赖底层的 wait-online 服务来判断网络是否真正可用(比如能 ping 通网关或 DNS)

确认 wait-online 服务已启用并工作

不同网络管理器启用方式不同,漏掉这步会导致 network-online.target 立即就绪(假成功):

京点点
京点点

京东AIGC内容生成平台

下载
  • systemd-networkd:运行 sudo systemctl enable systemd-networkd-wait-online.service
  • NetworkManager:运行 sudo systemctl enable NetworkManager-wait-online.service
  • 验证是否生效:systemctl is-active systemd-networkd-wait-online(或对应服务),应为 active;再查 systemctl show network-online.target | grep ActiveState,应为 active 且不是瞬间变 active

对强网络依赖服务,加超时和重试更稳妥

即使用了 network-online.target,某些服务(如需访问特定 API 或内部 DNS)仍可能因网络策略、防火墙或服务端延迟而失败。可在 service 文件中增强鲁棒性:

  • StartLimitIntervalSec=60StartLimitBurst=3 防止反复崩溃刷日志
  • Restart=on-failure + RestartSec=10 让服务自动重试
  • 若逻辑允许,服务自身检查网络连通性(例如启动脚本里 until ping -c1 example.com &>/dev/null; do sleep 2; done),比纯依赖 systemd 更可控

避免常见错误写法

这些写法看似合理,实则无效或危险:

  • 只写 After=network.target:它只表示“网络服务已启动”,但接口可能还没配 IP、DHCP 没完成,不保证能上网
  • Requires=network-online.target:过于严格,如果 wait-online 失败(比如没网线),你的服务会直接无法启动,而非等待或重试
  • 在 service 中用 ExecStartPre=/usr/bin/sleep 10:硬编码延时不可靠,快网慢网都一样等,既不精准也不优雅

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

436

2024.03.01

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1022

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

65

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

418

2025.12.29

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.16

全民K歌得高分教程大全
全民K歌得高分教程大全

本专题整合了全民K歌得高分技巧汇总,阅读专题下面的文章了解更多详细内容。

21

2026.01.16

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

13

2026.01.16

java数据库连接教程大全
java数据库连接教程大全

本专题整合了java数据库连接相关教程,阅读专题下面的文章了解更多详细内容。

33

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 2.9万人学习

Rust 教程
Rust 教程

共28课时 | 4.5万人学习

Git 教程
Git 教程

共21课时 | 2.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号