.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "آشنایی با Netplan (Introduction to Netplan)" "5" "" ""
.SH "نام (NAME)"
\f[CR]netplan\f[R] \- لایه انتزاعی پیکربندی شبکه با YAML برای بک‌اندهای مختلف
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]netplan\f[R] [\f[I]COMMAND\f[R]|help]
.SH "دستورها (COMMANDS)"
برای مشاهده فهرستی از دستورهای موجود در این سیستم، \f[B]netplan help\f[R] را ببینید.
.SH "توضیحات (DESCRIPTION)"
نصب‌کننده‌های توزیع، نمونه‌سازی ابری، ساخت ایمیج برای دستگاه‌های خاص یا هر روش دیگر برای استقرار یک سیستم‌عامل، پیکربندی شبکه مورد نظر خود را در فایل(های) پیکربندی YAML قرار می‌دهند.
در مراحل اولیه راه‌اندازی (early boot)، «رندرکننده شبکه» (network renderer) Netplan اجرا می‌شود که \f[CR]/{lib,etc,run}/netplan/*.yaml\f[R] را خوانده و پیکربندی را در \f[CR]/run\f[R] می‌نویسد تا کنترل دستگاه‌ها را به دیمن شبکه مشخص‌شده واگذار کند.
.IP \[bu] 2
دستگاه‌های پیکربندی‌شده به طور پیش‌فرض توسط systemd\-networkd مدیریت می‌شوند، مگر اینکه صریحاً به عنوان مدیریت‌شده توسط یک رندرکننده خاص (NetworkManager) علامت‌گذاری شده باشند.
.IP \[bu] 2
دستگاه‌هایی که در پیکربندی شبکه پوشش داده نشده‌اند به هیچ وجه دستکاری نمی‌شوند.
.IP \[bu] 2
قابل استفاده در initramfs (وابستگی‌های کم و سریع).
.IP \[bu] 2
عدم وجود پیکربندی تولیدشده دائمی؛ تنها پیکربندی اصلی YAML حفظ می‌شود.
.IP \[bu] 2
تجزیه‌کننده (parser) از چندین فایل پیکربندی پشتیبانی می‌کند تا به برنامه‌هایی مانند libvirt یا \f[CR]lxd\f[R] اجازه دهد پیکربندی شبکه مورد انتظار خود را بسته‌بندی کنند (\f[CR]virbr0\f[R]، \f[CR]lxdbr0\f[R])، یا خط‌مشی پیش‌فرض سراسری را برای استفاده از NetworkManager برای همه‌چیز تغییر دهند.
.IP \[bu] 2
انعطاف‌پذیری برای تغییر بک‌اندها/خط‌مشی در آینده یا سازگاری با حذف NetworkManager را حفظ می‌کند، زیرا پیکربندی تولیدشده موقتی (ephemeral) است.
.SS "ساختار کلی (General structure)"
فایل‌های پیکربندی Netplan از قالب \c
.UR http://yaml.org/spec/1.1/current.html
YAML
.UE \c
\ استفاده می‌کنند.
تمام فایل‌های \f[CR]/{lib,etc,run}/netplan/*.yaml\f[R] در نظر گرفته می‌شوند.
فایل‌هایی که از نظر الفبایی دیرتر قرار دارند (صرف نظر از اینکه در کدام دایرکتوری هستند)، فایل‌های قبلی را اصلاح (کلیدهای نگاشت جدید) یا بازنویسی (همان کلیدهای نگاشت) می‌کنند.
یک فایل در \f[CR]/run/netplan\f[R] به طور کامل روی فایلی با همان نام در \f[CR]/etc/netplan\f[R] سایه می‌اندازد (آن را نادیده می‌گیرد)، و یک فایل در هر یک از این دایرکتوری‌ها روی فایلی با همان نام در \f[CR]/lib/netplan\f[R] سایه می‌اندازد.
.PP
گره سطح بالا در یک فایل پیکربندی Netplan نگاشت \f[CR]network:\f[R] است که حاوی \f[CR]version: 2\f[R] است (قالب YAML که در حال حاضر توسط curtin، MAAS و غیره استفاده می‌شود نسخه ۱ است)، و سپس تعاریف دستگاه‌ها بر اساس نوع آنها گروه‌بندی می‌شوند، مانند \f[CR]ethernets:\f[R]، \f[CR]modems:\f[R]، \f[CR]wifis:\f[R] یا \f[CR]bridges:\f[R].
اینها انواعی هستند که رندرکننده ما می‌تواند آنها را درک کند و توسط بک‌اندهای ما پشتیبانی می‌شوند.
.PP
هر بلوک نوع شامل تعاریف دستگاه به صورت یک نگاشت است که در آن کلیدها (که «شناسه‌های پیکربندی» یا configuration IDs نامیده می‌شوند) به شرح زیر تعریف شده‌اند.
.SS "شناسه‌های پیکربندی دستگاه (Device configuration IDs)"
نام کلیدها در زیر نگاشت‌های تعریف بر پایه نوع دستگاه (مانند \f[CR]ethernets:\f[R]) «شناسه» (ID) نامیده می‌شوند.
آنها باید در کل مجموعه فایل‌های پیکربندی یکتا باشند.
هدف اصلی آنها این است که به عنوان نام‌های لنگر برای دستگاه‌های مرکب عمل کنند، به عنوان مثال برای شمارش اعضای پلی (bridge) که در حال حاضر تعریف می‌شود.
.PP
(از نسخه 0.97) اگر یک رابط با یک شناسه در یک فایل پیکربندی تعریف شود، توسط رندرکننده مربوطه فعال و راه‌اندازی (bring up) خواهد شد.
برای اینکه Netplan به هیچ وجه به یک رابط دست نزند، باید به طور کامل از فایل‌های پیکربندی Netplan حذف شود.
.PP
دو دسته از نظر فیزیکی/ساختاری متفاوت از تعاریف دستگاه وجود دارد و فیلد شناسه برای هر یک تفسیر متفاوتی دارد:
.PP
دستگاه‌های فیزیکی
.RS
.PP
(مثال‌ها: اترنت، مودم، وای‌فای) این دستگاه‌ها می‌توانند بین راه‌اندازی‌های مجدد و حتی در طول زمان اجرا (اتصال حین کار یا hot plugging) به صورت پویا بیایند و بروند.
در حالت کلی، آنها را می‌توان با قوانین \f[CR]match:\f[R] بر روی ویژگی‌های مورد نظر، مانند نام/الگوی نام، آدرس MAC، درایور یا مسیرهای دستگاه انتخاب کرد.
به طور کلی این قوانین با هر تعداد دستگاه مطابقت خواهند داشت (مگر اینکه به ویژگی‌های یکتا مانند مسیر کامل یا آدرس MAC اشاره کنند)، بنابراین بدون دانش بیشتر در مورد سخت‌افزار، اینها همیشه به عنوان یک گروه در نظر گرفته می‌شوند.
.PP
معتبر است که هیچ قانون تطبیقی مشخص نشود، که در این صورت فیلد شناسه صرفاً نام رابطی است که باید مطابقت داده شود.
این بیشتر زمانی مفید است که بخواهید موارد ساده را ساده نگه دارید، و این روشی است که پیکربندی دستگاه‌های شبکه برای مدت طولانی انجام شده است.
.PP
اگر قوانین \f[CR]match:\f[R] وجود داشته باشد، فیلد شناسه یک نام کاملاً مات (opaque) است که فقط برای ارجاع از تعاریف دستگاه‌های ترکیبی در پیکربندی استفاده می‌شود.
.RE
.PP
دستگاه‌های مجازی
.RS
.PP
(مثال‌ها: \f[CR]veth\f[R]، \f[CR]bridge\f[R]، \f[CR]bond\f[R]، \f[CR]vrf\f[R]) این دستگاه‌ها کاملاً تحت کنترل فایل(های) پیکربندی و پشته شبکه هستند.
به عبارت دیگر، این دستگاه‌ها به جای تطبیق داده شدن، ایجاد می‌شوند.
بنابراین \f[CR]match:\f[R] و \f[CR]set\-name:\f[R] برای اینها کاربردی ندارند و فیلد شناسه همان نام دستگاه مجازی ایجادشده است.
.RE
.SH "پیکربندی YAML (YAML configuration)"
.SS "ساختار سطح بالای پیکربندی (Top\-level configuration structure)"
ساختار کلی یک فایل Netplan YAML در زیر نشان داده شده است.
.IP
.EX
network\f[B]:\f[R]
  version\f[B]:\f[R] NUMBER
  renderer\f[B]:\f[R] STRING
  bonds\f[B]:\f[R] MAPPING
  bridges\f[B]:\f[R] MAPPING
  dummy\-devices\f[B]:\f[R] MAPPING
  ethernets\f[B]:\f[R] MAPPING
  modems\f[B]:\f[R] MAPPING
  tunnels\f[B]:\f[R] MAPPING
  virtual\-ethernets\f[B]:\f[R] MAPPING
  vlans\f[B]:\f[R] MAPPING
  vrfs\f[B]:\f[R] MAPPING
  wifis\f[B]:\f[R] MAPPING
  nm\-devices\f[B]:\f[R] MAPPING
.EE
.IP \[bu] 2
\f[B]\f[CB]version\f[B]\f[R] (عدد)
.RS 2
.RS
.PP
مشخص می‌کند چه نسخه‌ای از قالب پیکربندی استفاده شده است.
تنها مقدار پشتیبانی‌شده \f[CR]2\f[R] است.
در صورت عدم تعریف، مقدار پیش‌فرض \f[CR]2\f[R] است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]renderer\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مشخص می‌کند چه ابزار پیکربندی شبکه‌ای برای تنظیم پیکربندی شما استفاده خواهد شد.
مقادیر معتبر networkd و \f[CR]NetworkManager\f[R] هستند.
در صورت عدم تعریف، مقدار پیش‌فرض networkd است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]bonds\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
دستگاه‌های تجمیع پیوند (باندینگ) را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]bridges\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
دستگاه‌های پل (bridge) را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dummy\-devices\f[B]\f[R] (نگاشت) \[en] از نسخه 0.107
.RS 2
.RS
.PP
دستگاه‌های مجازی را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ethernets\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
رابط‌های فیزیکی اترنت را پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]modems\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
مودم‌ها را پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]tunnels\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
انواع مختلف تونل‌های مجازی را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]virtual\-ethernets\f[B]\f[R] (نگاشت) \[en] از نسخه 0.107
.RS 2
.RS
.PP
دستگاه‌های اترنت مجازی (\f[CR]veth\f[R]) را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]vlans\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
VLANها را ایجاد و پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]vrfs\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
دستگاه‌های مسیریابی و فوروارد مجازی (VRF) را پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]wifis\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
رابط‌های فیزیکی وای‌فای را به صورت \f[CR]client\f[R]، \f[CR]adhoc\f[R] یا \f[CR]access point\f[R] پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]nm\-devices\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
دستگاه‌های \f[CR]nm\-devices\f[R] در شرایطی استفاده می‌شوند که Netplan از نوع اتصال پشتیبانی نمی‌کند.
پیکربندی خامی که توسط NetworkManager انتظار می‌رود می‌تواند تعریف شود و همان‌طور که هست (\f[CR]passthrough\f[R]) به فایل \f[CR].nmconnection\f[R] منتقل می‌شود.
کاربران معمولاً از این نوع دستگاه استفاده نخواهند کرد.
.RE
.RE
.PP
تمام ویژگی‌ها برای تمامی انواع دستگاه‌ها در بخش‌های بعدی توضیح داده خواهد شد.
.SS "ویژگی‌های انواع دستگاه‌های فیزیکی (Properties for physical device types)"
این ویژگی‌ها برای دستگاه‌های فیزیکی مانند رابط‌های شبکه اترنت و وای‌فای استفاده می‌شوند.
.PP
\f[B]نکته:\f[R] برخی از گزینه‌ها برای دستگاه‌هایی که فقط بر اساس نام مطابقت داده شده‌اند و توسط networkd رندر می‌شوند، به دلیل تداخل با تغییر نام دستگاه در udev، به درستی کار نخواهند کرد.
هنگام تنظیم گزینه‌هایی مانند: \f[CR]wakeonlan\f[R] یا \f[CR]*\-offload\f[R] دستگاه‌ها را بر اساس MAC مطابقت دهید.
.IP \[bu] 2
\f[B]\f[CB]match\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
این ویژگی زیرمجموعه‌ای از دستگاه‌های فیزیکی موجود را بر اساس ویژگی‌های سخت‌افزاری مختلف انتخاب می‌کند.
پیکربندی زیر سپس بر روی تمام دستگاه‌های منطبق، به محض ظاهر شدن آنها اعمال خواهد شد.
\f[I]تمام\f[R] ویژگی‌های مشخص‌شده باید مطابقت داشته باشند.
.RE
.IP \[bu] 2
\f[B]\f[CB]name\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
نام فعلی رابط.
الگوهای تطبیق سراسری (Globs) پشتیبانی می‌شوند و مورد استفاده اصلی برای تطبیق روی نام‌ها هستند، زیرا انتخاب یک نام ثابت را می‌توان با عدم استفاده از \f[CR]match:\f[R] و صرفاً استفاده از شناسه (ID) راحت‌تر انجام داد (بالا را ببینید).
(\f[CR]NetworkManager\f[R]: از نسخه v1.14.0 به بعد)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]macaddress\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
آدرس دائمی ۶ بایتی MAC دستگاه در قالب \f[CR]XX:XX:XX:XX:XX:XX\f[R] یا ۲۰ بایت برای دستگاه‌های اینفینی‌بند (IPoIB).
الگوهای تطبیق (Globs) مجاز نیستند.
این گزینه با آدرس‌های MAC مجازی برای \f[CR]veth\f[R]، \f[CR]bridge\f[R]، \f[CR]bond\f[R]، \f[CR]vlan\f[R] و ... مطابقت ندارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]driver\f[B]\f[R] (اسکالر یا دنباله‌ای از اسکالرها) \[en] دنباله از نسخه 0.104
.RS 2
.RS
.PP
نام درایور هسته، مطابق با ویژگی udev به نام \f[CR]DRIVER\f[R].
دنباله‌ای از الگوها (globs) پشتیبانی می‌شود که هر یک از آنها می‌تواند مطابقت داشته باشد.
تطبیق بر اساس درایور \f[I]تنها\f[R] با networkd پشتیبانی می‌شود.
.RE
.RE
.PP
مثال‌ها:
.IP \[bu] 2
تمام کارت‌های روی گذرگاه دوم PCI:
.RS 2
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    myinterface\f[B]:\f[R]
      match\f[B]:\f[R]
        name\f[B]:\f[R] enp2*
.EE
.RE
.IP \[bu] 2
آدرس MAC ثابت:
.RS 2
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    interface0\f[B]:\f[R]
      match\f[B]:\f[R]
        macaddress\f[B]:\f[R] 11:22:33:AA:BB:FF
.EE
.RE
.IP \[bu] 2
اولین کارت درایور \f[CR]ixgbe\f[R]:
.RS 2
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    nic0\f[B]:\f[R]
      match\f[B]:\f[R]
        driver\f[B]:\f[R] ixgbe
        name\f[B]:\f[R] en*s0
.EE
.RE
.IP \[bu] 2
اولین کارت با درایوری منطبق با \f[CR]bcmgenet\f[R] یا \f[CR]smsc*\f[R]:
.RS 2
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    nic0\f[B]:\f[R]
      match\f[B]:\f[R]
        driver\f[B]:\f[R] \f[B][\f[R]\[dq]bcmgenet\[dq]\f[B],\f[R] \[dq]smsc*\[dq]\f[B]]\f[R]
        name\f[B]:\f[R] en*
.EE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]set\-name\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
هنگام تطبیق بر روی ویژگی‌های یکتا مانند مسیر یا MAC، یا با فرضیات اضافی مانند «تنها یک دستگاه وای‌فای وجود خواهد داشت»، قوانین تطبیق را می‌توان طوری نوشت که تنها با یک دستگاه مطابقت داشته باشند.
سپس می‌توان از این ویژگی استفاده کرد تا نام خاص‌تر یا مطلوب‌تری نسبت به نام پیش‌فرض udev ifnames به آن دستگاه اختصاص داده شود.
هر دستگاه اضافی که قوانین تطبیق را برآورده کند، در تغییر نام ناموفق خواهد بود و نام اصلی هسته را حفظ می‌کند (و \f[CR]dmesg\f[R] یک خطا را نشان می‌دهد).
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]wakeonlan\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
قابلیت Wake on LAN را فعال می‌کند.
به طور پیش‌فرض غیرفعال (خاموش) است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]emit\-lldp\f[B]\f[R] (بولی) \[en] از نسخه 0.99
.RS 2
.RS
.PP
(فقط بک‌اند networkd) ارسال بسته‌های LLDP را مشخص می‌کند.
به طور پیش‌فرض غیرفعال است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]receive\-checksum\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری سخت‌افزاری برای محاسبه چکسام بسته‌های ورودی شبکه فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]transmit\-checksum\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری سخت‌افزاری برای محاسبه چکسام بسته‌های خروجی شبکه فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]tcp\-segmentation\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری قطعه‌بندی TCP (یا TSO) فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]tcp6\-segmentation\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری قطعه‌بندی TCP6 (\f[CR]tx\-tcp6\-segmentation\f[R]) فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]generic\-segmentation\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری قطعه‌بندی عمومی (GSO) فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]generic\-receive\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری دریافت عمومی (GRO) فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]large\-receive\-offload\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) اگر روی \f[CR]true\f[R] (\f[CR]false\f[R]) تنظیم شود، برون‌سپاری دریافت بزرگ (LRO) فعال (غیرفعال) می‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]openvswitch\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
این ویژگی پیکربندی اضافی را برای دستگاه شبکه \f[CR]openvswitch\f[R] فراهم می‌کند.
اگر Open vSwitch روی سیستم در دسترس نباشد، Netplan وجود پیکربندی \f[CR]openvswitch\f[R] را به عنوان یک خطا در نظر می‌گیرد.
.PP
هر دستگاه شبکه پشتیبانی‌شده‌ای که با نگاشت \f[CR]openvswitch\f[R] اعلان شده باشد (یا هر bond/bridge که شامل رابطی با پیکربندی \f[CR]openvswitch\f[R] باشد) به جای رندرکننده تعریف‌شده، در \f[CR]openvswitch\f[R] ایجاد خواهد شد.
در صورت تعریف یک \f[CR]vlan\f[R] که به همین ترتیب اعلان شده باشد، Netplan یک پل ساختگی VLAN در \f[CR]openvswitch\f[R] با ویژگی‌های درخواستی \f[CR]vlan\f[R] ایجاد خواهد کرد.
.RE
.IP \[bu] 2
\f[B]\f[CB]external\-ids\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
به طور مستقیم به Open vSwitch منتقل می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]other\-config\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
به طور مستقیم به Open vSwitch منتقل می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]lacp\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bond معتبر است.
مقادیر \f[CR]active\f[R]، \f[CR]passive\f[R] یا \f[CR]off\f[R] (پیش‌فرض) را می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]fail\-mode\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bridge معتبر است.
مقادیر \f[CR]secure\f[R] یا \f[CR]standalone\f[R] (پیش‌فرض) را می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mcast\-snooping\f[B]\f[R] (بولی) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bridge معتبر است.
به طور پیش‌فرض False است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]protocols\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bridge یا بخش network معتبر است.
فهرستی از پروتکل‌هایی که باید هنگام مذاکره برای اتصال با کنترل‌کننده استفاده شوند.
مقادیر \f[CR]OpenFlow10\f[R]، \f[CR]OpenFlow11\f[R]، \f[CR]OpenFlow12\f[R]، \f[CR]OpenFlow13\f[R]، \f[CR]OpenFlow14\f[R] و \f[CR]OpenFlow15\f[R] را می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]rstp\f[B]\f[R] (بولی) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bridge معتبر است.
به طور پیش‌فرض False است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]controller\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای رابط‌های bridge معتبر است.
یک کنترل‌کننده خارجی OpenFlow را مشخص می‌کند.
.RE
.IP \[bu] 2
\f[B]\f[CB]addresses\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
فهرستی از آدرس‌ها را برای اهداف کنترل‌کننده تنظیم می‌کند.
نحو این آدرس‌ها همان‌طور است که در \f[B]\f[CB]ovs\-vsctl\f[B]\f[R](8) تعریف شده است.
مثال: addresses:
\f[CR][tcp:127.0.0.1:6653, \[dq]ssl:[fe80::1234%eth0]:6653\[dq]]\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]connection\-mode\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت اتصال را برای کنترل‌کننده تنظیم می‌کند.
گزینه‌های پشتیبانی‌شده \f[CR]in\-band\f[R] و \f[CR]out\-of\-band\f[R] هستند.
مقدار پیش‌فرض \f[CR]in\-band\f[R] است.
.RE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ports\f[B]\f[R] (دنباله‌ای از دنباله‌های اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
پورت‌های پچ Open vSwitch.
هر پورت به عنوان یک جفت نام اعلان می‌شود که می‌توان به عنوان رابط در دستگاه‌های مجازی وابسته (bonds، bridges) به آنها ارجاع داد.
.RE
.PP
مثال:
.IP
.EX
openvswitch\f[B]:\f[R]
  ports\f[B]:\f[R]
    \f[B]\-\f[R] \f[B][\f[R]patch0\-1\f[B],\f[R] patch1\-0\f[B]]\f[R]
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]ssl\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای تنظیمات سراسری \f[CR]openvswitch\f[R] معتبر است.
گزینه‌هایی برای پیکربندی نقطه پایانی سرور SSL برای سوئیچ.
.RE
.IP \[bu] 2
\f[B]\f[CB]ca\-cert\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی که حاوی گواهی CA مورد استفاده است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]certificate\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی که حاوی گواهی سرور است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]private\-key\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی که حاوی کلید خصوصی برای سرور است.
.RE
.RE
.RE
.RE

.SS "ویژگی‌های تمام انواع دستگاه‌ها (Properties for all device types)"
.IP \[bu] 2
\f[B]\f[CB]renderer\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
از بک‌اند شبکه داده‌شده برای این تعریف استفاده کنید.
در حال حاضر \f[CR]networkd\f[R] و \f[CR]NetworkManager\f[R] پشتیبانی می‌شوند.
این ویژگی را می‌توان به صورت سراسری در \f[CR]network:\f[R]، برای یک نوع دستگاه (مثلاً در \f[CR]ethernets:\f[R]) یا برای یک تعریف دستگاه خاص مشخص کرد.
پیش‌فرض \f[CR]networkd\f[R] است.
.PP
(از نسخه 0.99) ویژگی \f[CR]renderer\f[R] یک مقدار قابل قبول اضافی برای شیء‌های VLAN دارد (یعنی تعریف‌شده در \f[CR]vlans:\f[R]): \f[CR]sriov\f[R].
اگر یک VLAN با رندرکننده \f[CR]sriov\f[R] برای یک رابط تابع مجازی (Virtual Function) SR\-IOV تعریف شود، این کار باعث می‌شود Netplan یک فیلتر VLAN سخت‌افزاری برای آن تنظیم کند.
در هر VF فقط یک مورد می‌تواند تعریف شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dhcp4\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
فعال‌سازی DHCP برای IPv4.
به طور پیش‌فرض خاموش است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dhcp6\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
فعال‌سازی DHCP برای IPv6.
به طور پیش‌فرض خاموش است.
این گزینه هم DHCP بدون وضعیت (stateless) \- جایی که سرور DHCP اطلاعاتی مانند سرورهای نام DNS را ارائه می‌دهد اما آدرس IP را تعیین نمی‌کند \- و هم DHCP دارای وضعیت (stateful) را پوشش می‌دهد، جایی که سرور هم آدرس و هم سایر اطلاعات را ارائه می‌دهد.
.PP
اگر در یک محیط منحصراً IPv6 با پیکربندی خودکار کاملاً بدون وضعیت (SLAAC به همراه RDNSS) هستید، این گزینه می‌تواند طوری تنظیم شود که باعث فعال‌سازی و بالا آمدن رابط شود.
(تنظیم \f[CR]accept\-ra\f[R] به تنهایی کافی نیست.)
پیکربندی خودکار همچنان از محتوای اعلان روتر (Router Advertisement) پیروی می‌کند و تنها در صورت درخواست در RA از DHCP استفاده خواهد کرد.
.PP
توجه داشته باشید که برای استفاده از RDNSS با networkd، به \f[B]\f[CB]rdnssd\f[B]\f[R](8) نیاز است.
هیچ نرم‌افزار اضافی برای NetworkManager مورد نیاز نیست.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ipv6\-mtu\f[B]\f[R] (اسکالر) \[en] از نسخه 0.98 > مقدار MTU برای IPv6 را تنظیم می‌کند (فقط با بک‌اند networkd پشتیبانی می‌شود).
توجه داشته باشید > که نیاز به تنظیم این مورد یک الزام غیرمعمول است.
> > \f[B]نیازمند ویژگی: \f[CB]ipv6\-mtu\f[B]\f[R]
.IP \[bu] 2
\f[B]\f[CB]ipv6\-privacy\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پسوندهای حریم خصوصی IPv6 (RFC 4941) را برای رابط مشخص‌شده فعال کرده و آدرس‌های موقت را ترجیح می‌دهد.
پیش‌فرض false است \- بدون پسوندهای حریم خصوصی.
در حال حاضر راهی برای داشتن آدرس خصوصی اما ترجیح دادن آدرس عمومی وجود ندارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]link\-local\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
آدرس‌های پیوند\-محلی (link\-local) را برای راه‌اندازی پیکربندی می‌کند.
گزینه‌های معتبر \f[CR]ipv4\f[R] و \f[CR]ipv6\f[R] هستند که به ترتیب اجازه فعال‌سازی آدرس‌دهی پیوند\-محلی IPv4 و IPv6 را می‌دهند.
اگر این فیلد تعریف نشود، پیش‌فرض فعال‌سازی تنها آدرس‌های پیوند\-محلی IPv6 است.
اگر فیلد تعریف شده اما به عنوان یک مجموعه خالی پیکربندی شود، آدرس‌های پیوند\-محلی IPv6 و همچنین آدرس‌های پیوند\-محلی IPv4 غیرفعال می‌شوند.
.PP
این ویژگی آدرس‌های پیوند\-محلی را برای یک پروتکل فعال یا غیرفعال می‌کند، اما پیاده‌سازی واقعی در هر بک‌اند متفاوت است.
در networkd، این مورد مستقیماً رفتار را تغییر می‌دهد و ممکن است یک آدرس اضافی روی یک رابط اضافه کند.
هنگام استفاده از بک‌اند NetworkManager، در صورتی که رابط DHCP را نیز فعال داشته باشد، فعال‌سازی پیوند\-محلی هیچ تاثیری ندارد.
.RE
.PP
مثال‌ها:
.IP \[bu] 2
فقط فعال‌سازی پیوند\-محلی IPv4: \f[CR]link\-local: [ ipv4 ]\f[R]
.IP \[bu] 2
فعال‌سازی تمام آدرس‌های پیوند\-محلی: \f[CR]link\-local: [ ipv4, ipv6 ]\f[R]
.IP \[bu] 2
غیرفعال‌سازی تمام آدرس‌های پیوند\-محلی: \f[CR]link\-local: [ ]\f[R]
.RE
.IP \[bu] 2
\f[B]\f[CB]ignore\-carrier\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط بک‌اند networkd) به رابط مشخص‌شده اجازه می‌دهد حتی در صورت نداشتن حامل (carrier) پیکربندی شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]critical\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
اتصال را به عنوان «حیاتی برای سیستم» (critical to the system) تعیین می‌کند، به این معنی که توجه ویژه‌ای صورت می‌گیرد تا هنگام راه‌اندازی مجدد دیمن، IP اختصاص‌یافته آزاد نشود.
(توسط NetworkManager شناخته نمی‌شود)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dhcp\-identifier\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
(فقط بک‌اند networkd) منبع شناسه کلاینت DHCP (v4) را تنظیم می‌کند.
اگر \f[CR]mac\f[R] مشخص شود، از آدرس MAC پیوند استفاده می‌شود.
اگر این گزینه حذف شود، یا اگر \f[CR]duid\f[R] مشخص شود، networkd یک شناسه کلاینت منطبق با RFC4361 برای رابط با ترکیب IAID و DUID پیوند تولید می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dhcp4\-overrides\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
(فقط بک‌اند networkd) رفتار پیش‌فرض DHCP را بازنویسی می‌کند؛ بخش \f[CR]بازنویسی‌های DHCP\f[R] را در زیر ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]dhcp6\-overrides\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
(فقط بک‌اند networkd) رفتار پیش‌فرض DHCP را بازنویسی می‌کند؛ بخش \f[CR]بازنویسی‌های DHCP\f[R] را در زیر ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]accept\-ra\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
اعلان‌های روتر (Router Advertisement) را که باعث می‌شود هسته به خودی خود IPv6 را پیکربندی کند، می‌پذیرد.
هنگامی که فعال باشد، اعلان‌های روتر پذیرفته می‌شوند.
هنگامی که غیرفعال باشد، به اعلان‌های روتر پاسخی داده نمی‌شود.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته میزبان استفاده می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ra\-overrides\f[B]\f[R] (نگاشت) \[en] از نسخه 1.1
.RS 2
.RS
.PP
(فقط بک‌اند networkd) رفتار پیش‌فرض اعلان روتر IPv6 (RA) را بازنویسی می‌کند؛ بخش \f[CR]بازنویسی‌های اعلان روتر IPv6\f[R] را در زیر ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]addresses\f[B]\f[R] (دنباله‌ای از اسکالرها و نگاشت‌ها)
.RS 2
.RS
.PP
افزودن آدرس‌های ایستا به رابط علاوه بر آدرس‌های دریافت شده از طریق DHCP یا RA.
هر ورودی دنباله در نمادگذاری CIDR است، یعنی به شکل \f[CR]addr/prefixlen\f[R].
\f[CR]addr\f[R] یک آدرس IPv4 یا IPv6 است که توسط \f[B]\f[CB]inet_pton\f[B]\f[R](3) شناخته می‌شود و \f[CR]prefixlen\f[R] تعداد بیت‌های زیرشبکه است.
.PP
برای دستگاه‌های مجازی (پل‌ها، باندها، VLAN) اگر هیچ آدرسی پیکربندی نشده باشد و DHCP غیرفعال باشد، رابط ممکن است همچنان آنلاین شود، اما از طریق شبکه قابل آدرس‌دهی نخواهد بود.
.PP
علاوه بر خود آدرس‌ها، می‌توان پارامترهای پیکربندی را به صورت نگاشت مشخص کرد.
گزینه‌های پشتیبانی‌شده فعلی عبارتند از:
.RE
.IP \[bu] 2
\f[B]\f[CB]lifetime\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]forever\f[R].
این مقدار می‌تواند \f[CR]forever\f[R] یا \f[CR]0\f[R] باشد و با گزینه \f[CR]PreferredLifetime\f[R] در بخش \f[CR]Address\f[R] از \f[CR]systemd\-networkd\f[R] مطابقت دارد.
در حال حاضر فقط در بک‌اند networkd پشتیبانی می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]label\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برچسب آدرس IP، معادل دستور \f[CR]ip address label\f[R].
در حال حاضر فقط در بک‌اند networkd پشتیبانی می‌شود.
.RE
.RE
.PP
مثال‌ها:
.IP \[bu] 2
ساده: \f[CR]addresses: [192.168.14.2/24, \[dq]2001:1::1/64\[dq]]\f[R]
.IP \[bu] 2
پیشرفته:
.RS 2
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth0\f[B]:\f[R]
      addresses\f[B]:\f[R]
        \f[B]\-\f[R] \[dq]10.0.0.15/24\[dq]\f[B]:\f[R]
            lifetime\f[B]:\f[R] 0
            label\f[B]:\f[R] \[dq]maas\[dq]
        \f[B]\-\f[R] \[dq]2001:1::1/64\[dq]
.EE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ipv6\-address\-generation\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
پیکربندی روش ایجاد آدرس برای استفاده با پیکربندی خودکار آدرس بدون وضعیت IPv6 طبق RFC4862.
مقادیر ممکن \f[CR]eui64\f[R] یا \f[CR]stable\-privacy\f[R] هستند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ipv6\-address\-token\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
تعریف یک توکن آدرس IPv6 برای ایجاد یک شناسه رابط ایستا برای پیکربندی خودکار آدرس بدون وضعیت IPv6.
این گزینه با \f[CR]ipv6\-address\-generation\f[R] مانعة‌الجمع است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]gateway4\f[B]\f[R]، \f[B]\f[CB]gateway6\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
منسوخ شده است، مسیرهای پیش‌فرض را ببینید.
تنظیم دروازه (gateway) پیش‌فرض برای IPv4/6، برای پیکربندی دستی آدرس.
این مورد نیازمند تنظیم \f[CR]addresses\f[R] نیز می‌باشد.
آدرس‌های IP دروازه باید در قالبی باشند که توسط \f[B]\f[CB]inet_pton\f[B]\f[R](3) شناخته می‌شود.
در پیکربندی سراسری شما تنها باید یک دروازه به ازای هر خانواده آدرس IP تنظیم شود تا ابهامی وجود نداشته باشد.
در صورت نیاز به چندین مسیر پیش‌فرض، لطفاً آنها را از طریق \f[CR]routing\-policy\f[R] تعریف کنید.
.RE
.PP
مثال‌ها:
.IP \[bu] 2
IPv4: \f[CR]gateway4: 172.16.0.1\f[R]
.IP \[bu] 2
IPv6: \f[CR]gateway6: \[dq]2001:4::1\[dq]\f[R]
.RE
.IP \[bu] 2
\f[B]\f[CB]nameservers\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
تنظیم سرورهای DNS و دامنه‌های جستجو، برای پیکربندی دستی آدرس.
دو فیلد پشتیبانی‌شده وجود دارد: \f[CR]addresses:\f[R] فهرستی از آدرس‌های IPv4 یا IPv6 مشابه با \f[CR]gateway*\f[R] است، و \f[CR]search:\f[R] فهرستی از دامنه‌های جستجو است.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    id0\f[B]:\f[R]
      \f[B][\f[R]...\f[B]]\f[R]
      nameservers\f[B]:\f[R]
        search\f[B]:\f[R] \f[B][\f[R]lab\f[B],\f[R] home\f[B]]\f[R]
        addresses\f[B]:\f[R] \f[B][\f[R]8.8.8.8\f[B],\f[R] \[dq]FEDC::1\[dq]\f[B]]\f[R]
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]macaddress\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تنظیم آدرس MAC دستگاه.
آدرس MAC باید در قالب \[dq]XX:XX:XX:XX:XX:XX\[dq] باشد.
گزینه‌های ویژه زیر نیز پذیرفته می‌شوند: \f[CR]permanent\f[R] و \f[CR]random\f[R].
علاوه بر این گزینه‌ها، رندرکننده NetworkManager مقادیر \f[CR]stable\f[R]، \f[CR]stable\-ssid\f[R] (فقط وای‌فای) و \f[CR]preserve\f[R] را نیز می‌پذیرد.
.PP
\f[B]نکته:\f[R] این گزینه برای دستگاه‌هایی که فقط بر اساس نام مطابقت داده شده و توسط networkd رندر می‌شوند، به دلیل تداخل با تغییر نام دستگاه در udev، به درستی کار نخواهد کرد.
هنگام تنظیم آدرس‌های MAC دستگاه‌ها را بر اساس MAC تطبیق دهید.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    id0\f[B]:\f[R]
      match\f[B]:\f[R]
        macaddress\f[B]:\f[R] 52:54:00:6b:3c:58
      \f[B][\f[R]...\f[B]]\f[R]
      macaddress\f[B]:\f[R] 52:54:00:6b:3c:59
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]mtu\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تنظیم واحد بیشینه انتقال (MTU) برای رابط.
پیش‌فرض 1500 است.
مقادیر معتبر به رابط شبکه شما بستگی دارد.
.PP
\f[B]نکته:\f[R] این گزینه برای دستگاه‌هایی که فقط بر اساس نام مطابقت داده شده و توسط networkd رندر می‌شوند، به دلیل تداخل با تغییر نام دستگاه در udev، به درستی کار نخواهد کرد.
هنگام تنظیم MTU دستگاه‌ها را بر اساس MAC تطبیق دهید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]optional\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
یک دستگاه اختیاری برای راه‌اندازی سیستم (booting) الزامی نیست.
به طور معمول، networkd قبل از ادامه راه‌اندازی مدتی منتظر می‌ماند تا دستگاه پیکربندی شود.
با این حال، اگر یک دستگاه به عنوان اختیاری علامت‌گذاری شود، networkd منتظر آن نخواهد ماند.
این گزینه \f[I]تنها\f[R] توسط networkd پشتیبانی می‌شود و مقدار پیش‌فرض false است.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth7\f[B]:\f[R]
\f[I]      # این به یک شبکه آزمایشی متصل است که اغلب\f[R]
\f[I]      # قطع است - در طول بوت منتظر بالا آمدن آن نباشید.\f[R]
      dhcp4\f[B]:\f[R] true
      optional\f[B]:\f[R] true
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]optional\-addresses\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
تعیین انواع آدرس‌هایی که برای آنلاین در نظر گرفته شدن یک دستگاه الزامی نیستند.
این کار رفتار بک‌اندها را در زمان راه‌اندازی تغییر می‌دهد تا از انتظار برای آدرس‌هایی که اختیاری علامت‌گذاری شده‌اند جلوگیری شود و در نتیجه رابط زودتر به عنوان «قابل استفاده» در نظر گرفته شود.
این کار این آدرس‌ها را غیرفعال نمی‌کند و آنها در هر صورت بالا خواهند آمد.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth7\f[B]:\f[R]
      dhcp4\f[B]:\f[R] true
      dhcp6\f[B]:\f[R] true
      optional\-addresses\f[B]:\f[R] \f[B][\f[R] ipv4\-ll\f[B],\f[R] dhcp6 \f[B]]\f[R]
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]activation\-mode\f[B]\f[R] (اسکالر) \[en] از نسخه 0.103
.RS 2
.RS
.PP
امکان تعیین خط‌مشی مدیریت رابط انتخاب‌شده را فراهم می‌کند.
به طور پیش‌فرض، Netplan هر رابط پیکربندی‌شده را در صورت امکان بالا می‌آورد.
با استفاده از تنظیم \f[CR]activation\-mode\f[R] کاربران می‌توانند آن رفتار را لغو کرده و با تعیین \f[CR]manual\f[R]، کنترل وضعیت رابط را به مدیر سیستم واگذار کنند یا (\f[I]فقط\f[R] برای بک‌اند networkd) با تعیین \f[CR]off\f[R] پیوند را در تمام اوقات در حالت خاموش (down) نگه دارند.
هر رابطی که \f[CR]activation\-mode\f[R] برای آن تعریف شده باشد، به صورت ضمنی \f[CR]optional\f[R] در نظر گرفته می‌شود.
به طور رسمی از networkd نسخه v248+ پشتیبانی می‌شود.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth1\f[B]:\f[R]
\f[I]      # این رابط به طور خودکار در وضعیت UP قرار نخواهد گرفت\f[R]
      dhcp4\f[B]:\f[R] true
      activation\-mode\f[B]:\f[R] manual
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]routes\f[B]\f[R] (دنباله‌ای از نگاشت‌ها)
.RS 2
.RS
.PP
مسیریابی ایستا را برای دستگاه پیکربندی می‌کند؛ بخش \f[CR]مسیریابی\f[R] را در زیر ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]routing\-policy\f[B]\f[R] (دنباله‌ای از نگاشت‌ها)
.RS 2
.RS
.PP
مسیریابی مبتنی بر خط‌مشی (Policy Routing) را برای دستگاه پیکربندی می‌کند؛ بخش \f[CR]مسیریابی\f[R] را در زیر ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]neigh\-suppress\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
مشخص می‌کند که آیا سرکوب همسایه (Neighbour Suppression) برای ARP و ND برای این پورت پل فعال است یا خیر.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]hairpin\f[B]\f[R] (اسکالر) \[en] از نسخه \f[B]1.0\f[R]
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
مشخص می‌کند که آیا ترافیک مجاز است به همان پورت پلی که از آن دریافت شده بازگردانده شود یا خیر.
هنگامی که این پرچم false باشد، پل ترافیک را به پورت دریافت‌کننده بازنمی‌فرستد.
در صورت عدم تنظیم، از \f[CR]پیش‌فرض\f[R] بک‌اند استفاده می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]port\-mac\-learning\f[B]\f[R] (اسکالر) \[en] از نسخه \f[B]1.0\f[R]
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
مشخص می‌کند که آیا یادگیری آدرس MAC برای این پورت پل فعال است یا خیر.
در صورت عدم تنظیم، از مقدار پیش‌فرض هسته استفاده می‌شود.
در حال حاضر فقط در بک‌اند \f[CR]networkd\f[R] پشتیبانی می‌شود.
.RE
.RE
.SS "بازنویسی‌های DHCP (DHCP Overrides)"
چندین بازنویسی رفتار DHCP در دسترس است.
در حال حاضر اکثر آنها فقط هنگام استفاده از بک‌اند \f[CR]networkd\f[R] تاثیر دارند، به استثنای \f[CR]use\-routes\f[R] و \f[CR]route\-metric\f[R].
.PP
بازنویسی‌ها تنها در صورتی اثر دارند که \f[CR]dhcp4\f[R] یا \f[CR]dhcp6\f[R] مربوطه روی \f[CR]true\f[R] تنظیم شده باشد.
.PP
اگر هم \f[CR]dhcp4\f[R] و هم \f[CR]dhcp6\f[R] برابر \f[CR]true\f[R] باشند، بک‌اند networkd نیازمند آن است که \f[CR]dhcp4\-overrides\f[R] و \f[CR]dhcp6\-overrides\f[R] شامل کلیدها و مقادیر یکسانی باشند.
اگر مقادیر مطابقت نداشته باشند، خطایی نمایش داده می‌شود و پیکربندی شبکه اعمال نخواهد شد.
.PP
هنگام استفاده از بک‌اند NetworkManager، مقادیر مختلفی را می‌توان برای \f[CR]dhcp4\-overrides\f[R] و \f[CR]dhcp6\-overrides\f[R] مشخص کرد و مطابق با Netplan YAML به فرایندهای کلاینت DHCP اعمال خواهد شد.
.IP \[bu] 2
\f[B]\f[CB]dhcp4\-overrides\f[B]\f[R]،
\f[B]\f[CB]dhcp6\-overrides\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
نگاشت‌های \f[CR]dhcp4\-overrides\f[R] و \f[CR]dhcp6\-overrides\f[R] رفتار پیش‌فرض DHCP را بازنویسی می‌کنند.
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-dns\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، سرورهای DNS دریافت‌شده از سرور DHCP استفاده می‌شوند و بر هر سرور پیکربندی‌شده به صورت ایستا اولویت خواهند داشت.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-ntp\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، سرورهای NTP دریافت‌شده از سرور DHCP توسط \f[CR]systemd\-timesyncd\f[R] استفاده می‌شوند و بر هر سرور پیکربندی‌شده به صورت ایستا اولویت خواهند داشت.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]send\-hostname\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، نام میزبان ماشین (hostname) به سرور DHCP ارسال می‌شود.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-hostname\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، نام میزبان دریافت‌شده از سرور DHCP به عنوان نام میزبان گذرا (transient hostname) سیستم تنظیم می‌شود.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-mtu\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، مقدار MTU دریافت‌شده از سرور DHCP به عنوان MTU رابط شبکه تنظیم می‌شود.
هنگامی که \f[CR]false\f[R] باشد، MTU اعلام‌شده توسط سرور DHCP نادیده گرفته می‌شود.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]hostname\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
از این مقدار به جای نام میزبان ماشین برای ارسال به سرور DHCP استفاده کنید.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-routes\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، مسیرهای دریافت‌شده از سرور DHCP به طور معمول در جدول مسیریابی نصب می‌شوند.
هنگامی که روی \f[CR]false\f[R] تنظیم شود، مسیرهای سرور DHCP نادیده گرفته می‌شوند: در این حالت، در صورت نیاز به عملکرد صحیح شبکه، مسئولیت افزودن مسیرهای ایستا بر عهده کاربر است.
این به کاربران اجازه می‌دهد تا از نصب دروازه پیش‌فرض برای رابط‌های پیکربندی‌شده از طریق DHCP جلوگیری کنند.
برای هر دو بک‌اند networkd و \f[CR]NetworkManager\f[R] در دسترس است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]route\-metric\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
از این مقدار به عنوان متریک پیش‌فرض برای مسیرهای اضافه‌شده خودکار استفاده کنید.
از این مورد برای اولویت‌بندی مسیرها برای دستگاه‌ها با تنظیم متریک پایین‌تر روی رابط ترجیحی استفاده کنید.
برای هر دو بک‌اند networkd و NetworkManager در دسترس است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-domains\f[B]\f[R] (اسکالر) \[en] از نسخه 0.98
.RS 2
.RS
.PP
یک مقدار بولی یا مقدار ویژه \f[CR]route\f[R] را می‌پذیرد.
هنگامی که true باشد، نام دامنه دریافت‌شده از سرور DHCP به عنوان دامنه جستجوی DNS روی این پیوند استفاده می‌شود، مشابه اثر تنظیم \f[CR]Domains=\f[R].
اگر روی \f[CR]route\f[R] تنظیم شود، نام دامنه دریافت‌شده از سرور DHCP تنها برای مسیریابی درخواست‌های DNS استفاده می‌شود و نه برای جستجو، مشابه اثر تنظیم \f[CR]Domains=\f[R] هنگامی که آرگومان با \f[CR]\[ti]\f[R] (تیلدا) پیشوند شده است.
.PP
\f[B]نیازمند ویژگی: \f[CB]dhcp\-use\-domains\f[B]\f[R]
.RE
.RE
.RE
.SS "بازنویسی‌های اعلان روتر IPv6 (IPv6 Router Advertisement Overrides)"
بازنویسی‌هایی برای رفتار اعلان روتر (RA) در IPv6 (فقط با بک‌اند networkd پشتیبانی می‌شود).
.IP \[bu] 2
\f[B]\f[CB]ra\-overrides\f[B]\f[R] (نگاشت) \[en] از نسخه 1.1
.RS 2
.RS
.PP
نگاشت‌های \f[CR]ra\-overrides\f[R] رفتار پیش‌فرض اعلان روتر IPv6 را بازنویسی می‌کنند.
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-dns\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
پیش‌فرض: \f[CR]true\f[R].
هنگامی که \f[CR]true\f[R] باشد، سرورهای DNS دریافت‌شده از اعلان روتر استفاده خواهند شد.
در حال حاضر فقط روی بک‌اند networkd تاثیر دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]use\-domains\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
یک مقدار بولی یا مقدار ویژه \f[CR]route\f[R] را می‌پذیرد.
هنگامی که true باشد، نام دامنه دریافت‌شده از اعلان روتر به عنوان دامنه جستجوی DNS روی این پیوند استفاده خواهد شد.
اگر روی \f[CR]route\f[R] تنظیم شود، نام دامنه دریافت‌شده از IPv6 RA تنها برای مسیریابی درخواست‌های DNS استفاده خواهد شد و نه برای جستجو.
پیش‌فرض \f[CR]false\f[R] است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]table\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
شماره جدول مسیریابی برای مسیرهای دریافت‌شده در IPv6 RA.
مقادیر مجاز اعداد صحیح مثبت هستند که از ۱ شروع می‌شوند.
برخی مقادیر از قبل برای اشاره به جداول مسیریابی خاص استفاده شده‌اند: \f[CR]{/etc,/usr/share}/iproute2/rt_tables\f[R] را ببینید.
.RE
.RE
.RE

.SS "مسیریابی (Routing)"
مسیریابی پیچیده با Netplan امکان‌پذیر است.
مسیرهای ایستای استاندارد و همچنین مسیریابی مبتنی بر خط‌مشی با استفاده از جداول مسیریابی از طریق بک‌اند networkd پشتیبانی می‌شوند.
.PP
این گزینه‌ها برای تمام انواع رابط‌ها در دسترس هستند.
.SS "مسیرهای پیش‌فرض (Default routes)"
متداول‌ترین نیاز برای مسیریابی مربوط به تعریف مسیرهای پیش‌فرض برای دسترسی به اینترنت گسترده‌تر است.
این مسیرهای پیش‌فرض فقط یک بار به ازای هر خانواده IP و جدول مسیریابی قابل تعریف هستند.
یک مثال معمولی به صورت زیر خواهد بود:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth0\f[B]:\f[R]
      \f[B][\f[R]...\f[B]]\f[R]
      routes\f[B]:\f[R]
        \f[B]\-\f[R] to\f[B]:\f[R] default\f[I] # می‌تواند به صورت اختیاری 0.0.0.0/0 باشد\f[R]
          via\f[B]:\f[R] 10.0.0.1
          metric\f[B]:\f[R] 100
          on\-link\f[B]:\f[R] true
          advertised\-mss\f[B]:\f[R] 1400
        \f[B]\-\f[R] to\f[B]:\f[R] default\f[I] # می‌تواند به صورت اختیاری ::/0 باشد\f[R]
          via\f[B]:\f[R] cf02:de:ad:be:ef::2
    eth1\f[B]:\f[R]
      \f[B][\f[R]...\f[B]]\f[R]
      routes\f[B]:\f[R]
        \f[B]\-\f[R] to\f[B]:\f[R] default
          via\f[B]:\f[R] 172.134.67.1
          metric\f[B]:\f[R] 100
          on\-link\f[B]:\f[R] true
\f[I]          # در جدول مسیریابی اصلی نیست،\f[R]
\f[I]          # با مسیر پیش‌فرض eth0 تداخل ندارد\f[R]
      table\f[B]:\f[R] 76
.EE
.IP \[bu] 2
\f[B]\f[CB]routes\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
بلوک \f[CR]routes\f[R] مسیرهای ایستای استاندارد را برای یک رابط تعریف می‌کند.
حداقل مقدار \f[CR]to\f[R] باید مشخص شود.
اگر نوع \f[CR]local\f[R] یا \f[CR]nat\f[R] باشد، محدوده پیش‌فرض \f[CR]host\f[R] فرض می‌شود.
اگر نوع \f[CR]unicast\f[R] باشد و هیچ دروازه‌ای (\f[CR]via\f[R]) داده نشود یا نوع \f[CR]broadcast\f[R]، \f[CR]multicast\f[R] یا \f[CR]anycast\f[R] باشد، محدوده پیش‌فرض \f[CR]link\f[R] فرض می‌شود.
در غیر این صورت، محدوده \f[CR]global\f[R] تنظیم پیش‌فرض است.
.PP
برای \f[CR]from\f[R]، \f[CR]to\f[R] و \f[CR]via\f[R]، هر دو آدرس IPv4 و IPv6 شناخته می‌شوند و باید به شکل \f[CR]addr/prefixlen\f[R] یا \f[CR]addr\f[R] باشند.
.RE
.IP \[bu] 2
\f[B]\f[CB]from\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
یک آدرس IP مبدأ برای ترافیکی که از این مسیر عبور می‌کند تنظیم می‌کند.
(NetworkManager: از نسخه v1.8.0 به بعد)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]to\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
آدرس مقصد برای مسیر.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]via\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
آدرس دروازه‌ای (gateway) که باید برای این مسیر استفاده شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]on\-link\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
هنگامی که روی \f[CR]true\f[R] تنظیم شود، مشخص می‌کند که مسیر مستقیماً به رابط متصل است.
(\f[CR]NetworkManager\f[R]: از نسخه v1.12.0 برای IPv4 و v1.18.0 برای IPv6)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]metric\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
اولویت نسبی مسیر.
باید یک مقدار عدد صحیح مثبت باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]type\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
نوع مسیر.
گزینه‌های معتبر عبارتند از: \f[CR]unicast\f[R] (پیش‌فرض)، \f[CR]anycast\f[R]، \f[CR]blackhole\f[R]، \f[CR]broadcast\f[R]، \f[CR]local\f[R]، \f[CR]multicast\f[R]، \f[CR]nat\f[R]، \f[CR]prohibit\f[R]، \f[CR]throw\f[R]، \f[CR]unreachable\f[R] یا \f[CR]xresolve\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]scope\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
محدوده (scope) مسیر، اینکه تا چه اندازه در شبکه گسترده است.
مقادیر ممکن \f[CR]global\f[R]، \f[CR]link\f[R] یا \f[CR]host\f[R] هستند.
فقط برای IPv4 کاربرد دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]table\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
شماره جدول مورد استفاده برای مسیر.
در برخی سناریوها، ممکن است تنظیم مسیرها در یک جدول مسیریابی جداگانه مفید باشد.
همچنین ممکن است برای ارجاع به قوانین خط‌مشی مسیریابی که پارامتر \f[CR]table\f[R] را نیز می‌پذیرند استفاده شود.
مقادیر مجاز اعداد صحیح مثبت هستند که از ۱ شروع می‌شوند.
برخی مقادیر از قبل برای اشاره به جداول مسیریابی خاص استفاده شده‌اند: \f[CR]/etc/iproute2/rt_tables\f[R] را ببینید.
(\f[CR]NetworkManager\f[R]: از نسخه v1.10.0 به بعد)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mtu\f[B]\f[R] (اسکالر) \[en] از نسخه 0.101
.RS 2
.RS
.PP
مقدار MTU مورد استفاده برای مسیر، بر حسب بایت.
باید یک مقدار عدد صحیح مثبت باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]congestion\-window\f[B]\f[R] (اسکالر) \[en] از نسخه 0.102
.RS 2
.RS
.PP
پنجره ازدحام (congestion window) مورد استفاده برای مسیر که با تعداد بخش‌ها (segments) نمایش داده می‌شود.
باید یک مقدار عدد صحیح مثبت باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]advertised\-receive\-window\f[B]\f[R] (اسکالر) \[en] از نسخه 0.102
.RS 2
.RS
.PP
پنجره دریافت اعلام‌شده برای مسیر که با تعداد بخش‌ها نمایش داده می‌شود.
باید یک مقدار عدد صحیح مثبت باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]advertised\-mss\f[B]\f[R] (اسکالر) \[en] از نسخه 1.1
.RS 2
.RS
.PP
حداکثر اندازه بخش (MSS یا \[aq]Maximal Segment Size\[aq]) که هنگام برقراری اتصالات TCP به این مقاصد اعلام می‌شود.
اگر داده نشود، لینوکس از یک مقدار پیش‌فرض که از MTU دستگاه اولین گام (hop) محاسبه می‌شود استفاده می‌کند.
باید یک عدد صحیح مثبت باشد.
.RE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]routing\-policy\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
بلوک \f[CR]routing\-policy\f[R] خط‌مشی مسیریابی اضافی را برای یک شبکه تعریف می‌کند، جایی که ترافیک ممکن است بر اساس IP مبدأ، علامت‌گذاری فایروال و غیره به صورت ویژه مدیریت شود.
.PP
برای \f[CR]from\f[R]، \f[CR]to\f[R]، هر دو آدرس IPv4 و IPv6 شناخته می‌شوند و باید به شکل \f[CR]addr/prefixlen\f[R] یا \f[CR]addr\f[R] باشند.
.RE
.IP \[bu] 2
\f[B]\f[CB]from\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
یک آدرس IP مبدأ برای تطبیق ترافیک برای این قانون خط‌مشی تنظیم می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]to\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تطبیق روی ترافیکی که به مقصد مشخص‌شده می‌رود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]table\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
شماره جدول برای تطبیق مسیر.
در برخی سناریوها، ممکن است تنظیم مسیرها در یک جدول مسیریابی جداگانه مفید باشد.
همچنین ممکن است برای ارجاع به مسیرهایی که پارامتر \f[CR]table\f[R] را نیز می‌پذیرند استفاده شود.
مقادیر مجاز اعداد صحیح مثبت هستند که از \f[CR]1\f[R] شروع می‌شوند.
برخی مقادیر از قبل برای اشاره به جداول مسیریابی خاص استفاده شده‌اند: \f[CR]/etc/iproute2/rt_tables\f[R] را ببینید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]priority\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
یک اولویت برای قانون خط‌مشی مسیریابی تعیین می‌کند تا بر ترتیبی که قوانین مسیریابی پردازش می‌شوند تأثیر بگذارد.
عدد بالاتر به معنای اولویت کمتر است: قوانین به ترتیب افزایش شماره اولویت پردازش می‌شوند.
تعیین یک اولویت صریح و یکتا برای هر قانون خط‌مشی مسیریابی به شدت توصیه می‌شود و در بک‌اند \f[CR]NetworkManager\f[R] اجباری است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mark\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
این قانون خط‌مشی مسیریابی را با ترافیکی که توسط فایروال iptables با این مقدار علامت‌گذاری شده تطبیق می‌دهد.
مقادیر مجاز اعداد صحیح مثبت هستند که از \f[CR]1\f[R] شروع می‌شوند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]type\-of\-service\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
این قانون خط‌مشی را بر اساس شماره نوع سرویس (Type of Service) اعمال‌شده به ترافیک تطبیق می‌دهد.
.RE
.RE
.RE
.PP
(yaml\-auth)= ## احراز هویت
.PP
Netplan با استفاده از بلوک \f[CR]auth\f[R] از تنظیمات پیشرفته احراز هویت برای رابط‌های اترنت و وای‌فای و همچنین شبکه‌های وای‌فای جداگانه پشتیبانی می‌کند.
.IP \[bu] 2
\f[B]\f[CB]auth\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
تنظیمات احراز هویت را برای دستگاهی از نوع \f[CR]ethernets:\f[R] یا یک ورودی \f[CR]access\-points:\f[R] در یک دستگاه \f[CR]wifis:\f[R] مشخص می‌کند.
.PP
بلوک \f[CR]auth\f[R] از ویژگی‌های زیر پشتیبانی می‌کند:
.RE
.IP \[bu] 2
\f[B]\f[CB]key\-management\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت‌های مدیریت کلید پشتیبانی‌شده عبارتند از: \f[CR]none\f[R] (بدون مدیریت کلید)؛ \f[CR]psk\f[R] (WPA با کلید پیش‌اشتراکی، متداول برای وای‌فای خانگی)؛ \f[CR]psk\-sha256\f[R] (WPA2 با کلید پیش‌اشتراکی، متداول برای وای‌فای خانگی)؛ \f[CR]eap\f[R] (WPA با EAP، متداول برای وای‌فای سازمانی)؛ \f[CR]eap\-sha256\f[R] (مورد استفاده با WPA3\-Enterprise)؛ \f[CR]eap\-suite\-b\-192\f[R] (مورد استفاده با WPA3\-Enterprise)؛ \f[CR]sae\f[R] (مورد استفاده توسط WPA3)؛ و \f[CR]802.1x\f[R] (عمدتاً برای اتصالات سیمی اترنت استفاده می‌شود).
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]password\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
رشته گذرواژه برای EAP، یا کلید پیش‌اشتراکی برای WPA\-PSK.
.RE
.PP
ویژگی‌های زیر در صورتی قابل استفاده هستند که \f[CR]key\-management\f[R] برابر با \f[CR]eap\f[R] یا \f[CR]802.1x\f[R] باشد:
.RE
.IP \[bu] 2
\f[B]\f[CB]method\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
روش EAP مورد استفاده.
روش‌های EAP پشتیبانی‌شده عبارتند از: \f[CR]tls\f[R] (TLS)، \f[CR]peap\f[R] (EAP محافظت‌شده)، \f[CR]leap\f[R] (EAP سبک‌وزن)، \f[CR]pwd\f[R] (گذرواژه EAP) و \f[CR]ttls\f[R] (TLS تونل‌شده).
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]identity\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
هویت (identity) مورد استفاده برای EAP.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]anonymous\-identity\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
هویتی که در صورت پشتیبانی روش EAP انتخاب‌شده از ارسال یک هویت تونل‌شده متفاوت، باید از طریق کانال رمزگذاری‌نشده ارسال شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ca\-certificate\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی با یک یا چند گواهی مرجع صدور گواهی (CA) معتمد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]client\-certificate\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی حاوی گواهی مورد استفاده کلاینت در طول احراز هویت.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]client\-key\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مسیر فایلی حاوی کلید خصوصی مربوط به \f[CR]client\-certificate\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]client\-key\-password\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
گذرواژه مورد استفاده برای رمزگشایی کلید خصوصی مشخص‌شده در \f[CR]client\-key\f[R] در صورت رمزگذاری بودن آن.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]phase2\-auth\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
سازوکار احراز هویت فاز ۲ (Phase 2).
.RE
.RE
.RE
.SS "ویژگی‌های نوع دستگاه \f[CR]ethernets\f[R] (Properties for device type ethernets)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]ethernets\f[R] برای پیکربندی رابط‌های اترنت استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از شناسه‌های رابط اترنت است.
هر \f[CR]ethernet\f[R] دارای تعدادی گزینه پیکربندی است.
نیازی نیست هر رابط را با نام آن در داخل نگاشت \f[CR]ethernets\f[R] تعریف کنید.
می‌توانید از هر شناسه‌ای که رابط را توصیف می‌کند استفاده کرده و کارت شبکه واقعی را با استفاده از کلید \f[CR]match\f[R] تطبیق دهید.
ساختار کلی پیکربندی برای اترنت در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    device\-id\f[B]:\f[R]
      ...
.EE
.PP
\f[CR]device\-id\f[R] شناسه رابط است.
اگر از نام رابط به عنوان شناسه استفاده کنید، Netplan آن رابط را مطابقت خواهد داد.
.PP
مثال زیر را در نظر بگیرید.
در این حالت، رابطی به نام \f[CR]eth0\f[R] با DHCP پیکربندی می‌شود:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth0\f[B]:\f[R]
      dhcp4\f[B]:\f[R] true
.EE
.PP
مقدار \f[CR]device\-id\f[R] می‌تواند هر نام توصیفی باشد که معنادار می‌دانید.
با این حال، اگر با نام واقعی رابط مطابقت نداشته باشد، باید از ویژگی \f[CR]match\f[R] برای شناسایی دستگاهی که می‌خواهید پیکربندی کنید استفاده نمایید.
.PP
مثال زیر یک اتصال اترنت به نام \f[CR]isp\-interface\f[R] (احتمالاً یک رابط خارجی متصل به ارائه‌دهنده خدمات اینترنت) تعریف می‌کند و از \f[CR]match\f[R] برای اعمال پیکربندی به دستگاه فیزیکی با آدرس MAC برابر با \f[CR]aa:bb:cc:00:11:22\f[R] استفاده می‌کند:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    isp\-interface\f[B]:\f[R]
      match\f[B]:\f[R]
        macaddress\f[B]:\f[R] aa:bb:cc:00:11:22
      dhcp4\f[B]:\f[R] true
.EE
.PP
تعاریف دستگاه اترنت، علاوه بر موارد مشترک توصیف‌شده در بالا، از برخی ویژگی‌های اضافی نیز پشتیبانی می‌کنند که می‌توان برای دستگاه‌های SR\-IOV استفاده کرد.
.IP \[bu] 2
\f[B]\f[CB]link\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
(فقط دستگاه‌های SR\-IOV) ویژگی \f[CR]link\f[R] دستگاه را به عنوان یک تابع مجازی (Virtual Function) از دستگاه تابع فیزیکی (Physical Function) انتخاب‌شده، همان‌طور که توسط شناسه Netplan داده‌شده مشخص شده است، اعلان می‌کند.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    enp1\f[B]:\f[R] \f[B]{\f[R]...\f[B]}\f[R]
    enp1s16f1\f[B]:\f[R]
      link\f[B]:\f[R] enp1
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]virtual\-function\-count\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
(فقط دستگاه‌های SR\-IOV) در موارد خاص ممکن است نیاز باشد VFها خارج از Netplan پیکربندی شوند.
برای چنین پیکربندی‌هایی، \f[CR]virtual\-function\-count\f[R] می‌تواند به صورت اختیاری برای تنظیم تعداد صریح توابع مجازی برای تابع فیزیکی داده‌شده استفاده شود.
در صورت عدم تنظیم، پیش‌فرض ایجاد تنها به همان تعداد VF است که در پیکربندی Netplan تعریف شده است.
این مورد فقط باید برای موارد خاص استفاده شود.
.PP
\f[B]نیازمند ویژگی: \f[CB]sriov\f[B]\f[R]
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]embedded\-switch\-mode\f[B]\f[R] (اسکالر) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط دستگاه‌های SR\-IOV) تغییر حالت عملیاتی سوئیچ تعبیه‌شده یک دستگاه PCI SmartNIC پشتیبانی‌شده (مانند Mellanox ConnectX\-5).
مقادیر ممکن \f[CR]switchdev\f[R] یا \f[CR]legacy\f[R] هستند؛ در صورت عدم تعیین، از پیکربندی پیش‌فرض سازنده استفاده می‌شود.
.PP
\f[B]نیازمند ویژگی: \f[CB]eswitch\-mode\f[B]\f[R]
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]delay\-virtual\-functions\-rebind\f[B]\f[R] (بولی) \[en] از نسخه 0.104
.RS 2
.RS
.PP
(فقط دستگاه‌های SR\-IOV) به تأخیر انداختن اتصال مجدد توابع مجازی SR\-IOV به درایور آن پس از تغییر تنظیمات embedded\-switch\-mode به مرحله بعد.
هنگام استفاده از bonding/VF LAG می‌توان آن را فعال کرد.
پیش‌فرض \f[CR]false\f[R] است.
.PP
\f[B]نیازمند ویژگی: \f[CB]eswitch\-mode\f[B]\f[R]
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]infiniband\-mode\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
(فقط دستگاه‌های InfiniBand) تغییر حالت عملیاتی یک دستگاه IPoIB.
مقادیر ممکن \f[CR]datagram\f[R] یا \f[CR]connected\f[R] هستند.
در صورت عدم تعیین، از پیکربندی پیش‌فرض هسته استفاده می‌شود.
.PP
\f[B]نیازمند ویژگی: \f[CB]infiniband\f[B]\f[R]
.RE
.RE

.PP
(yaml\-modems)= ## ویژگی‌های نوع دستگاه \f[CR]modems\f[R]
.PP
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]modems\f[R] برای پیکربندی رابط‌های مودم استفاده کنید.
پیکربندی مودم GSM/CDMA فقط برای بک‌اند \f[CR]NetworkManager\f[R] پشتیبانی می‌شود.
\f[CR]systemd\-networkd\f[R] از مودم‌ها پشتیبانی نمی‌کند.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از شناسه‌های مودم است.
هر \f[CR]modem\f[R] دارای تعدادی گزینه پیکربندی است.
ساختار کلی پیکربندی برای مودم‌ها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  version\f[B]:\f[R] 2
  renderer\f[B]:\f[R] NetworkManager
  modems\f[B]:\f[R]
    cdc\-wdm1\f[B]:\f[R]
      mtu\f[B]:\f[R] 1600
      apn\f[B]:\f[R] ISP.CINGULAR
      username\f[B]:\f[R] ISP\[at]CINGULARGPRS.COM
      password\f[B]:\f[R] CINGULAR1
      number\f[B]:\f[R] \[dq]*99#\[dq]
      network\-id\f[B]:\f[R] 24005
      device\-id\f[B]:\f[R] da812de91eec16620b06cd0ca5cbc7ea25245222
      pin\f[B]:\f[R] 2345
      sim\-id\f[B]:\f[R] 89148000000060671234
      sim\-operator\-id\f[B]:\f[R] 310260
.EE
.PP
\f[B]نیازمند ویژگی: \f[CB]modems\f[B]\f[R]
.IP \[bu] 2
\f[B]\f[CB]apn\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
تنظیم APN (نام نقطه دسترسی) اپراتور.
در صورت فعال بودن \f[CR]auto\-config\f[R] می‌توان این گزینه را حذف کرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]auto\-config\f[B]\f[R] (بولی) \[en] از نسخه 0.99
.RS 2
.RS
.PP
مشخص می‌کند که آیا باید با جستجوی اپراتور در پایگاه داده ارائه‌دهندگان پهن‌باند تلفن همراه، پیکربندی خودکار مودم انجام شود یا خیر.
ممکن است این قابلیت برای همه اپراتورها کار نکند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]device\-id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
شناسه دستگاه (همان‌طور که توسط سرویس مدیریت WWAN داده شده است) مودم را برای تطبیق مشخص می‌کند.
این مورد را می‌توان با استفاده از \f[CR]mmcli\f[R] پیدا کرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]network\-id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
شناسه شبکه را مشخص می‌کند (قالب GSM LAI).
در صورت تعیین این گزینه، دستگاه رومینگ شبکه انجام نخواهد داد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]number\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
شماره‌ای که باید برای برقراری اتصال به شبکه پهن‌باند تلفن همراه شماره‌گیری شود.
(برای GSM منسوخ شده است)
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]password\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
گذرواژه مورد استفاده برای احراز هویت در شبکه اپراتور را مشخص می‌کند.
در صورت فعال بودن \f[CR]auto\-config\f[R] می‌توان این گزینه را حذف کرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]pin\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
پین‌کد (PIN) سیم‌کارت را مشخص می‌کند تا در صورت فعال بودن پین، امکان کارکرد آن فراهم شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]sim\-id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
شناسه یکتای سیم‌کارت (همان‌طور که توسط سرویس مدیریت WWAN داده شده است) که این اتصال برای آن اعمال می‌شود را مشخص می‌کند.
در صورت ارائه، اتصال برای هر دستگاهی که توسط \f[CR]device\-id\f[R] مجاز شناخته شده و حاوی سیم‌کارتی منطبق با شناسه داده‌شده باشد اعمال خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]sim\-operator\-id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
رشته MCC/MNC (مانند \f[CR]310260\f[R] یا \f[CR]21601\f[R]) را مشخص می‌کند که اپراتور مورد نظر برای اعمال این اتصال را مشخص می‌نماید.
در صورت ارائه، اتصال برای هر دستگاهی که توسط \f[CR]device\-id\f[R] و \f[CR]sim\-id\f[R] مجاز شناخته شده و حاوی سیم‌کارت ارائه‌شده توسط اپراتور داده‌شده باشد اعمال خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]username\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
نام کاربری مورد استفاده برای احراز هویت با شبکه اپراتور را مشخص می‌کند.
در صورت فعال بودن \f[CR]auto\-config\f[R] می‌توان این گزینه را حذف کرد.
.RE
.RE
.SS "ویژگی‌های نوع دستگاه \f[CR]wifis\f[R] (Properties for device type wifis)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]wifis\f[R] برای پیکربندی نقاط دسترسی وای‌فای استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از شناسه‌های وای‌فای است.
هر \f[CR]wifi\f[R] دارای تعدادی گزینه پیکربندی است.
ساختار کلی پیکربندی برای وای‌فای در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  version\f[B]:\f[R] 2
  wifis\f[B]:\f[R]
    wlp0s1\f[B]:\f[R]
      access\-points\f[B]:\f[R]
        \[dq]network_ssid_name\[dq]\f[B]:\f[R]
          password\f[B]:\f[R] \[dq]**********\[dq]
.EE
.PP
توجه داشته باشید که \f[CR]systemd\-networkd\f[R] پشتیبانی بومی از وای‌فای ندارد، بنابراین اگر اجازه می‌دهید رندرکننده networkd وای‌فای را مدیریت کند، به نصب wpasupplicant نیاز دارید.
.IP \[bu] 2
\f[B]\f[CB]access\-points\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
اتصالات از پیش پیکربندی‌شده را برای NetworkManager فراهم می‌کند.
توجه داشته باشید که کاربران البته می‌توانند نقاط دسترسی/SSIDهای دیگر را انتخاب کنند.
کلیدهای نگاشت همان SSIDها هستند و مقادیر آنها نگاشت‌هایی با ویژگی‌های پشتیبانی‌شده زیر می‌باشند:
.RE
.IP \[bu] 2
\f[B]\f[CB]password\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
احراز هویت WPA/WPA2 را فعال کرده و عبارت عبور (passphrase) را برای آن تنظیم می‌کند.
اگر نه این گزینه و نه یک بلوک \f[CR]auth\f[R] داده نشود، فرض بر این است که شبکه باز (open) است.
تنظیم
.IP
.EX
password\f[B]:\f[R] \[dq]S3kr1t\[dq]
.EE
.PP
معادل است با:
.IP
.EX
auth\f[B]:\f[R]
  key\-management\f[B]:\f[R] psk
  password\f[B]:\f[R] \[dq]S3kr1t\[dq]
.EE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mode\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت‌های ممکن نقطه دسترسی عبارتند از: \f[CR]infrastructure\f[R] (پیش‌فرض)، \f[CR]ap\f[R] (ایجاد یک نقطه دسترسی که دستگاه‌های دیگر می‌توانند به آن متصل شوند) و \f[CR]adhoc\f[R] (شبکه‌های همتا به همتا بدون نقطه دسترسی مرکزی).
مقدار \f[CR]ap\f[R] فقط با NetworkManager پشتیبانی می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]bssid\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
در صورت تعیین، دستگاه را هدایت می‌کند تا تنها با نقطه دسترسی داده‌شده مرتبط شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]band\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
باندهای ممکن \f[CR]5GHz\f[R] (برای 802.11a در فرکانس 5GHz) و \f[CR]2.4GHz\f[R] (برای 802.11 در فرکانس 2.4GHz) هستند؛ در صورت عدم تنظیم (پیش‌فرض)، باند فرکانس 802.11 شبکه محدود نمی‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]channel\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
کانال بی‌سیم مورد استفاده برای اتصال وای‌فای.
از آنجا که شماره کانال‌ها بین باندها همپوشانی دارند، این ویژگی تنها در صورتی اعمال می‌شود که ویژگی \f[CR]band\f[R] نیز تنظیم شده باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]hidden\f[B]\f[R] (بولی) \[en] از نسخه 0.100
.RS 2
.RS
.PP
برای تغییر روش پویش SSID جهت اتصال به شبکه‌های مخفی وای‌فای، روی \f[CR]true\f[R] تنظیم کنید.
توجه داشته باشید که این گزینه ممکن است در مقایسه با \f[CR]false\f[R] (پیش‌فرض) هنگام اتصال به SSIDهایی که به صورت عمومی پخش می‌شوند، عملکرد کندتری داشته باشد.
.RE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]wakeonwlan\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.99
.RS 2
.RS
.PP
قابلیت WakeOnWLan را روی دستگاه‌های پشتیبانی‌شده فعال می‌کند.
همه درایورها از تمام گزینه‌ها پشتیبانی نمی‌کنند.
می‌تواند هر ترکیبی از \f[CR]any\f[R]، \f[CR]disconnect\f[R]، \f[CR]magic_pkt\f[R]، \f[CR]gtk_rekey_failure\f[R]، \f[CR]eap_identity_req\f[R]، \f[CR]four_way_handshake\f[R]، \f[CR]rfkill_release\f[R] یا \f[CR]tcp\f[R] (فقط NetworkManager) باشد.
یا پرچم انحصاری \f[CR]default\f[R] (پیش‌فرض).
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]regulatory\-domain\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
می‌توان از این گزینه برای تعریف دامنه مقرراتی رادیو استفاده کرد تا از کانال‌های وای‌فای اضافی خارج از «دامنه جهانی» (world domain) استفاده شود.
یک کد کشور ISO/IEC 3166 (مانند \f[CR]GB\f[R]) یا \f[CR]00\f[R] را برای بازنشانی به «دامنه جهانی» می‌پذیرد.
برای مقادیر موجود به \c
.UR https://git.kernel.org/pub/scm/linux/kernel/git/sforshee/wireless-regdb.git/tree/db.txt
wireless\-regdb
.UE \c
\ مراجعه کنید.
.PP
\f[B]نیازمند وابستگی: \f[CB]iw\f[B]\f[R]، در صورتی که قرار است خارج از بک‌اند networkd (wpasupplicant) استفاده شود.
.RE
.RE
.SS "ویژگی‌های نوع دستگاه \f[CR]bridges\f[R] (Properties for device type bridges)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]bridges\f[R] برای ایجاد رابط‌های پل (Bridge) استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط پل است.
هر \f[CR]bridge\f[R] دارای فهرستی اختیاری از رابط‌هایی است که به یکدیگر پل می‌شوند.
رابط‌های فهرست‌شده در کلید \f[CR]interfaces\f[R] (\f[CR]enp5s0\f[R] و \f[CR]enp5s1\f[R] در زیر) باید در پیکربندی Netplan شما نیز تعریف شوند.
ساختار کلی پیکربندی برای پل‌ها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R]
        \f[B]\-\f[R] enp5s0
        \f[B]\-\f[R] enp5s1
      dhcp4\f[B]:\f[R] true
      ...
.EE
.PP
پس از اعمال، یک رابط مجازی از نوع پل با نام \f[CR]br0\f[R] در سیستم ایجاد خواهد شد.
.PP
تنظیمات خاص برای پل‌ها در زیر تعریف شده‌اند:
.IP \[bu] 2
\f[B]\f[CB]interfaces\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
تمام دستگاه‌هایی که با این فهرست شناسه مطابقت دارند به پل اضافه خواهند شد.
این می‌تواند یک فهرست خالی باشد، که در این صورت پل بدون هیچ رابط عضوی آنلاین خواهد شد.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    switchports\f[B]:\f[R]
      match\f[B]:\f[R] \f[B]{\f[R]name\f[B]:\f[R] \[dq]enp2*\[dq]\f[B]}\f[R]
  \f[B][\f[R]...\f[B]]\f[R]
  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R] \f[B][\f[R]switchports\f[B]]\f[R]
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]parameters\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
پارامترهای سفارشی‌سازی برای گزینه‌های ویژه پل‌بندی.
فواصل زمانی ممکن است نیاز باشد به صورت تعداد ثانیه‌ها یا میلی‌ثانیه‌ها بیان شوند: نوع مقدار پیش‌فرض در زیر مشخص شده است.
در صورت لزوم، فواصل زمانی را می‌توان با استفاده از یک پسوند زمان (مانند \f[CR]s\f[R] برای ثانیه، \f[CR]ms\f[R] برای میلی‌ثانیه) تعیین کرد تا امکان کنترل بیشتر بر رفتار آن فراهم شود.
.RE
.IP \[bu] 2
\f[B]\f[CB]ageing\-time\f[B]\f[R]، \f[B]\f[CB]aging\-time\f[B]\f[R]
(اسکالر)
.RS 2
.RS
.PP
مدت زمانی را که پس از دریافت یک بسته، آدرس MAC در پایگاه داده فورواردینگ (FDB) نگه داشته می‌شود، تنظیم می‌کند.
این مورد هنگام استفاده از رندرکننده networkd به ویژگی \f[CR]AgeingTimeSec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]priority\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مقدار اولویت را برای پل تنظیم می‌کند.
این مقدار باید عددی بین \f[CR]0\f[R] و \f[CR]65535\f[R] باشد.
مقادیر کمتر به معنای اولویت بالاتر هستند.
پلی که اولویت بالاتری دارد به عنوان پل ریشه (root bridge) انتخاب خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]port\-priority\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
اولویت پورت را به ازای هر رابط تنظیم می‌کند.
مقدار اولویت عددی بین \f[CR]0\f[R] و \f[CR]63\f[R] است.
این معیار در الگوریتم‌های انتخاب پورت اختصاص‌یافته (designated port) و پورت ریشه استفاده می‌شود.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth0\f[B]:\f[R]
      dhcp4\f[B]:\f[R] false
    eth1\f[B]:\f[R]
      dhcp4\f[B]:\f[R] false
  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R] \f[B][\f[R]eth0\f[B],\f[R] eth1\f[B]]\f[R]
      parameters\f[B]:\f[R]
        port\-priority\f[B]:\f[R]
          eth0\f[B]:\f[R] 10
          eth1\f[B]:\f[R] 20
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]forward\-delay\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مدت زمانی را مشخص می‌کند که پل قبل از رسیدن به وضعیت فورواردینگ (Forwarding)، در وضعیت‌های شنود (Listening) و یادگیری (Learning) باقی خواهد ماند.
این فیلد برای رندرکننده networkd به ویژگی \f[CR]ForwardDelaySec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]hello\-time\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
فاصله زمانی بین ارسال دو بسته hello از پل‌های ریشه و اختصاص‌یافته را مشخص می‌کند.
بسته‌های Hello اطلاعات مربوط به توپولوژی شبکه را منتقل می‌کنند.
هنگامی که رندرکننده networkd استفاده می‌شود، این مورد به ویژگی \f[CR]HelloTimeSec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]max\-age\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حداکثر عمر یک بسته hello را تنظیم می‌کند.
اگر آخرین بسته hello قدیمی‌تر از آن مقدار باشد، پل تلاش خواهد کرد تا به پل ریشه تبدیل شود.
این مورد هنگام استفاده از رندرکننده networkd به ویژگی \f[CR]MaxAgeSec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]path\-cost\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
هزینه مسیر روی پل را به ازای هر رابط تنظیم می‌کند.
رابط‌های سریع‌تر باید هزینه کمتری داشته باشند.
این اجازه می‌دهد تا کنترل دقیق‌تری روی توپولوژی شبکه وجود داشته باشد تا سریع‌ترین مسیرها در هر زمان ممکن در دسترس باشند.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eth0\f[B]:\f[R]
      dhcp4\f[B]:\f[R] false
    eth1\f[B]:\f[R]
      dhcp4\f[B]:\f[R] false
  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R] \f[B][\f[R]eth0\f[B],\f[R] eth1\f[B]]\f[R]
      parameters\f[B]:\f[R]
        path\-cost\f[B]:\f[R]
          eth0\f[B]:\f[R] 100
          eth1\f[B]:\f[R] 200
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]stp\f[B]\f[R] (بولی)
.RS 2
.RS
.PP
مشخص می‌کند که آیا پل باید از پروتکل درخت پوشا (Spanning Tree Protocol) استفاده کند یا خیر.
مقدار پیش‌فرض \f[CR]true\f[R] است، به این معنی که پروتکل درخت پوشا باید استفاده شود.
.RE
.RE
.RE
.SS "ویژگی‌های نوع دستگاه \f[CR]dummy\-devices\f[R] (Properties for device type dummy-devices)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]dummy\-devices\f[R] برای ایجاد رابط‌های مجازی استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط است.
دستگاه‌های ساختگی (Dummy devices) دستگاه‌های مجازی هستند که می‌توان از آنها برای مسیریابی بسته‌ها بدون ارسال واقعی آنها استفاده کرد.
.IP
.EX
network\f[B]:\f[R]
  dummy\-devices\f[B]:\f[R]
    dm0\f[B]:\f[R]
      addresses\f[B]:\f[R]
        \f[B]\-\f[R] 192.168.0.123/24
      ...
.EE
.PP
پس از اعمال، یک رابط مجازی به نام \f[CR]dm0\f[R] در سیستم ایجاد خواهد شد.
.PP
برای مشاهده فهرست ویژگی‌هایی که می‌توان با این نوع رابط استفاده کرد، بخش «ویژگی‌های تمام انواع دستگاه‌ها» را ببینید.

.SS "ویژگی‌های نوع دستگاه \f[CR]bonds\f[R] (Properties for device type bonds)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]bonds\f[R] برای ایجاد رابط‌های تجمیع پیوند (Bond / Link Aggregation) استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط Bond است.
هر \f[CR]bond\f[R] دارای فهرستی اختیاری از رابط‌هایی است که بخشی از تجمیع خواهند بود.
رابط‌های فهرست‌شده در کلید \f[CR]interfaces\f[R] باید در پیکربندی Netplan شما نیز تعریف شده باشند.
ساختار کلی پیکربندی برای باندها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  bonds\f[B]:\f[R]
    bond0\f[B]:\f[R]
      interfaces\f[B]:\f[R]
        \f[B]\-\f[R] enp5s0
        \f[B]\-\f[R] enp5s1
        \f[B]\-\f[R] enp5s2
      parameters\f[B]:\f[R]
        mode\f[B]:\f[R] active\-backup
      ...
.EE
.PP
پس از اعمال، یک رابط مجازی از نوع bond با نام \f[CR]bond0\f[R] در سیستم ایجاد خواهد شد.
.PP
تنظیمات خاص برای باندها در زیر تعریف شده‌اند:
.IP \[bu] 2
\f[B]\f[CB]interfaces\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
تمام دستگاه‌هایی که با این فهرست شناسه مطابقت دارند به bond اضافه خواهند شد.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    switchports\f[B]:\f[R]
      match\f[B]:\f[R] \f[B]{\f[R]name\f[B]:\f[R] \[dq]enp2*\[dq]\f[B]}\f[R]
  \f[B][\f[R]...\f[B]]\f[R]
  bonds\f[B]:\f[R]
    bond0\f[B]:\f[R]
      interfaces\f[B]:\f[R] \f[B][\f[R]switchports\f[B]]\f[R]
.EE
.RE
.IP \[bu] 2
\f[B]\f[CB]parameters\f[B]\f[R] (نگاشت)
.RS 2
.RS
.PP
پارامترهای سفارشی‌سازی برای گزینه‌های ویژه باندینگ.
فواصل زمانی ممکن است نیاز باشد به صورت تعداد ثانیه‌ها یا میلی‌ثانیه‌ها بیان شوند: نوع مقدار پیش‌فرض در زیر مشخص شده است.
در صورت لزوم، فواصل زمانی را می‌توان با استفاده از یک پسوند زمان (مانند \f[CR]s\f[R] برای ثانیه، \f[CR]ms\f[R] برای میلی‌ثانیه) تعیین کرد تا امکان کنترل بیشتر بر رفتار آن فراهم شود.
.RE
.IP \[bu] 2
\f[B]\f[CB]mode\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت باندینگ مورد استفاده برای رابط‌ها را تنظیم می‌کند.
پیش‌فرض \f[CR]balance\-rr\f[R] (توزیع نوبتی یا round robin) است.
مقادیر ممکن عبارتند از: \f[CR]balance\-rr\f[R]، \f[CR]active\-backup\f[R]، \f[CR]balance\-xor\f[R]، \f[CR]broadcast\f[R]، \f[CR]802.3ad\f[R]، \f[CR]balance\-tlb\f[R] و \f[CR]balance\-alb\f[R].
برای Open vSwitch، حالت‌های \f[CR]active\-backup\f[R] و حالت‌های اضافی \f[CR]balance\-tcp\f[R] و \f[CR]balance\-slb\f[R] پشتیبانی می‌شوند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]lacp\-rate\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
نرخ ارسال LACPDUها را تنظیم می‌کند.
این مورد فقط در حالت 802.3ad مفید است.
مقادیر ممکن \f[CR]slow\f[R] (۳۰ ثانیه، پیش‌فرض) و \f[CR]fast\f[R] (هر ثانیه) هستند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mii\-monitor\-interval\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
فاصله زمانی را برای پایش MII (بررسی اینکه آیا یک رابط bond دارای حامل است یا خیر) مشخص می‌کند.
پیش‌فرض \f[CR]0\f[R] است که پایش MII را غیرفعال می‌کند.
این معادل فیلد \f[CR]MIIMonitorSec=\f[R] برای بک‌اند networkd است.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان میلی‌ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]min\-links\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حداقل تعداد پیوندهای فعال در یک bond برای اینکه رابط bond فعال (up) در نظر گرفته شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]transmit\-hash\-policy\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
خط‌مشی هش ارسال را برای انتخاب پورت‌ها مشخص می‌کند.
این مورد فقط در حالت‌های \f[CR]balance\-xor\f[R]، \f[CR]802.3ad\f[R] و \f[CR]balance\-tlb\f[R] مفید است.
مقادیر ممکن عبارتند از: \f[CR]layer2\f[R]، \f[CR]layer3+4\f[R]، \f[CR]layer2+3\f[R]، \f[CR]encap2+3\f[R] و \f[CR]encap3+4\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ad\-select\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت انتخاب تجمیع (Aggregation Selection) را تنظیم می‌کند.
مقادیر ممکن عبارتند از: \f[CR]stable\f[R]، \f[CR]bandwidth\f[R] و \f[CR]count\f[R].
این گزینه فقط در حالت 802.3ad استفاده می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]all\-members\-active\f[B]\f[R] (بولی) \[en] از نسخه 0.106
.RS 2
.RS
.PP
اگر bond باید فریم‌های تکراری دریافت‌شده روی پورت‌های غیرفعال را دور بریزد، این گزینه را روی \f[CR]false\f[R] تنظیم کنید.
اگر باید تحویل داده شوند، این گزینه را روی \f[CR]true\f[R] تنظیم کنید.
مقدار پیش‌فرض false است و در اکثر شرایط رفتار مطلوب به شمار می‌رود.
.PP
نام مستعار: \f[B]\f[CB]all\-slaves\-active\f[B]\f[R]
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]arp\-interval\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مقدار فاصله زمانی را برای اینکه پایش پیوند ARP با چه بسامدی انجام شود تنظیم می‌کند.
مقدار پیش‌فرض \f[CR]0\f[R] است که پایش ARP را غیرفعال می‌کند.
برای بک‌اند networkd، این مورد به ویژگی \f[CR]ARPIntervalSec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان میلی‌ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]arp\-ip\-targets\f[B]\f[R] (دنباله‌ای از اسکالرها)
.RS 2
.RS
.PP
آدرس‌های IP سایر میزبان‌های روی پیوند که باید درخواست‌های ARP برای آنها ارسال شود تا تأیید شود که یک پورت فعال است.
این گزینه فقط زمانی استفاده می‌شود که \f[CR]arp\-interval\f[R] روی مقداری غیر از \f[CR]0\f[R] تنظیم شده باشد.
برای عملکرد پایش پیوند ARP حداقل باید یک آدرس IP داده شود.
تنها آدرس‌های IPv4 پشتیبانی می‌شوند.
می‌توانید تا ۱۶ آدرس IP را مشخص کنید.
مقدار پیش‌فرض یک فهرست خالی است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]arp\-validate\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
نحوه اعتبارسنجی پاسخ‌های ARP را هنگام استفاده از پایش پیوند ARP پیکربندی می‌کند.
مقادیر ممکن عبارتند از: \f[CR]none\f[R]، \f[CR]active\f[R]، \f[CR]backup\f[R] و \f[CR]all\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]arp\-all\-targets\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مشخص می‌کند که آیا بالا بودن هر کدام از اهداف IP ARP برای بالا در نظر گرفته شدن یک پورت کافی است یا اینکه همه اهداف باید بالا باشند.
این مورد فقط برای حالت \f[CR]active\-backup\f[R] زمانی که \f[CR]arp\-validate\f[R] فعال است استفاده می‌شود.
مقادیر ممکن \f[CR]any\f[R] و \f[CR]all\f[R] هستند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]up\-delay\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تاخیر قبل از فعال کردن پیوند پس از بالا آمدن فیزیکی پیوند را مشخص می‌کند.
مقدار پیش‌فرض \f[CR]0\f[R] است.
این مورد برای رندرکننده networkd به ویژگی \f[CR]UpDelaySec=\f[R] نگاشت می‌شود.
این گزینه فقط برای پایشگر پیوند miimon معتبر است.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان میلی‌ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]down\-delay\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تاخیر قبل از غیرفعال کردن پیوند پس از قطع شدن پیوند را مشخص می‌کند.
مقدار پیش‌فرض \f[CR]0\f[R] است.
این مورد برای رندرکننده networkd به ویژگی \f[CR]DownDelaySec=\f[R] نگاشت می‌شود.
این گزینه فقط برای پایشگر پیوند miimon معتبر است.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان میلی‌ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]fail\-over\-mac\-policy\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
مشخص می‌کند که آیا هنگام افزودن پورت‌ها به bond، تمام پورت‌ها روی یک آدرس MAC تنظیم شوند یا سیستم چگونه باید با آدرس‌های MAC رفتار کند.
مقادیر ممکن عبارتند از: \f[CR]none\f[R]، \f[CR]active\f[R] و \f[CR]follow\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]gratuitous\-arp\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
تعداد بسته‌های ARP ارسالی پس از تغییر وضعیت اضطراری (failover) را مشخص می‌کند.
به محض اینکه پیوندی روی یک پورت جدید برقرار شد، یک اعلان ارسال می‌شود و اگر این مقدار روی عددی بزرگ‌تر از \f[CR]1\f[R] تنظیم شود، احتمالاً تکرار خواهد شد.
مقدار پیش‌فرض \f[CR]1\f[R] است و مقادیر معتبر بین \f[CR]1\f[R] و \f[CR]255\f[R] هستند.
این مورد فقط بر حالت \f[CR]active\-backup\f[R] تأثیر می‌گذارد.
.PP
به دلایل تاریخی، املای نادرست \f[CR]gratuitious\-arp\f[R] نیز پذیرفته می‌شود و عملکرد یکسانی دارد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]packets\-per\-member\f[B]\f[R] (اسکالر) \[en] از نسخه 0.106
.RS 2
.RS
.PP
در حالت \f[CR]balance\-rr\f[R]، تعداد بسته‌هایی را که باید قبل از جابجایی به پورت بعدی روی یک پورت ارسال شوند، مشخص می‌کند.
هنگامی که این مقدار روی \f[CR]0\f[R] تنظیم شود، پورت‌ها به صورت تصادفی انتخاب می‌شوند.
مقادیر مجاز بین \f[CR]0\f[R] و \f[CR]65535\f[R] هستند.
مقدار پیش‌فرض \f[CR]1\f[R] است.
این تنظیم فقط در حالت \f[CR]balance\-rr\f[R] استفاده می‌شود.
.PP
نام مستعار: \f[B]\f[CB]packets\-per\-slave\f[B]\f[R]
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]primary\-reselect\-policy\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
خط‌مشی انتخاب مجدد را برای پورت اصلی (primary port) تنظیم می‌کند.
در صورت خرابی پورت فعال، سیستم از این خط‌مشی برای تصمیم‌گیری در مورد نحوه انتخاب پورت فعال جدید و نحوه مدیریت بازیابی استفاده خواهد کرد.
مقادیر ممکن عبارتند از: \f[CR]always\f[R]، \f[CR]better\f[R] و \f[CR]failure\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]resend\-igmp\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
در حالت‌های \f[CR]balance\-rr\f[R]، \f[CR]active\-backup\f[R]، \f[CR]balance\-tlb\f[R] و \f[CR]balance\-alb\f[R]، یک تغییر وضعیت اضطراری (failover) می‌تواند ترافیک IGMP را از یک پورت به پورت دیگر تغییر دهد.
.PP
این پارامتر مشخص می‌کند چه تعداد گزارش عضویت IGMP در یک رویداد failover صادر شود.
مقادیر از 0 تا 255 متغیر است.
مقدار 0 ارسال گزارش‌های عضویت را غیرفعال می‌کند.
در غیر این صورت، اولین گزارش عضویت در هنگام failover ارسال می‌شود و گزارش‌های بعدی در فواصل 200 میلی‌ثانیه‌ای ارسال می‌گردند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]learn\-packet\-interval\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
فاصله زمانی بین ارسال بسته‌های یادگیری به هر پورت را مشخص می‌کند.
محدوده مقدار بین \f[CR]1\f[R] و \f[CR]0x7fffffff\f[R] است.
مقدار پیش‌فرض \f[CR]1\f[R] است.
این گزینه فقط بر حالت‌های \f[CR]balance\-tlb\f[R] و \f[CR]balance\-alb\f[R] تأثیر می‌گذارد.
با استفاده از رندرکننده networkd، این فیلد به ویژگی \f[CR]LearnPacketIntervalSec=\f[R] نگاشت می‌شود.
اگر پسوند زمانی مشخص نشود، مقدار به عنوان ثانیه تفسیر خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]primary\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
دستگاهی را برای استفاده به عنوان پورت اصلی، یا دستگاه ترجیحی برای استفاده به عنوان پورت برای bond (یعنی دستگاه ترجیحی برای ارسال داده از طریق آن) در هر زمان که در دسترس باشد مشخص می‌کند.
این مورد فقط بر حالت‌های \f[CR]active\-backup\f[R]، \f[CR]balance\-alb\f[R] و \f[CR]balance\-tlb\f[R] تأثیر می‌گذارد.
.RE
.RE
.RE
.PP
(yaml\-tunnels)= ## ویژگی‌های نوع دستگاه \f[CR]tunnels\f[R]
.PP
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]tunnels\f[R] برای ایجاد رابط‌های تونل مجازی استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط تونل است.
هر \f[CR]tunnel\f[R] نیازمند شناسایی حالت تونل است (بخش \f[CR]mode\f[R] زیر را برای فهرست حالت‌های پشتیبانی‌شده ببینید).
ساختار کلی پیکربندی برای تونل‌ها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    tunnel0\f[B]:\f[R]
      mode\f[B]:\f[R] SCALAR
      ...
.EE
.PP
پس از اعمال، یک رابط مجازی به نام \f[CR]tunnel0\f[R] در سیستم ایجاد خواهد شد.
حالت عملکرد آن توسط ویژگی \f[CR]mode\f[R] تعریف می‌شود.
.PP
تونل‌ها اجازه می‌دهند ترافیک به گونه‌ای عبور کند که گویی بین سیستم‌های موجود در یک شبکه محلی یکسان است، حتی اگر سیستم‌ها از یکدیگر دور باشند اما از طریق اینترنت قابل دسترسی باشند.
آنها ممکن است برای پشتیبانی از ترافیک IPv6 در شبکه‌ای که ISP این سرویس را ارائه نمی‌دهد، یا برای گسترش و «اتصال» شبکه‌های محلی جداگانه استفاده شوند.
برای اطلاعات کلی بیشتر درباره تونل‌ها به \c
.UR https://en.wikipedia.org/wiki/Tunneling_protocol
Tunneling_protocol
.UE \c
\ مراجعه کنید.
.PP
تنظیمات خاص برای تونل‌ها در زیر تعریف شده‌اند:
.IP \[bu] 2
\f[B]\f[CB]mode\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
حالت تونل را مشخص می‌کند.
گزینه‌های معتبر عبارتند از حالت‌های \f[CR]sit\f[R]، \f[CR]gre\f[R]، \f[CR]ip6gre\f[R]، \f[CR]ipip\f[R]، \f[CR]ipip6\f[R]، \f[CR]ip6ip6\f[R]، \f[CR]vti\f[R]، \f[CR]vti6\f[R]، \f[CR]wireguard\f[R]، \f[CR]vxlan\f[R]، \f[CR]gretap\f[R] و \f[CR]ip6gretap\f[R].
علاوه بر این، بک‌اند \f[CR]NetworkManager\f[R] از تونل‌های \f[CR]isatap\f[R] پشتیبانی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]local\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
آدرس نقطه پایانی محلی (local endpoint) تونل را تعریف می‌کند.
(برای VXLAN) این باید با یکی از آدرس‌های IP والد مطابقت داشته باشد یا از مقادیر ویژه networkd استفاده کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]remote\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
آدرس نقطه پایانی راه دور (remote endpoint) تونل یا آدرس IP گروه چندپخشی (multicast group) را برای VXLAN تعریف می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ttl\f[B]\f[R] (اسکالر) \[en] از نسخه 0.103
.RS 2
.RS
.PP
طول عمر (TTL) تونل را مشخص می‌کند.
عددی در محدوده \f[CR]1..255\f[R] می‌گیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]key\f[B]\f[R] (اسکالر یا نگاشت)
.RS 2
.RS
.PP
کلیدهای مورد استفاده برای تونل را تعریف می‌کند.
کلید می‌تواند یک عدد یا یک آدرس IPv4 چهاربخشی نقطه‌دار (dotted quad) باشد.
برای \f[CR]wireguard\f[R] می‌تواند یک کلید خصوصی کدگذاری‌شده با base64 یا (از networkd نسخه v242+) یک مسیر مطلق به فایلی حاوی کلید خصوصی باشد (از نسخه 0.100).
از آن برای شناسایی تبدیل‌های IP استفاده می‌شود.
این مورد فقط برای \f[CR]vti\f[R] و \f[CR]vti6\f[R] هنگام استفاده از بک‌اند networkd الزامی است.
.PP
این فیلد ممکن است به عنوان یک اسکالر استفاده شود (به این معنی که یک کلید واحد مشخص شده و برای ورودی، خروجی و کلید خصوصی استفاده می‌شود)، یا به عنوان یک نگاشت، که در آن می‌توانید \f[CR]input\f[R]/\f[CR]output\f[R]/\f[CR]private\f[R] را بیشتر مشخص کنید.
.RE
.IP \[bu] 2
\f[B]\f[CB]input\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
کلید ورودی برای تونل.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]output\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
کلید خروجی برای تونل.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]private\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
یک کلید خصوصی کدگذاری‌شده با base64 که برای تونل‌های WireGuard مورد نیاز است.
هنگامی که از بک‌اند \f[CR]systemd\-networkd\f[R] (نسخه v242+) استفاده می‌شود، این می‌تواند یک مسیر مطلق به فایلی حاوی کلید خصوصی نیز باشد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]private\-key\-flags\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.107
.RS 2
.RS
.PP
پرچم‌های کلید خصوصی مورد استفاده توسط NetworkManager.
مقادیر ممکن عبارتند از: \f[CR]agent\-owned\f[R]، \f[CR]not\-saved\f[R] و \f[CR]not\-required\f[R].
.PP
\f[CR]agent\-owned\f[R]: یک عامل مخفی نشست کاربر مسئول ارائه و ذخیره این راز است.
.PP
\f[CR]not\-saved\f[R]: این راز نباید ذخیره شود، بلکه باید هر بار که لازم است از کاربر درخواست شود.
.PP
\f[CR]not\-required\f[R]: این پرچم اشاره می‌کند که راز الزامی نیست و نباید از کاربر درخواست شود.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  renderer\f[B]:\f[R] NetworkManager
  tunnels\f[B]:\f[R]
    wg0\f[B]:\f[R]
      mode\f[B]:\f[R] wireguard
      port\f[B]:\f[R] 5182
      key\f[B]:\f[R]
        private\-key\-flags\f[B]:\f[R]
          \f[B]\-\f[R] agent\-owned
      peers\f[B]:\f[R]
        \f[B]\-\f[R] keys\f[B]:\f[R]
            public\f[B]:\f[R] rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=
          allowed\-ips\f[B]:\f[R] \f[B][\f[R]0.0.0.0/0\f[B],\f[R] \[dq]2001:fe:ad:de:ad:be:ef:1/24\[dq]\f[B]]\f[R]
          keepalive\f[B]:\f[R] 23
          endpoint\f[B]:\f[R] 1.2.3.4:5
.EE
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]keys\f[B]\f[R] (اسکالر یا نگاشت)
.RS 2
.RS
.PP
نام جایگزین برای فیلد \f[CR]key\f[R].
بالا را ببینید.
.RE
.PP
مثال‌ها:
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    tun0\f[B]:\f[R]
      mode\f[B]:\f[R] gre
      local\f[B]:\f[R] ...
      remote\f[B]:\f[R] ...
      keys\f[B]:\f[R]
        input\f[B]:\f[R] 1234
        output\f[B]:\f[R] 5678
.EE
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    tun0\f[B]:\f[R]
      mode\f[B]:\f[R] vti6
      local\f[B]:\f[R] ...
      remote\f[B]:\f[R] ...
      key\f[B]:\f[R] 59568549
.EE
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    wg0\f[B]:\f[R]
      mode\f[B]:\f[R] wireguard
      addresses\f[B]:\f[R] \f[B][\f[R]...\f[B]]\f[R]
      peers\f[B]:\f[R]
        \f[B]\-\f[R] keys\f[B]:\f[R]
            public\f[B]:\f[R] rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=
            shared\f[B]:\f[R] /path/to/shared.key
          ...
      key\f[B]:\f[R] mNb7OIIXTdgW4khM7OFlzJ+UPs7lmcWHV7xjPgakMkQ=
.EE
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    wg0\f[B]:\f[R]
      mode\f[B]:\f[R] wireguard
      addresses\f[B]:\f[R] \f[B][\f[R]...\f[B]]\f[R]
      peers\f[B]:\f[R]
        \f[B]\-\f[R] keys\f[B]:\f[R]
            public\f[B]:\f[R] rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=
          ...
      keys\f[B]:\f[R]
        private\f[B]:\f[R] /path/to/priv.key
.EE
.RE

.PP
کلیدهای خاص WireGuard:
.IP \[bu] 2
\f[B]\f[CB]mark\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
علامت فایروال برای بسته‌های خروجی WireGuard از این رابط، اختیاری است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]port\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
پورت UDP برای شنود یا \f[CR]auto\f[R].
اختیاری است، پیش‌فرض \f[CR]auto\f[R] است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]peers\f[B]\f[R] (دنباله‌ای از نگاشت‌ها) \[en] از نسخه 0.100
.RS 2
.RS
.PP
فهرستی از همتاها (peers) که هر کدام دارای کلیدهای مستندشده در زیر هستند.
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  tunnels\f[B]:\f[R]
    wg0\f[B]:\f[R]
      mode\f[B]:\f[R] wireguard
      key\f[B]:\f[R] /path/to/private.key
      mark\f[B]:\f[R] 42
      port\f[B]:\f[R] 5182
      peers\f[B]:\f[R]
        \f[B]\-\f[R] keys\f[B]:\f[R]
            public\f[B]:\f[R] rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=
          allowed\-ips\f[B]:\f[R] \f[B][\f[R]0.0.0.0/0\f[B],\f[R] \[dq]2001:fe:ad:de:ad:be:ef:1/24\[dq]\f[B]]\f[R]
          keepalive\f[B]:\f[R] 23
          endpoint\f[B]:\f[R] 1.2.3.4:5
        \f[B]\-\f[R] keys\f[B]:\f[R]
            public\f[B]:\f[R] M9nt4YujIOmNrRmpIRTmYSfMdrpvE7u6WkG8FY8WjG4=
            shared\f[B]:\f[R] /some/shared.key
          allowed\-ips\f[B]:\f[R] \f[B][\f[R]10.10.10.20/24\f[B]]\f[R]
          keepalive\f[B]:\f[R] 22
          endpoint\f[B]:\f[R] 5.4.3.2:1
.EE
.IP \[bu] 2
\f[B]\f[CB]endpoint\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
آدرس IPv4/IPv6 یا نام میزبان نقطه پایانی راه دور که به دنبال آن دونقطه و شماره پورت قرار می‌گیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]allowed\-ips\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.100
.RS 2
.RS
.PP
فهرستی از آدرس‌های IP (v4 یا v6) با ماسک‌های CIDR که این همتا مجاز به ارسال ترافیک ورودی از آنها است و ترافیک خروجی برای این همتا به آنها هدایت می‌شود.
مقدار فراگیر 0.0.0.0/0 ممکن است برای تطبیق تمام آدرس‌های IPv4 مشخص شود و ::/0 ممکن است برای تطبیق تمام آدرس‌های IPv6 مشخص شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]keepalive\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
فاصله‌ای بر حسب ثانیه، بین ۱ تا ۶۵۵۳۵ شامل هر دو، برای اینکه هر چند وقت یک‌بار یک بسته خالی احراز هویت‌شده به همتا ارسال شود تا یک فایروال با وضعیت (stateful) یا نگاشت NAT به طور مداوم معتبر بماند.
اختیاری است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]keys\f[B]\f[R] (نگاشت) \[en] از نسخه 0.100
.RS 2
.RS
.PP
کلیدهای مورد استفاده برای همتاهای WireGuard را تعریف می‌کند.
.PP
این فیلد می‌تواند به عنوان یک نگاشت استفاده شود، جایی که می‌توانید کلیدهای \f[CR]public\f[R] و \f[CR]shared\f[R] را بیشتر مشخص کنید.
.RE
.IP \[bu] 2
\f[B]\f[CB]public\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
یک کلید عمومی با کدگذاری base64 که برای همتاهای WireGuard الزامی است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]shared\f[B]\f[R] (اسکالر) \[en] از نسخه 0.100
.RS 2
.RS
.PP
یک کلید از پیش اشتراک‌گذاری‌شده با کدگذاری base64.
برای همتاهای WireGuard اختیاری است.
هنگامی که از بک‌اند \f[CR]systemd\-networkd\f[R] (نسخه v242+) استفاده می‌شود، این می‌تواند یک مسیر مطلق به فایلی حاوی کلید از پیش اشتراک‌گذاری‌شده نیز باشد.
.RE
.RE
.RE
.RE
.PP
کلیدهای خاص VXLAN:
.IP \[bu] 2
\f[B]\f[CB]id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
شناسه شبکه VXLAN (VNI یا شناسه بخش VXLAN).
عددی در محدوده \f[CR]1..16777215\f[R] می‌گیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]link\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
شناسه Netplan مربوط به تعریف دستگاه والدی که این VXLAN به آن متصل می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]type\-of\-service\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
مقدار بایت نوع سرویس (Type Of Service) برای یک رابط VXLAN.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]mac\-learning\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
هنگامی که \f[CR]true\f[R] باشد، یادگیری پویای MAC را برای کشف آدرس‌های MAC راه دور فعال می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]ageing\f[B]\f[R]، \f[B]\f[CB]aging\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
طول عمر ورودی پایگاه داده فورواردینگ (FDB) که توسط هسته یاد گرفته شده است، بر حسب ثانیه.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]limit\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
حداکثر تعداد ورودی‌های FDB را پیکربندی می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]arp\-proxy\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
هنگامی که \f[CR]true\f[R] باشد، نقطه پایانی تونل VXLAN متصل به پل به درخواست‌های ARP از پل محلی به نمایندگی از کلاینت‌های راه دور Distributed Overlay Virtual Ethernet (DOVE) پاسخ می‌دهد.
پیش‌فرض \f[CR]false\f[R] است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]notifications\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
پرچم‌های \f[CR]l2\-miss\f[R] و \f[CR]l3\-miss\f[R] را برای فعال‌سازی اعلان‌های عدم تطابق (miss notifications) آدرس IP نت‌لینک و/یا netlink LLADDR می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]short\-circuit\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
یک مقدار بولی می‌گیرد.
هنگامی که \f[CR]true\f[R] باشد، مدار کوتاه مسیریابی (route short circuiting) روشن می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]checksums\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
پرچم‌های \f[CR]udp\f[R]، \f[CR]zero\-udp6\-tx\f[R]، \f[CR]zero\-udp6\-rx\f[R]، \f[CR]remote\-tx\f[R] و \f[CR]remote\-rx\f[R] را برای فعال‌سازی ارسال چکسام‌های UDP در VXLAN/IPv4، ارسال/دریافت چکسام‌های صفر در VXLAN/IPv6 و فعال‌سازی برون‌سپاری ارسال/دریافت چکسام در VXLAN می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]extensions\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
پرچم‌های \f[CR]group\-policy\f[R] و \f[CR]generic\-protocol\f[R] را برای فعال‌سازی پسوندهای VXLAN مربوط به \[dq]Group Policy\[dq] و/یا \[dq]Generic Protocol\[dq] می‌پذیرد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]port\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
پورت پیش‌فرض مقصد UDP را پیکربندی می‌کند.
اگر پورت مقصد مشخص نشود، از مقدار پیش‌فرض هسته لینوکس استفاده خواهد شد.
برای دریافت مقدار اختصاص‌یافته توسط IANA روی \f[CR]4789\f[R] تنظیم کنید.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]port\-range\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
محدوده پورت مبدأ را برای VXLAN پیکربندی می‌کند.
هسته، پورت مبدأ UDP را بر اساس جریان (flow) اختصاص می‌دهد تا به گیرنده در انجام متعادل‌سازی بار (load balancing) کمک کند.
هنگامی که این گزینه تنظیم نشده باشد، محدوده معمولی پورت‌های UDP محلی استفاده می‌شود.
از قالب \f[CR][LOWER, UPPER]\f[R] استفاده می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]flow\-label\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
برچسب جریان (flow label) را برای استفاده در بسته‌های خروجی مشخص می‌کند.
محدوده معتبر \f[CR]0\-1048575\f[R] است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]do\-not\-fragment\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
امکان تنظیم بیت «عدم قطعه‌بندی» (Do not Fragment یا DF) در IPv4 را در بسته‌های خروجی فراهم می‌کند.
یک مقدار بولی می‌گیرد.
در صورت عدم تنظیم، از پیش‌فرض هسته استفاده خواهد شد.
.RE
.RE
.SS "ویژگی‌های نوع دستگاه \f[CR]virtual\-ethernets\f[R] (Properties for device type virtual-ethernets)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]virtual\-ethernets\f[R] برای ایجاد رابط‌های اترنت مجازی استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط \f[CR]veth\f[R] است.
هر \f[CR]veth\f[R] نیازمند یک \f[CR]peer\f[R] (همتا) است.
به منظور داشتن یک جفت \f[CR]veth\f[R] کاملاً کاربردی، هر دو دستگاه باید تعریف شوند، یعنی صرفاً تنظیم کلید \f[CR]peer\f[R] با نام همتا کافی نیست؛ رابط همتا نیز باید تعریف شده و دستگاه اول را به عنوان همتای خود تنظیم کند.
ساختار کلی پیکربندی برای اترنت مجازی در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  virtual\-ethernets\f[B]:\f[R]
    veth0\f[B]:\f[R]
      peer\f[B]:\f[R] veth1
    veth1\f[B]:\f[R]
      peer\f[B]:\f[R] veth0
.EE
.PP
پس از اعمال، دو رابط مجازی به نام‌های \f[CR]veth0\f[R] و \f[CR]veth1\f[R] در سیستم ایجاد خواهد شد.
.PP
دستگاه‌های اترنت مجازی مانند تونل‌هایی عمل می‌کنند که ترافیک را از یک رابط به رابط دیگر ارسال می‌کنند.
می‌توان از آنها برای اتصال دو شبکه مجازی جداگانه مانند فضاهای نام شبکه (network namespaces) و پل‌ها استفاده کرد.
در حال حاضر امکان انتقال \f[CR]virtual\-ethernets\f[R] به فضاهای نام مختلف از طریق Netplan وجود ندارد.
.PP
تنظیمات خاص برای \f[CR]virtual\-ethernets\f[R] در زیر تعریف شده‌اند:
.IP \[bu] 2
\f[B]\f[CB]peer\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
همتای \f[CR]virtual\-ethernet\f[R] را تعریف می‌کند.
رابط همتا نیز باید یک دستگاه \f[CR]virtual\-ethernet\f[R] باشد.
.RE
.RE
.PP
در زیر یک مثال کامل آورده شده است که از یک جفت دستگاه اترنت مجازی برای ایجاد یک پیوند بین دو پل استفاده می‌کند:
.IP
.EX
network\f[B]:\f[R]
  version\f[B]:\f[R] 2
  renderer\f[B]:\f[R] networkd
  virtual\-ethernets\f[B]:\f[R]
    veth0\-peer1\f[B]:\f[R]
      peer\f[B]:\f[R] veth0\-peer2
    veth0\-peer2\f[B]:\f[R]
      peer\f[B]:\f[R] veth0\-peer1

  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R]
        \f[B]\-\f[R] veth0\-peer1
    br1\f[B]:\f[R]
      interfaces\f[B]:\f[R]
        \f[B]\-\f[R] veth0\-peer2
.EE
.SS "ویژگی‌های نوع دستگاه \f[CR]vlans\f[R] (Properties for device type vlans)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]vlans\f[R] برای ایجاد رابط‌های VLAN استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط VLAN است.
رابط مورد استفاده در گزینه \f[CR]link\f[R] (\f[CR]enp5s0\f[R] در مثال زیر) باید در پیکربندی Netplan نیز تعریف شده باشد.
ساختار کلی پیکربندی برای VLANها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  vlans\f[B]:\f[R]
    vlan123\f[B]:\f[R]
      id\f[B]:\f[R] 123
      link\f[B]:\f[R] enp5s0
      dhcp4\f[B]:\f[R] yes
.EE
.PP
تنظیمات خاص برای VLANها در زیر تعریف شده‌اند:
.IP \[bu] 2
\f[B]\f[CB]id\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
شناسه VLAN، عددی بین \f[CR]0\f[R] و \f[CR]4094\f[R].
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]link\f[B]\f[R] (اسکالر)
.RS 2
.RS
.PP
شناسه Netplan مربوط به تعریف دستگاه زیربنایی که این VLAN روی آن ایجاد می‌شود.
.RE
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  ethernets\f[B]:\f[R]
    eno1\f[B]:\f[R] \f[B]{\f[R]...\f[B]}\f[R]
  vlans\f[B]:\f[R]
    en\-intra\f[B]:\f[R]
      id\f[B]:\f[R] 1
      link\f[B]:\f[R] eno1
      dhcp4\f[B]:\f[R] yes
    en\-vpn\f[B]:\f[R]
      id\f[B]:\f[R] 2
      link\f[B]:\f[R] eno1
      addresses\f[B]:\f[R] \f[B][\f[R]...\f[B]]\f[R]
.EE
.SS "ویژگی‌های نوع دستگاه \f[CR]vrfs\f[R] (Properties for device type vrfs)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]vrfs\f[R] برای ایجاد رابط‌های مسیریابی و فوروارد مجازی (VRF) استفاده کنید.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از نام‌های رابط VRF است.
رابط مورد استفاده در گزینه \f[CR]link\f[R] (\f[CR]enp5s0\f[R] در مثال زیر) باید در پیکربندی Netplan نیز تعریف شده باشد.
ساختار کلی پیکربندی برای VRFها در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  renderer\f[B]:\f[R] networkd
  vrfs\f[B]:\f[R]
    vrf1\f[B]:\f[R]
      table\f[B]:\f[R] 1
      interfaces\f[B]:\f[R]
        \f[B]\-\f[R] enp5s0
      routes\f[B]:\f[R]
        \f[B]\-\f[R] to\f[B]:\f[R] default
          via\f[B]:\f[R] 10.10.10.4
      routing\-policy\f[B]:\f[R]
        \f[B]\-\f[R] from\f[B]:\f[R] 10.10.10.42
.EE
.IP \[bu] 2
\f[B]\f[CB]table\f[B]\f[R] (اسکالر) \[en] از نسخه 0.105
.RS 2
.RS
.PP
شناسه عددی جدول مسیریابی.
این تنظیم اجباری است.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]interfaces\f[B]\f[R] (دنباله‌ای از اسکالرها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
تمام دستگاه‌هایی که با این فهرست شناسه مطابقت دارند به VRF اضافه خواهند شد.
این می‌تواند یک فهرست خالی باشد، که در این صورت VRF بدون هیچ رابط عضوی آنلاین خواهد شد.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]routes\f[B]\f[R] (دنباله‌ای از نگاشت‌ها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
مسیریابی ایستا را برای دستگاه پیکربندی می‌کند؛ بخش \f[CR]مسیریابی\f[R] را ببینید.
مقدار \f[CR]table\f[R] به صورت ضمنی روی \f[CR]table\f[R] مربوط به VRF تنظیم می‌شود.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]routing\-policy\f[B]\f[R] (دنباله‌ای از نگاشت‌ها) \[en] از نسخه 0.105
.RS 2
.RS
.PP
مسیریابی مبتنی بر خط‌مشی را برای دستگاه پیکربندی می‌کند؛ بخش \f[CR]مسیریابی\f[R] را ببینید.
مقدار \f[CR]table\f[R] به صورت ضمنی روی \f[CR]table\f[R] مربوط به VRF تنظیم می‌شود.
.RE
.RE
.PP
مثال:
.IP
.EX
network\f[B]:\f[R]
  vrfs\f[B]:\f[R]
    vrf20\f[B]:\f[R]
      table\f[B]:\f[R] 20
      interfaces\f[B]:\f[R] \f[B][\f[R] br0 \f[B]]\f[R]
      routes\f[B]:\f[R]
        \f[B]\-\f[R] to\f[B]:\f[R] default
          via\f[B]:\f[R] 10.10.10.3
      routing\-policy\f[B]:\f[R]
        \f[B]\-\f[R] from\f[B]:\f[R] 10.10.10.42
    \f[B][\f[R]...\f[B]]\f[R]
  bridges\f[B]:\f[R]
    br0\f[B]:\f[R]
      interfaces\f[B]:\f[R] \f[B][]\f[R]
.EE
.SS "ویژگی‌های نوع دستگاه \f[CR]nm\-devices\f[R] (Properties for device type nm-devices)"
\f[B]وضعیت (Status)\f[R]: اختیاری.
استفاده از آن توصیه نمی‌شود.
.PP
\f[B]هدف (Purpose)\f[R]: از کلید \f[CR]nm\-devices\f[R] برای پیکربندی انواع دستگاه‌هایی که توسط Netplan پشتیبانی نمی‌شوند استفاده کنید.
این یک پیکربندی مختص NetworkManager است.
.PP
\f[B]ساختار (Structure)\f[R]: این کلید شامل نگاشتی از اتصالات NetworkManager است.
نوع دستگاه \f[CR]nm\-devices\f[R] فقط برای استفاده داخلی است و نباید در فایل‌های پیکربندی معمولی استفاده شود.
این گزینه یک حالت بازگشتی (fallback) را برای تنظیمات پشتیبانی‌نشده، با استفاده از نگاشت \f[CR]passthrough\f[R] فعال می‌کند.
ساختار کلی پیکربندی برای اتصالات NM در زیر نشان داده شده است:
.IP
.EX
network\f[B]:\f[R]
  version\f[B]:\f[R] 2
  nm\-devices\f[B]:\f[R]
    NM\-db5f0f67\-1f4c\-4d59\-8ab8\-3d278389cf87\f[B]:\f[R]
      renderer\f[B]:\f[R] NetworkManager
      networkmanager\f[B]:\f[R]
        uuid\f[B]:\f[R] \[dq]db5f0f67\-1f4c\-4d59\-8ab8\-3d278389cf87\[dq]
        name\f[B]:\f[R] \[dq]myvpnconnection\[dq]
        passthrough\f[B]:\f[R]
          connection.type\f[B]:\f[R] \[dq]vpn\[dq]
          vpn.ca\f[B]:\f[R] \[dq]path to ca.crt\[dq]
          vpn.cert\f[B]:\f[R] \[dq]path to client.crt\[dq]
          vpn.cipher\f[B]:\f[R] \[dq]AES\-256\-GCM\[dq]
          vpn.connection\-type\f[B]:\f[R] \[dq]tls\[dq]
          vpn.dev\f[B]:\f[R] \[dq]tun\[dq]
          vpn.key\f[B]:\f[R] \[dq]path to client.key\[dq]
          vpn.remote\f[B]:\f[R] \[dq]1.2.3.4:1194\[dq]
          vpn.service\-type\f[B]:\f[R] \[dq]org.freedesktop.NetworkManager.openvpn\[dq]
.EE
.SS "پارامترهای پیکربندی خاص بک‌اند (Back end-specific configuration parameters)"
علاوه بر سایر فیلدهای موجود برای پیکربندی رابط‌ها، برخی از بک‌اندها ممکن است نیاز به ثبت برخی پارامترهای خود در Netplan داشته باشند، به ویژه اگر تعاریف Netplan به صورت خودکار توسط مصرف‌کننده آن بک‌اند تولید شوند.
در حال حاضر، این مورد فقط با \f[CR]NetworkManager\f[R] استفاده می‌شود.
.IP \[bu] 2
\f[B]\f[CB]networkmanager\f[B]\f[R] (نگاشت) \[en] از نسخه 0.99
.RS 2
.RS
.PP
پارامترهای پیکربندی خاص NetworkManager را که توسط دیمن برای شناسایی اتصالات استفاده می‌شود، نگه می‌دارد.
.RE
.IP \[bu] 2
\f[B]\f[CB]name\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
نام نمایشی را برای اتصال تنظیم می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]uuid\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
مقدار UUID (شناسه یکتا) را برای این اتصال، همان‌طور که توسط خود NetworkManager تولید شده است، تعریف می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]stable\-id\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
شناسه پایدار (stable ID - شکل متفاوتی از نام اتصال) مورد استفاده توسط NetworkManager را در صورتی که نام اتصال ممکن است به گونه‌ای دیگر تغییر کند، مانند زمانی که اتصالات بین کاربران به اشتراک گذاشته می‌شود، تعریف می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]device\f[B]\f[R] (اسکالر) \[en] از نسخه 0.99
.RS 2
.RS
.PP
نام رابطی را که این اتصال برای آن اعمال می‌شود، تعریف می‌کند.
.RE
.RE
.IP \[bu] 2
\f[B]\f[CB]passthrough\f[B]\f[R] (نگاشت) \[en] از نسخه 0.102
.RS 2
.RS
.PP
می‌تواند به عنوان یک سازوکار بازگشتی (fallback) برای تنظیمات ناموجود key\-file استفاده شود.
.RE
.RE
.RE
.SH "مشاهده نیز (SEE ALSO)"
\f[B]\f[CB]netplan\-generate\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-apply\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-try\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-get\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-set\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-info\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-ip\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-rebind\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-status\f[B]\f[R](8)،
\f[B]\f[CB]netplan\-dbus\f[B]\f[R](8)،
\f[B]\f[CB]systemd\-networkd\f[B]\f[R](8)،
\f[B]\f[CB]NetworkManager\f[B]\f[R](8)
.SH "نویسندگان (AUTHORS)"
Mathieu Trudel\-Lapierre (\c
.MT cyphermox@ubuntu.com
.ME \c
)؛ Martin Pitt (\c
.MT martin.pitt@ubuntu.com
.ME \c
)؛ Lukas Märdian (\c
.MT slyon@ubuntu.com
.ME \c
).