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

.SH "نام (NAME)"
docker-image-tag \- ایجاد برچسب TARGET_IMAGE که به SOURCE_IMAGE اشاره می‌کند


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker image tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]\fP


.SH "شرح (DESCRIPTION)"
یک نام مستعار جدید به ایمیجی در یک رجیستری اختصاص می‌دهد. این نام مستعار به نام کامل ایمیج، از جمله \fBTAG\fR اختیاری بعد از کاراکتر ':' اشاره دارد.


.SH "گزینه‌ها (OPTIONS)"
\fBNAME\fP
   نام ایمیج که از بخش‌های جداشده با خط مورب (slash) تشکیل شده است و می‌تواند به صورت اختیاری پیشوندی از نام میزبان رجیستری داشته باشد. نام میزبان باید از قوانین استاندارد DNS پیروی کند، اما نباید شامل زیرخط (underscore) باشد. در صورت وجود نام میزبان، می‌تواند به طور اختیاری با یک شماره درگاه به فرمت
   \fB:8080\fR\&
   دنبال شود. در صورت عدم درج، این دستور به طور پیش‌فرض از رجیستری عمومی داکر واقع در
   \fBregistry-1.docker.io\fR
   استفاده می‌کند. بخش‌های نام می‌توانند شامل حروف کوچک انگلیسی، ارقام و جداکننده‌ها باشند. جداکننده به صورت نقطه، یک یا دو زیرخط، یا یک یا چند خط تیره تعریف می‌شود. یک بخش نام نباید با جداکننده شروع شود یا خاتمه یابد.

.PP
\fBTAG\fP
   برچسبی که برای نسخه‌بندی و متمایز کردن ایمیج‌های هم‌نام به ایمیج اختصاص داده می‌شود. نام برچسب باید از نویسه‌های معتبر ASCII تشکیل شده و می‌تواند شامل حروف کوچک و بزرگ انگلیسی، ارقام، زیرخط، نقطه و خط تیره باشد. نام برچسب نباید با نقطه یا خط تیره شروع شود و حداکثر می‌تواند ۱۲۸ کاراکتر داشته باشد.


.SH "مثال‌ها (EXAMPLES)"
.SS "برچسب‌گذاری ایمیج با ارجاع به شناسه (ID)"
برای برچسب‌گذاری یک ایمیج محلی با شناسه "0e5574283393" درون مخزن "fedora" با برچسب "version1.0":

.EX
docker image tag 0e5574283393 fedora/httpd:version1.0
.EE

.SS "برچسب‌گذاری ایمیج با ارجاع به نام"
برای برچسب‌گذاری یک ایمیج محلی با نام "httpd" درون مخزن "fedora" با برچسب "version1.0":

.EX
docker image tag httpd fedora/httpd:version1.0
.EE

.PP
توجه داشته باشید که از آنجا که نام برچسب مشخص نشده است، نام مستعار برای نسخه محلی موجود
\fBhttpd:latest\fR\&
ایجاد می‌شود.

.SS "برچسب‌گذاری ایمیج با ارجاع به نام و برچسب"
برای برچسب‌گذاری یک ایمیج محلی با نام "httpd" و برچسب "test" درون مخزن "fedora" با برچسب "version1.0.test":

.EX
docker image tag httpd:test fedora/httpd:version1.0.test
.EE

.SS "برچسب‌گذاری ایمیج برای یک مخزن خصوصی"
پیش از ارسال (push) ایمیج به یک رجیستری خصوصی و نه رجیستری مرکزی داکر، باید آن را با نام میزبان و درگاه رجیستری (در صورت نیاز) برچسب‌گذاری کنید.

.EX
docker image tag 0e5574283393 myregistryhost:5000/fedora/httpd:version1.0
.EE


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