.nh .TH podman-network-create 1 .SH "نام (NAME)" podman-network-create \- ایجاد یک شبکه پودمن .SH "خلاصه دستور (SYNOPSIS)" \fBpodman network create\fP [\fIگزینه‌ها\fP] [\fIنام\fP] .SH "توضیحات (DESCRIPTION)" ایجاد یک پیکربندی شبکه برای استفاده با پودمن. پودمن به‌طور پیش‌فرض یک اتصال پل (bridge) ایجاد می‌کند. یک اتصال .I Macvlan را می‌توان با گزینه .B \-d macvlan ایجاد کرد. یک دستگاه والد برای macvlan یا ipvlan را می‌توان با گزینه .BR "\-o parent=" یا .BR "\-\-interface-name=" مشخص نمود. .PP اگر هیچ گزینه‌ای ارائه نشود، پودمن یک زیرشبکه آزاد و یک نام به شبکه اختصاص می‌دهد. .PP پس از اتمام ایجاد شبکه، پودمن نام شبکه تازه ایجادشده را نمایش می‌دهد. .SH "گزینه‌ها (OPTIONS)" .SS \fB\-\-disable\-dns\fR افزونه DNS را برای این شبکه غیرفعال می‌کند؛ این افزونه در صورت فعال بودن می‌تواند تحلیل نام کانتینر به کانتینر را انجام دهد. این قابلیت تنها با درایور \fBbridge\fR پشتیبانی می‌شود؛ برای سایر درایورها همیشه غیرفعال است. .SS \fB\-\-dns\fR=\fIipaddr\fR تنظیم کارسازهای DNS سفارشی. .PP از این گزینه می‌توان برای بازنویسی پیکربندی DNS ارسال‌شده به کانتینر استفاده کرد. معمولاً زمانی که پیکربندی DNS میزبان برای کانتینر نامعتبر است (مانند \fB127.0.0.1\fP) این کار ضروری است. در چنین حالتی، گزینه .B \-\-dns برای هر بار اجرا لازم است. .PP مقدار ویژه \fBnone\fP را می‌توان برای غیرفعال کردن ایجاد \fI/etc/resolv.conf\fP در کانتینر توسط پودمن مشخص کرد. در این صورت از فایل \fI/etc/resolv.conf\fP موجود در ایمیج بدون تغییر استفاده می‌شود. .PP توجه داشته باشید که ممکن است \fBipaddr\fP مستقیماً به \fI/etc/resolv.conf\fP کانتینر اضافه شود؛ هرچند این موضوع تضمین‌شده نیست. برای نمونه، ارسال یک شبکه سفارشی که \fIdns_enabled\fP آن روی \fItrue\fP تنظیم شده به .B \-\-network باعث می‌شود \fI/etc/resolv.conf\fP تنها به کارساز aardvark-dns ارجاع دهد. سپس aardvark-dns تمام پرس‌وجوهای نام‌های غیرکانتینری را به \fBipaddr\fP ارائه‌شده هدایت می‌کند. .SS \fB\-d\fR, \fB\-\-driver\fR=\fIdriver\fR درایور برای مدیریت شبکه. در حال حاضر \fBbridge\fR، \fBmacvlan\fR و \fBipvlan\fR پشتیبانی می‌شوند. مقدار پیش‌فرض \fBbridge\fR\& است. در هنگام اجرا بدون ریشه (rootless)، درایورهای \fBmacvlan\fR و \fBipvlan\fR به رابط‌های شبکه میزبان دسترسی ندارند، زیرا شبکه در حالت بدون ریشه به یک فضای نام شبکه جداگانه نیاز دارد. .PP بک‌اند netavark امکان استفاده از به‌اصطلاح \fIافزونه‌های netavark\fP را فراهم می‌کند؛ مستندات plugin-API.md را در netavark ببینید. فایل اجرایی باید در یک دایرکتوری مشخص قرار گیرد تا پودمن بتواند آن را شناسایی کند؛ این فهرست در \fBnetavark_plugin_dirs\fR در \fBcontainers.conf(5)\fP زیر بخش \fB[network]\fR تنظیم می‌شود. .PP سپس می‌توان از نام افزونه به عنوان درایور برای ایجاد شبکه برای افزونه خود استفاده کرد. فهرست همه درایورها و افزونه‌های پشتیبانی‌شده را می‌توان با دستور .B podman info \-\-format {{.Plugins.Network}} مشاهده کرد. .PP توجه داشته باشید که درایورهای \fBmacvlan\fR و \fBipvlan\fR از فوروارد پورت پشتیبانی نمی‌کنند. پشتیبانی از فوروارد پورت در افزونه‌ها به پیاده‌سازی خود افزونه بستگی دارد. .SS \fB\-\-gateway\fR=\fIip\fR تعریف یک دروازه (gateway) برای زیرشبکه. برای ارائه یک نشانی دروازه، تعیین گزینه \fIsubnet\fR الزامی است. می‌تواند چندین بار مشخص شود. .PP ترتیب آرگومان‌های گزینه‌های .BR \-\-subnet ، .B \-\-gateway و .B \-\-ip\-range باید با یکدیگر مطابقت داشته باشد. .SS \fB\-\-ignore\fR نادیده گرفتن درخواست ایجاد در صورتی که شبکه‌ای با همین نام از قبل وجود داشته باشد، به جای اعلام خطا. \fBنکته:\fP تلاش برای ایجاد شبکه‌ای با نام موجود اما پارامترهای متفاوت، پیکربندی شبکه موجود را تغییر نمی‌دهد. .SS \fB\-\-interface\-name\fR=\fIname\fR این گزینه با گزینه \fInetwork_interface\fR در پیکربندی شبکه منطبق است؛ .B podman network inspect را ببینید. بسته به درایور، این گزینه می‌تواند اثرات متفاوتی داشته باشد؛ برای \fBbridge\fR، از نام رابط پل استفاده می‌کند. برای \fBmacvlan\fR و \fBipvlan\fR، دستگاه والد روی میزبان است. این گزینه معادل .B \-\-opt parent=... است. .SS \fB\-\-internal\fR محدود کردن دسترسی خارجی این شبکه هنگام استفاده از یک شبکه \fBbridge\fR. توجه داشته باشید هنگام استفاده از بک‌اند CNI، DNS به‌طور خودکار غیرفعال خواهد شد؛ گزینه .B \-\-disable\-dns را ببینید. .PP هنگام استفاده از درایور \fBmacvlan\fR یا \fBipvlan\fR با این گزینه، هیچ مسیر پیش‌فرضی به کانتینر اضافه نخواهد شد. از آنجا که این کار پشته شبکه میزبان را دور می‌زند، هیچ محدودیت اضافی توسط پودمن قابل اعمال نیست، و اگر یک کانتینر ممتاز (privileged) اجرا شود، کانتینر می‌تواند خودش یک مسیر پیش‌فرض تنظیم کند. اگر این موضوع مایه نگرانی است، اتصالات کانتینر باید روی دروازه شبکه واقعی مسدود شوند. .PP استفاده از درایور \fBbridge\fR با این گزینه اثرات زیر را به همراه دارد: .IP \(bu 2 تنظیمات sysctl مربوط به فوروارد سراسری IP در فضای نام شبکه میزبان تغییر نخواهند کرد. .IP \(bu 2 فوروارد IP به جای راه‌اندازی دیوار آتش (firewall)، روی رابط پل غیرفعال می‌شود. .IP \(bu 2 هیچ مسیر پیش‌فرضی به کانتینر اضافه نخواهد شد. .PP در تمام موارد، زمانی که این گزینه فعال باشد aardvark-dns تنها نام‌های کانتینرها را تحلیل می‌کند. سایر پرس‌وجوها با پاسخ \fBNXDOMAIN\fR\& مواجه خواهند شد. .SS \fB\-\-ip\-range\fR=\fIrange\fR تخصیص IP کانتینر از یک محدوده. این محدوده باید یک زیرشبکه کامل در نمادگذاری CIDR باشد یا در ساختار \fB-\fR مشخص شود که در مقایسه با زیرشبکه CIDR دامنه انعطاف‌پذیرتری را فراهم می‌کند. گزینه .B \-\-ip\-range باید همراه با گزینه .B \-\-subnet استفاده شود. می‌تواند چندین بار مشخص گردد. .PP ترتیب آرگومان‌های گزینه‌های .BR \-\-subnet ، .B \-\-gateway و .B \-\-ip\-range باید با یکدیگر مطابقت داشته باشد. .SS \fB\-\-ipam\-driver\fR=\fIdriver\fR تنظیم درایور ipam (درایور مدیریت نشانی IP یا IP Address Management Driver) برای شبکه. در صورت عدم تنظیم، پودمن به‌طور خودکار بر اساس درایور شبکه یک درایور ipam انتخاب می‌کند. .PP مقادیر معتبر عبارتند از: .IP \(bu 2 \fBdhcp\fR: نشانی‌های IP از یک کارساز DHCP در شبکه اختصاص می‌یابند. هنگام استفاده از بک‌اند netavark، واحد \fBnetavark-dhcp-proxy.socket\fR باید فعال باشد تا پراکسی DHCP هنگام شروع یک کانتینر اجرا شود؛ برای CNI به جای آن از واحد \fBcni-dhcp.socket\fR استفاده کنید. .IP \(bu 2 \fBhost-local\fR: نشانی‌های IP به‌صورت محلی اختصاص می‌یابند. .IP \(bu 2 \fBnone\fR: هیچ نشانی IP به رابط‌ها اختصاص داده نمی‌شود. .PP مشاهده درایور در خروجی .B podman network inspect زیر فیلد \fBipam_options\fR امکان‌پذیر است. .SS \fB\-\-ipv6\fR فعال‌سازی شبکه IPv6 (پشته دوگانه یا Dual Stack). اگر هیچ زیرشبکه‌ای مشخص نشود، یک زیرشبکه IPv4 و یک زیرشبکه IPv6 اختصاص می‌دهد. .SS \fB\-\-label\fR=\fIkey=value\fR تنظیم یک یا چند برچسب OCI بر روی شبکه. .SS \fB\-o\fR, \fB\-\-opt\fR=\fIoption\fR تنظیم گزینه‌های مختص درایور. .PP همه درایورها گزینه‌های \fBmtu\fR، \fBmetric\fR و \fBno_default_route\fR را می‌پذیرند. .IP \(bu 2 \fBmtu\fR: بیشینه واحد انتقال (MTU) را تنظیم می‌کند و یک مقدار عدد صحیح می‌گیرد. .IP \(bu 2 \fBmetric\fR: متریک مسیر (Route Metric) را برای مسیر پیش‌فرض ایجادشده در هر کانتینر متصل به این شبکه تنظیم می‌کند. یک مقدار عدد صحیح مثبت می‌پذیرد. تنها با بک‌اند شبکه Netavark قابل استفاده است. .IP \(bu 2 \fBno_default_route\fR: اگر روی \fBtrue\fR تنظیم شود، پودمن به‌طور خودکار مسیر پیش‌فرضی به زیرشبکه‌ها اضافه نمی‌کند. مسیرها همچنان می‌توانند با ایجاد یک مسیر سفارشی با استفاده از .B \-\-route به‌صورت دستی اضافه شوند. .PP علاوه بر این، درایور \fBbridge\fR از گزینه‌های زیر پشتیبانی می‌کند: .IP \(bu 2 \fBvlan\fR: این گزینه یک برچسب VLAN اختصاص می‌دهد و vlan_filtering را فعال می‌سازد. مقدار پیش‌فرض none است. .IP \(bu 2 \fBisolate\fR: این گزینه شبکه‌های پل را از سایر شبکه‌های پل جدا (ایزوله) می‌کند. باید به‌صورت \fBisolate=\fR تنظیم شود (مقدار الزامی است؛ استفاده تنها از \fBisolate\fR نامعتبر است). مقدار پیش‌فرض \fBstrict\fR\& است. مقادیر پشتیبانی‌شده: .RS .IP \(bu 2 \fBstrict\fR: ترافیک ورودی و خروجی با تمام شبکه‌های پل دیگر را مسدود می‌کند. این حالت پیش‌فرض در صورت حذف گزینه است. .IP \(bu 2 \fBtrue\fR: ترافیک را تنها میان شبکه‌هایی مسدود می‌کند که جداسازی در آن‌ها نیز فعال است (\fBtrue\fR یا \fBstrict\fR). .IP \(bu 2 \fBfalse\fR: شبکه را جداسازی نمی‌کند؛ اجازه تبادل ترافیک با سایر شبکه‌های پل را می‌دهد. برای بازگرداندن رفتار پیش از پودمن نسخه ۶ / Netavark 2 از این مقدار استفاده کنید. .RE .IP \(bu 2 \fBcom.docker.network.bridge.name\fR: این گزینه نام ارائه‌شده را به پل لینوکس (Linux Bridge) ایجادشده اختصاص می‌دهد. .IP \(bu 2 \fBcom.docker.network.driver.mtu\fR: بیشینه واحد انتقال (MTU) را تنظیم می‌کند و یک مقدار عدد صحیح می‌پذیرد. .IP \(bu 2 \fBvrf\fR: این گزینه یک جدول مسیریابی هدایت و مسیریابی مجازی (VRF) به رابط پل اختصاص می‌دهد. نام VRF را می‌پذیرد و پیش‌فرض آن none است. تنها با بک‌اند شبکه Netavark قابل استفاده است. .IP \(bu 2 \fBmode\fR: این گزینه حالت مشخص‌شده پل را روی رابط تنظیم می‌کند. پیش‌فرض آن \fBmanaged\fR\& است. مقادیر پشتیبانی‌شده: .RS .IP \(bu 2 \fBmanaged\fR: پودمن پل را ایجاد و حذف کرده و مقادیر sysctl آن را تغییر می‌دهد. قوانین دیوار آتش را برای مبدل‌سازی (masquerade) ترافیک خروجی و همچنین راه‌اندازی فوروارد پورت برای ترافیک ورودی با استفاده از DNAT اضافه می‌کند. .IP \(bu 2 \fBunmanaged\fR: پودمن از یک پل موجود استفاده می‌کند. این پل باید تا زمانی که می‌خواهید کانتینری با استفاده از شبکه اجرا کنید، وجود داشته باشد. هیچ NAT یا فوروارد پورتی وجود نخواهد داشت، حتی اگر چنین گزینه‌هایی در هنگام ساخت کانتینر ارسال شده باشند. .RE .PP درایورهای \fBmacvlan\fR و \fBipvlan\fR از گزینه‌های زیر پشتیبانی می‌کنند: .IP \(bu 2 \fBparent\fR: دستگاه میزبان که برای رابط macvlan استفاده می‌شود. پیش‌فرض آن رابط دارای مسیر پیش‌فرض است. .IP \(bu 2 \fBmode\fR: این گزینه حالت مشخص‌شده ip/macvlan را روی رابط تنظیم می‌کند. .RS .IP \(bu 2 مقادیر پشتیبانی‌شده برای \fBmacvlan\fR عبارتند از \fBbridge\fR، \fBprivate\fR، \fBvepa\fR و \fBpassthru\fR\&. مقدار پیش‌فرض \fBbridge\fR\& است. .IP \(bu 2 مقادیر پشتیبانی‌شده برای \fBipvlan\fR عبارتند از \fBl2\fR، \fBl3\fR و \fBl3s\fR\&. مقدار پیش‌فرض \fBl2\fR\& است. .RE .PP علاوه بر این، درایور \fBmacvlan\fR از گزینه \fBbclim\fR پشتیبانی می‌کند: .IP \(bu 2 \fBbclim\fR: آستانه برای صف‌بندی برودکست (پخش همگانی) را تنظیم می‌کند. باید یک عدد صحیح ۳۲ بیتی باشد. تنظیم این مقدار روی \fB-1\fR صف‌بندی برودکست را به‌طور کلی غیرفعال می‌کند. .SS \fB\-\-route\fR=\fIroute\fR یک مسیر ایستا در قالب \fB,,\fR\&. دروازه (gateway) باید یک نشانی IP معتبر باشد یا در غیر این صورت می‌توان به جای آن نوعی مشخص کرد که باید یکی از مقادیر \fBblackhole\fR، \fBunreachable\fR یا \fBprohibit\fR باشد که بدین معنی است که ترافیک زیرشبکه به هیچ جا مسیریابی نخواهد شد. این مسیر به تمام کانتینرهای موجود در این شبکه اضافه خواهد شد. در صورتی که بیش از یک مسیر ایستا مد نظر باشد، می‌تواند چندین بار مشخص شود. .PP توجه داشته باشید مسیرها درون فضای نام کانتینر اضافه می‌شوند؛ اگر به یک کانتینر قابلیت CAP_NET_ADMIN داده شده باشد، می‌تواند مسیرها را تغییر دهد، بنابراین در این حالت نمی‌توان از آن برای مسائل مرتبط با امنیت استفاده کرد. .SS \fB\-\-subnet\fR=\fIsubnet\fR زیرشبکه در نمادگذاری CIDR. برای تخصیص بیش از یک زیرشبکه برای این شبکه، می‌تواند چندین بار مشخص شود. .PP ترتیب آرگومان‌های گزینه‌های .BR \-\-subnet ، .B \-\-gateway و .B \-\-ip\-range باید با یکدیگر مطابقت داشته باشد. .PP این گزینه برای تنظیم یک زیرشبکه ایستای IPv4 و IPv6 مفید است. .SH "مثال‌ها (EXAMPLES)" ایجاد یک شبکه بدون هیچ گزینه‌ای: .EX $ podman network create podman2 .EE .PP ایجاد شبکه‌ای به نام \fInewnet\fP که از \fI192.5.0.0/16\fP برای زیرشبکه خود استفاده می‌کند: .EX $ podman network create --subnet 192.5.0.0/16 newnet newnet .EE .PP ایجاد یک شبکه IPv6 با نام \fInewnetv6\fP با زیرشبکه \fI2001:db8::/64\fP\&: .EX $ podman network create --subnet 2001:db8::/64 --ipv6 newnetv6 newnetv6 .EE .PP ایجاد شبکه‌ای به نام \fInewnet\fP که از \fI192.168.33.0/24\fP استفاده کرده و یک دروازه به صورت \fI192.168.33.3\fP\& تعریف می‌کند: .EX $ podman network create --subnet 192.168.33.0/24 --gateway 192.168.33.3 newnet newnet .EE .PP ایجاد شبکه‌ای که از یک زیرشبکه \fI192.168.55.0/24\fP استفاده کرده و دارای محدوده نشانی IP از \fI192.168.55.129 - 192.168.55.254\fP\& است: .EX $ podman network create --subnet 192.168.55.0/24 --ip-range 192.168.55.128/25 podman5 .EE .PP ایجاد شبکه‌ای با زیرشبکه ایستای IPv4 و IPv6 و تعیین یک دروازه: .EX $ podman network create --subnet 192.168.55.0/24 --gateway 192.168.55.3 --subnet fd52:2a5a:747e:3acd::/64 --gateway fd52:2a5a:747e:3acd::10 podman4 .EE .PP ایجاد شبکه‌ای با یک زیرشبکه ایستا و یک مسیر ایستا: .EX $ podman network create --subnet 192.168.33.0/24 --route 10.1.0.0/24,192.168.33.10 newnet .EE .PP ایجاد شبکه‌ای با یک زیرشبکه ایستا و یک مسیر ایستا بدون مسیر پیش‌فرض: .EX $ podman network create --subnet 192.168.33.0/24 --route 10.1.0.0/24,192.168.33.10 --opt no_default_route=true newnet .EE .PP ایجاد یک شبکه پل بدون جداسازی (isolation) از سایر شبکه‌های پل (جداسازی به‌طور پیش‌فرض \fBstrict\fR است). این گزینه باید به‌صورت \fBkey=value\fR\& داده شود: .EX $ podman network create --opt isolate=false mynet mynet .EE .PP ایجاد شبکه‌ای با یک مسیر از نوع blackhole (سیاه‌چاله). این بدان معنی است که ترافیک ارسالی به زیرشبکه مقصد بدون اعلام خطا نادیده گرفته و دور انداخته می‌شود: .EX $ podman network create --route 10.1.0.0/24,blackhole --opt no_default_route=true newnet .EE .PP ایجاد یک شبکه مبتنی بر Macvlan با استفاده از رابط میزبان eth0. شبکه‌های Macvlan فقط با دسترسی کاربر ریشه (root) قابل استفاده هستند: .EX $ sudo podman network create -d macvlan -o parent=eth0 --subnet 192.5.0.0/16 newnet newnet .EE .SH "همچنین ببینید (SEE ALSO)" \fBpodman(1)\fP, \fBpodman-network(1)\fP, \fBpodman-network-inspect(1)\fP, \fBpodman-network-ls(1)\fP, \fBcontainers.conf(5)\fP .SH "تاریخچه (HISTORY)" اوت ۲۰۲۱، با قالب شبکه جدید توسط Paul Holzinger pholzing@redhat.com \[la]mailto:pholzing@redhat.com\[ra] به‌روزرسانی شد. .PP اوت ۲۰۱۹، در ابتدا توسط Brent Baude bbaude@redhat.com \[la]mailto:bbaude@redhat.com\[ra] گردآوری شد.