رفع A Start Job Is Running for Wait for Network در Linux؛ حل کامل کندی Boot شبکه

اگر هنگام روشن‌شدن Ubuntu یا یک سرور لینوکسی پیام A Start Job Is Running for Wait for Network را می‌بینید و Boot برای چند ثانیه یا حتی حدود دو دقیقه متوقف می‌شود، معمولاً یکی از Interfaceهای شبکه به وضعیت مورد انتظار نمی‌رسد. ممکن است کابل یا Carrier وجود نداشته باشد، DHCP پاسخ ندهد، یک Interface غیرضروری Required تعریف شده باشد یا NetworkManager منتظر تکمیل یک Connection Profile بماند.

پیام A Start Job Is Running for Wait for Network یعنی چه؟

در زمان Boot، بعضی سرویس‌ها نیاز دارند شبکه قبل از اجرای آن‌ها آماده باشد. systemd برای این موضوع از network-online.target استفاده می‌کند.

بسته به Network Backend، یکی از این سرویس‌ها ممکن است منتظر شبکه باشد:

بنابراین قبل از هر تغییری باید مشخص کنیم کدام سرویس واقعاً Boot را معطل کرده است.

مرحله ۱: پیدا کردن سرویس کندکننده Boot

systemd-analyze blame

اگر چیزی شبیه این دیدید:

2min systemd-networkd-wait-online.service

مشکل از مسیر systemd-networkd است.

اگر این مورد را دیدید:

NetworkManager-wait-online.service

باید تنظیمات NetworkManager را بررسی کنید.

مرحله ۲: Renderer شبکه را مشخص کنید

sudo netplan get

اگر چنین چیزی دیدید:

renderer: networkd

راه‌حل‌های بخش systemd-networkd را دنبال کنید.

اگر:

renderer: NetworkManager

بخش NetworkManager برای شما مرتبط است.

روش اول: رفع مشکل در systemd-networkd

وضعیت Interfaceها را ببینید:

networkctl

نمونه:

IDX LINK  TYPE     OPERATIONAL SETUP
1   lo    loopback carrier     unmanaged
2   eth0  ether    routable    configured
3   eth1  ether    no-carrier  configuring

در این مثال eth1 می‌تواند باعث انتظار Boot شود.

راه‌حل پیشنهادی: optional: true

اگر Interface دوم برای بالا آمدن سرور ضروری نیست، فایل Netplan را باز کنید:

ls -l /etc/netplan/
sudo nano /etc/netplan/01-netcfg.yaml

مثال:

network:
  version: 2
  renderer: networkd
  ethernets:
    eth0:
      dhcp4: true

    eth1:
      dhcp4: true
      optional: true

در Netplan، Device دارای optional: true برای ادامه Boot ضروری نیست و networkd منتظر آماده‌شدن آن نمی‌ماند. :chatgpt-content-reference{index=”1″}

قبل از Apply کردن Netplan

sudo netplan generate

روی VPS Remote بهتر است به‌جای Apply مستقیم از:

sudo netplan try

استفاده کنید.

راه‌حل مستقیم systemd-networkd: RequiredForOnline=no

اگر Netplan استفاده نمی‌کنید و فایل .network را مستقیم مدیریت می‌کنید:

[Match]
Name=eth1

[Network]
DHCP=yes
RequiredForOnline=no

RequiredForOnline=no باعث می‌شود این Link هنگام تعیین وضعیت Online سیستم نادیده گرفته شود. :chatgpt-content-reference{index=”2″}

اگر فقط یک Interface باید Online شود

systemd امکان انتظار برای Interface مشخص را هم دارد:

systemd-networkd-wait-online@eth0.service

این نسخه فقط Interface مشخص‌شده را برای Online شدن بررسی می‌کند. :chatgpt-content-reference{index=”3″}

گزینه –any برای چند Interface

اگر چند Interface دارید و Online شدن یکی از آن‌ها برای ادامه Boot کافی است، systemd گزینه:

--any

را ارائه می‌دهد. این گزینه مخصوصاً برای سیستم‌هایی مفید است که بعضی Interfaceها هنگام Boot ممکن است Carrier نداشته باشند. :chatgpt-content-reference{index=”4″}

روش دوم: اگر NetworkManager عامل Wait for Network است

NetworkManager سرویس جداگانه‌ای به نام:

NetworkManager-wait-online.service

دارد. این سرویس رسیدن سیستم به network-online.target را تا زمانی که NetworkManager Startup را کامل اعلام کند عقب می‌اندازد. :chatgpt-content-reference{index=”5″}

وضعیت را بررسی کنید:

systemctl status NetworkManager-wait-online.service --no-pager
nmcli device status
nmcli connection show

Interface بدون کابل در NetworkManager

NetworkManager برای Ethernet ممکن است منتظر Carrier بماند. اگر کابل متصل نیست یا Interface مجازی در Boot آماده نمی‌شود، همین انتظار می‌تواند Boot را طولانی کند. مستندات NetworkManager نیز به تأخیر ناشی از Carrier Wait اشاره می‌کنند. :chatgpt-content-reference{index=”6″}

وضعیت Device:

nmcli device status

Connection Profileهای در حال Activation را بررسی کنید

nmcli connection show --active
nmcli connection show

NetworkManager Startup را تا زمانی که Profileهای Auto-connect در حال Activation هستند کامل در نظر نمی‌گیرد. Retryهای Auto-connect، DHCP Timeout، IPv6 و Carrier می‌توانند این زمان را افزایش دهند. :chatgpt-content-reference{index=”7″}

IPv4 یا IPv6 می‌تواند عامل تأخیر باشد؟

بله. در NetworkManager تنظیمات:

ipv4.may-fail
ipv6.may-fail

تعیین می‌کنند آیا آماده نشدن یکی از Address Familyها مانع Activated شدن Connection شود یا نه. :chatgpt-content-reference{index=”8″}

آیا Wait Online را Mask کنیم؟

این یکی از راه‌حل‌هایی است که زیاد در اینترنت دیده می‌شود:

sudo systemctl mask systemd-networkd-wait-online.service

یا برای NetworkManager:

sudo systemctl mask NetworkManager-wait-online.service

چه سرویس‌هایی به network-online.target وابسته‌اند؟

systemctl list-dependencies network-online.target

قبل از Disable یا Mask کردن Wait Online این خروجی را بررسی کنید.

Timeout 120 ثانیه از کجا می‌آید؟

در systemd-networkd-wait-online گزینه –timeout= برای تعیین بیشترین زمان انتظار وجود دارد و مقدار پیش‌فرض آن ۱۲۰ ثانیه است. :chatgpt-content-reference{index=”9″}

بنابراین اگر Boot تقریباً دو دقیقه روی Wait for Network متوقف می‌شود، این نشانه بسیار خوبی است که یکی از Linkهای Required به وضعیت لازم نمی‌رسد.

کم‌کردن Timeout بهتر است یا رفع Interface؟

رفع Interface تقریباً همیشه انتخاب بهتری است.

اگر یک Interface بلااستفاده باعث انتظار می‌شود، Optional کردن آن مشکل اصلی را حل می‌کند. کاهش Timeout فقط باعث می‌شود همان مشکل زودتر Timeout شود.

بررسی Logهای systemd-networkd

journalctl -u systemd-networkd -b --no-pager

دنبال پیام‌هایی درباره DHCP، Address Configuration، Carrier و Interfaceهای Failed بگردید.

بررسی Logهای NetworkManager

journalctl -u NetworkManager -b --no-pager

تست نهایی بعد از اصلاح

بعد از اصلاح Netplan یا NetworkManager، ابتدا شبکه را بررسی کنید:

ip address
ip route

اگر networkd دارید:

networkctl

سپس در زمان مناسب Reboot کنید:

sudo reboot

بعد از Boot:

systemd-analyze blame

جدول تشخیص سریع

پرسش‌های متداول

A Start Job Is Running for Wait for Network چیست؟

پیامی از systemd هنگام Boot است که نشان می‌دهد سیستم منتظر آماده‌شدن شبکه یا کامل‌شدن Startup سرویس مدیریت شبکه مانده است.

چرا این پیام حدود دو دقیقه طول می‌کشد؟

اگر systemd-networkd-wait-online عامل انتظار باشد، Timeout پیش‌فرض آن ۱۲۰ ثانیه است.

آیا optional: true کارت شبکه را خاموش می‌کند؟

خیر. فقط باعث می‌شود آماده‌شدن آن Interface شرط ادامه Boot نباشد.

چطور بفهمیم NetworkManager یا networkd فعال است؟

خروجی netplan get و وضعیت سرویس‌های systemd را بررسی کنید. Renderer در Netplan معمولاً مشخص می‌کند Backend اصلی چیست.

آیا Mask کردن wait-online خطرناک است؟

ممکن است. سرویس‌های وابسته به network-online.target احتمال دارد قبل از آماده‌شدن واقعی شبکه اجرا شوند.

بهترین راه رفع این مشکل چیست؟

Interface یا Connection مشکل‌دار را پیدا کنید و Required بودن آن برای Boot را اصلاح کنید؛ نه اینکه صرفاً کل Wait Online را غیرفعال کنید.

منابع رسمی

🔹 systemd-networkd-wait-online manual

🔹 Netplan optional documentation

🔹 NetworkManager-wait-online documentation