.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-create 1 2026-08-01 "" ""
.SH "نام (NAME)"
lxc-create \- ساخت یک کانتینر جدید در سامانه کانتینرسازی LXC
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBlxc-create\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-f \fIconfig_file\fR] {-t \fItemplate\fR} [-B \fIbackingstore\fR] [-- \fItemplate-options\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور \fBlxc-create\fR یک شیء سیستمی ایجاد می‌کند که در آن اطلاعات پیکربندی نگهداری شده و اطلاعات کاربر نیز می‌تواند در آن ذخیره گردد. شناسه \fIname\fR برای مشخص کردن کانتینر جهت استفاده با دستورات مختلف lxc به کار می‌رود.
.PP
این شیء پوشه‌ای است که در مسیر \*(T<\fI/var/lib/lxc\fR\*(T> ایجاد شده و با نام خود شناسایی می‌شود.
.PP
این شیء در واقع تعریف منابع مختلفی است که یک برنامه کاربردی می‌تواند از آن‌ها استفاده کرده یا آن‌ها را ببیند. هرچه فایل پیکربندی حاوی اطلاعات بیشتری باشد، کانتینر ایزوله‌تر شده و برنامه بیشتر در محیط امن محدود (jail) می‌گردد.
.PP
اگر فایل پیکربندی \fIconfig_file\fR مشخص نشود، کانتینر با سطوح ایزولاسیون پیش‌فرض ایجاد خواهد شد: فرایندها (processes)، ارتباطات بین‌فرایندی سیس‌وی (SysV IPC) و نقاط اتصال (mount points).
.SH "گزینه‌ها (OPTIONS)"
.TP
\*(T<\fB\-f, \-\-config \fR\*(T>\fIconfig_file\fR
مشخص کردن فایل پیکربندی جهت تنظیم قابلیت‌های مجازی‌سازی و ایزولاسیون کانتینر.
.TP
\*(T<\fB\-t, \-\-template \fR\*(T>\fItemplate\fR
عبارت 'template' نام کوتاه یکی از اسکریپت‌های موجود 'lxc-template' است که توسط lxc-create فراخوانی می‌شود؛ مانند busybox، debian، fedora، ubuntu یا sshd.
برای مشاهده جزئیات ساختار اسکریپت مورد انتظار، به نمونه‌های موجود در مسیر \*(T<\fI/usr/share/lxc/templates\fR\*(T> مراجعه کنید.
همچنین می‌توان مسیر کامل یک اسکریپت الگوی اجرایی را به عنوان پارامتر ارسال کرد.
مقدار "none" را می‌توان برای وادار کردن lxc-create به صرف‌نظر از ساخت rootfs استفاده کرد.
.TP
\*(T<\fB\-B, \-\-bdev \fR\*(T>\fIbackingstore\fR
نوع فضای ذخیره‌سازی پشتیبان ('backingstore') یکی از موارد 'dir'، 'lvm'، 'loop'، 'btrfs'، 'zfs'، 'rbd' یا 'best' است. مقدار پیش‌فرض 'dir' است؛ به این معنی که سیستم‌فایل ریشه کانتینر پوشه‌ای در مسیر \*(T<\fI/var/lib/lxc/container/rootfs\fR\*(T> خواهد بود.
این نوع فضای ذخیره‌سازی اجازه می‌دهد گزینه اختیاری \fI--dir ROOTFS\fR مشخص شود؛ به این معنی که rootfs کانتینر باید به جای مسیر پیش‌فرض، در مسیر مشخص‌شده قرار گیرد. (نوع ذخیره‌سازی 'none' نام مستعاری برای 'dir' است.) اگر 'btrfs' مشخص شود، سیستم‌فایل مقصد باید btrfs باشد و rootfs کانتینر به عنوان یک ساب‌والیوم (subvolume) جدید ساخته خواهد شد. این کار امکان ایجاد کلون‌های مبتنی بر اسنپ‌شات (snapshot) را فراهم می‌کند، اما همچنین باعث می‌شود دستور rsync --one-filesystem با آن به عنوان یک سیستم‌فایل جداگانه رفتار کند.
اگر فضای ذخیره‌سازی 'lvm' باشد، یک دستگاه بلوکی lvm استفاده می‌شود و گزینه‌های تکمیلی زیر در دسترس خواهند بود:
گزینه \fI--lvname lvname1\fR یک LV به نام \*(T<\fIlvname1\fR\*(T> به جای نام پیش‌فرض (که همان نام کانتینر است) ایجاد می‌کند. گزینه \fI--vgname vgname1\fR این LV را در گروه حجم \*(T<\fIvgname1\fR\*(T> به جای پیش‌فرض (\*(T<\fIlxc\fR\*(T>) ایجاد می‌کند.
گزینه \fI--thinpool thinpool1\fR این LV را به عنوان یک حجم با تخصیص پویا (thin-provisioned) در استخر \*(T<\fIthinpool1\fR\*(T> به جای پیش‌فرض (\*(T<\fIlxc\fR\*(T>) می‌سازد.
گزینه \fI--fstype FSTYPE\fR یک سیستم‌فایل از نوع FSTYPE به جای نوع پیش‌فرض (که ext4 است) روی LV می‌سازد.
گزینه \fI--fssize SIZE\fR یک LV (و سیستم‌فایل) با اندازه SIZE به جای مقدار پیش‌فرض (که 1G است) ایجاد می‌کند.

اگر فضای ذخیره‌سازی 'loop' باشد، می‌توانید از \fI--fstype FSTYPE\fR و \fI--fssize SIZE\fR همانند 'lvm' استفاده کنید. مقادیر پیش‌فرض این گزینه‌ها مشابه 'lvm' است.

اگر فضای ذخیره‌سازی 'rbd' باشد، به یک پیکربندی معتبر در \*(T<\fIceph.conf\fR\*(T> و یک \*(T<\fIceph.client.admin.keyring\fR\*(T> تعریف‌شده نیاز خواهید داشت.
می‌توانید گزینه‌های زیر را مشخص کنید:
گزینه \fI--rbdname RBDNAME\fR یک دستگاه بلوکی به نام RBDNAME به جای نام پیش‌فرض (که نام کانتینر است) ایجاد می‌کند.
گزینه \fI--rbdpool POOL\fR دستگاه بلوکی را در استخری به نام POOL به جای مقدار پیش‌فرض ('lxc') می‌سازد.
گزینه \fI--rbduser RBDUSER\fR کاربر ceph با نام RBDUSER را برای ساخت دستگاه بلوکی به جای کاربر پیش‌فرض ('admin') مشخص می‌کند.

اگر فضای ذخیره‌سازی 'best' باشد، lxc به ترتیب btrfs، سپس zfs، سپس lvm و در نهایت فضای ذخیره‌سازی دایرکتوری (dir) را امتحان خواهد کرد.
.TP
\*(T<\fB\-\- \fR\*(T>\fItemplate-options\fR
این گزینه \fItemplate-options\fR را به عنوان آرگومان به الگو ارسال می‌کند. برای مشاهده فهرست گزینه‌های پشتیبانی‌شده توسط الگو، می‌توانید دستور زیر را اجرا کنید:
\fBlxc-create -t TEMPLATE -h\fR.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این گزینه‌ها میان بیشتر دستورات lxc مشترک هستند.
.TP
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
نمایش پیام راهنمای کامل‌تر نسبت به حالت معمول.
.TP
\*(T<\fB\-\-usage\fR\*(T>
نمایش پیام نحوه استفاده از دستور.
.TP
\*(T<\fB\-q, \-\-quiet\fR\*(T>
بی‌صدا کردن و جلوگیری از نمایش پیام‌های خروجی.
.TP
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
استفاده از یک مسیر جایگزین برای ذخیره کانتینر. مقدار پیش‌فرض /var/lib/lxc است.
.TP
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
هدایت خروجی گزارش‌ها به پرونده جایگزین \fIFILE\fR. حالت پیش‌فرض عدم ثبت لاگ در فایل است.
.TP
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
تنظیم اولویت ثبت گزارش‌ها روی \fILEVEL\fR. اولویت پیش‌فرض لاگ‌ها \*(T<ERROR\*(T> است. مقادیر مجاز عبارتند از:
\*(T<FATAL\*(T>، \*(T<ALERT\*(T>،
\*(T<CRIT\*(T>،
\*(T<WARN\*(T>، \*(T<ERROR\*(T>،
\*(T<NOTICE\*(T>، \*(T<INFO\*(T>،
\*(T<DEBUG\*(T>، \*(T<TRACE\*(T>.

توجه داشته باشید که این گزینه اولویت وقایع ثبت‌شده در پرونده لاگ جایگزین را تنظیم می‌کند و تاثیری بر وقایع ERROR چاپ‌شده در خروجی خطای استاندارد (stderr) ندارد.
.TP
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
استفاده از شناسه کانتینر \fINAME\fR.
قالب شناسه کانتینر یک رشته الفبایی-عددی است.
.TP
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
مشخص کردن فایل پیکربندی جهت تنظیم قابلیت‌های مجازی‌سازی و ایزولاسیون کانتینر.

در صورت وجود، این فایل پیکربندی حتی اگر از قبل یک فایل پیکربندی در کانتینر ساخته‌شده (از طریق lxc-create) وجود داشته باشد، استفاده خواهد شد.
.TP
\*(T<\fB\-\-version\fR\*(T>
نمایش شماره نسخه برنامه.
.SH "عیب‌یابی (DIAGNOSTIC)"
.TP
The container already exists
همان‌طور که در پیام ذکر شده است، شما در حال تلاش برای ایجاد کانتینری هستید که کانتینری هم‌نام با آن در سیستم وجود دارد. می‌توانید از دستور \fBlxc-ls\fR برای مشاهده فهرست کانتینرهای موجود در سیستم استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)