.nh
.TH "DOCKER" "1" "Aug 2026" "Docker Community" "Docker User Manuals"

.SH "نام (NAME)"
docker-network-connect \- اتصال یک کانتینر به یک شبکه


.SH "خلاصه (SYNOPSIS)"
\fBdocker network connect [OPTIONS] NETWORK CONTAINER\fP


.SH "شرح (DESCRIPTION)"
یک کانتینر را به یک شبکه متصل می‌کند. می‌توانید کانتینر را با نام
یا شناسه (ID) آن متصل کنید. پس از اتصال، کانتینر می‌تواند با سایر کانتینرهای
همان شبکه ارتباط برقرار کند.

.EX
$ docker network connect multi-host-network container1
.EE

.PP
همچنین می‌توانید از گزینه \fBdocker run --network=<network-name>\fR برای راه‌اندازی کانتینر و اتصال فوری آن به یک شبکه استفاده کنید.

.EX
$ docker run -itd --network=multi-host-network --ip 172.20.88.22 --ip6 2001:db8::8822 busybox
.EE

.PP
می‌توانید کانتینرهایی را که به یک شبکه متصل هستند موقتاً متوقف (pause)، بازراه‌اندازی (restart) یا متوقف (stop) کنید.
کانتینر هنگام اجرا به شبکه‌های پیکربندی‌شده خود متصل می‌شود.

.PP
در صورت مشخص شدن، با بازراه‌اندازی کانتینر متوقف‌شده، نشانی (یا نشانی‌های) IP کانتینر مجدداً اعمال می‌شود. اگر نشانی IP دیگر در دسترس نباشد، راه‌اندازی کانتینر
با شکست مواجه می‌شود. یک راه برای اطمینان از در دسترس بودن نشانی IP،
مشخص کردن یک \fB--ip-range\fR هنگام ایجاد شبکه و انتخاب نشانی (یا نشانی‌های) IP ایستا
از خارج آن محدوده است. این کار تضمین می‌کند که تا زمانی که این کانتینر در شبکه نیست، نشانی IP
به کانتینر دیگری اختصاص داده نشود.

.EX
$ docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 multi-host-network

$ docker network connect --ip 172.20.128.2 multi-host-network container2
.EE

.PP
برای بررسی اتصال کانتینر، از دستور \fBdocker network inspect\fR استفاده کنید. برای جدا کردن یک کانتینر از شبکه از \fBdocker network disconnect\fR استفاده کنید.

.PP
پس از اتصال در شبکه، کانتینرها می‌توانند صرفاً با استفاده از نام یا نشانی IP یک کانتینر دیگر
با آن ارتباط برقرار کنند. برای شبکه‌های \fBoverlay\fR یا افزونه‌های سفارشی که
از اتصال چندمیزبانه پشتیبانی می‌کنند، کانتینرهایی که به یک شبکه چندمیزبانه متصل هستند
اما از موتورهای متفاوتی اجرا شده‌اند نیز می‌توانند از همین طریق ارتباط برقرار کنند.

.PP
می‌توانید یک کانتینر را به یک یا چند شبکه متصل کنید. نیازی نیست شبکه‌ها از یک نوع باشند. برای مثال، می‌توانید یک کانتینر را به شبکه‌های bridge و overlay متصل کنید.


.SH "گزینه‌ها (OPTIONS)"
\fB--alias\fP=[]
	افزودن نام مستعار در حوزه شبکه برای کانتینر

.PP
\fB--driver-opt\fP=[]
	گزینه‌های درایور برای شبکه

.PP
\fB--gw-priority\fP=0
	بالاترین gw-priority دروازه پیش‌فرض (default gateway) را تعیین می‌کند. مقادیر مثبت و منفی را می‌پذیرد.

.PP
\fB--ip\fP=
	نشانی IPv4 (به‌عنوان مثال، "172.30.100.104")

.PP
\fB--ip6\fP=
	نشانی IPv6 (به‌عنوان مثال، "2001:db8::33")

.PP
\fB--link\fP=
	افزودن پیوند به کانتینری دیگر

.PP
\fB--link-local-ip\fP=[]
	افزودن نشانی link-local برای کانتینر


.SH "ببینید (SEE ALSO)"
\fBdocker-network(1)\fP