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

.SH "نام (NAME)"
docker-image-import \- وارد کردن محتویات از یک فایل فشرده tarball برای ایجاد یک ایمیج فایل‌سیستم


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker image import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]\fP


.SH "شرح (DESCRIPTION)"
ایجاد یک ایمیج فایل‌سیستم جدید از محتویات یک فایل tarball (\fB\&.tar\fR،
\fB\&.tar.gz\fR، \fB\&.tgz\fR، \fB\&.bzip\fR، \fB\&.tar.xz\fR، \fB\&.txz\fR) در آن، سپس تگ‌گذاری اختیاری آن.


.SH "مثال‌ها (EXAMPLES)"
.SH "وارد کردن از یک مکان دوردست (Import from a remote location)"
.EX
# docker image import http://example.com/exampleimage.tgz example/imagerepo
.EE

.SH "وارد کردن از یک فایل محلی (Import from a local file)"
وارد کردن به داکر از طریق لوله و ورودی استاندارد stdin:

.EX
# cat exampleimage.tgz | docker image import - example/imagelocal
.EE

.PP
وارد کردن همراه با پیام ثبت (commit message).

.EX
# cat exampleimage.tgz | docker image import --message "New image imported from tarball" - exampleimagelocal:new
.EE

.PP
وارد کردن به یک ایمیج داکر از یک فایل محلی.

.EX
# docker image import /path/to/exampleimage.tgz
.EE

.SH "وارد کردن از یک فایل محلی و تگ‌گذاری (Import from a local file and tag)"
وارد کردن به داکر از طریق لوله و ورودی استاندارد stdin:

.EX
# cat exampleimageV2.tgz | docker image import - example/imagelocal:V-2.0
.EE

.SH "وارد کردن از یک دایرکتوری محلی (Import from a local directory)"
.EX
# tar -c . | docker image import - exampleimagedir
.EE

.SH "اعمال دستورالعمل‌های مشخص‌شده در Dockerfile هنگام وارد کردن ایمیج (Apply specified Dockerfile instructions while importing the image)"
این مثال متغیر محیطی ENV داکر با نام DEBUG را به صورت پیش‌فرض روی true تنظیم می‌کند.

.EX
# tar -c . | docker image import -c="ENV DEBUG=true" - exampleimagedir
.EE

.SH "هنگامی که دیمن از چندین سیستم‌عامل پشتیبانی می‌کند (When the daemon supports multiple operating systems)"
اگر دیمن از چندین سیستم‌عامل پشتیبانی کند، و ایمیج در حال وارد شدن
با سیستم‌عامل پیش‌فرض مطابقت نداشته باشد، ممکن است نیاز به افزودن
\fB--platform\fR باشد\&. این مورد هنگام وارد کردن یک ایمیج لینوکس به یک دیمن ویندوز
لازم خواهد بود.

.EX
# docker image import --platform=linux .\\linuximage.tar
.EE


.SH "ببینید (See also)"
\fBdocker-export(1)\fP برای صادر کردن محتویات یک فایل‌سیستم به عنوان یک آرشیو tar به STDOUT.


.SH "گزینه‌ها (OPTIONS)"
\fB-c\fP, \fB--change\fP=
	اعمال دستورالعمل Dockerfile بر روی ایمیج ایجادشده

.PP
\fB-m\fP, \fB--message\fP=""
	تنظیم پیام ثبت (commit message) برای ایمیج واردشده

.PP
\fB--platform\fP=""
	تنظیم پلتفرم اگر سرور توانایی پشتیبانی از چند پلتفرم را دارد


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