'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ARCHINSTALL" "1" "Jun 28, 2026" "" "python-archinstall"
.SH "نام (NAME)"
archinstall \- نصاب متنی هدایت‌شده و کتابخانه پایتون برای آرچ لینوکس
.sp
\fBarchinstall\fP یک کتابخانه است که می‌تواند برای نصب آرچ لینوکس مورد استفاده قرار گیرد.
این کتابخانه همراه با نصاب‌های از پیش پیکربندی‌شده گوناگون ارائه می‌شود، مانند نصاب پیش‌فرض نصب هدایت‌شده \%<#\:guided>.
.sp
برخی از ویژگی‌های Archinstall عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBسازگار با زمینه (Context friendly):\fP این کتابخانه فراخوانی‌ها را همواره به ترتیب متوالی اجرا می‌کند تا اطمینان حاصل شود مراحل نصب با یکدیگر تداخل ندارند یا با ترتیب اشتباه اجرا نمی‌شوند. این کتابخانه همچنین از بسته‌بندهای زمینه‌ای (context wrappers) برای اطمینان از پاک‌سازی و فراخوانی وظایف نهایی مانند \fBmkinitcpio\fP در زمان نیاز پشتیبانی \fI(و استفاده)\fP می‌کند.
.IP \(bu 2
\fBشفافیت کامل:\fP گزارش‌ها و جزئیات عملکردی را می‌توان در مسیر \fB/var/log/archinstall\fP هم در ایزوی زنده (Live ISO) و هم تا حدودی در سیستم نصب‌شده یافت.
.IP \(bu 2
\fBسازگار با قابلیت‌های دسترسی:\fP به لطف استفاده از رابط کاربری متنی (TUI)، نرم‌افزار Archinstall با \fBespeakup\fP و سایر ابزارهای دسترسی‌پذیری کار می‌کند.
.UNINDENT
.SH "نصب هدایت‌شده (GUIDED INSTALLATION)"
.sp
نرم‌افزار Archinstall همراه با یک نصاب هدایت‌شده از پیش برنامه‌ریزی‌شده \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:scripts/\:guided\:.py> عرضه می‌شود که شما را در مراحل اجباری و همچنین برخی پیکربندی‌های اختیاری ممکن راهنمایی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سایر اسکریپت‌های از پیش برنامه‌ریزی‌شده را می‌توان با اجرای \fBarchinstall \-\-script <script>\fP \fI(بدون .py)\fP فراخوانی کرد. برای مشاهده فهرست کامل اسکریپت‌ها، دستور \fBarchinstall \-\-script list\fP را اجرا کنید یا دایرکتوری اسکریپت‌های سورس‌کد \%<https://\:github\:.com/\:archlinux/\:archinstall/\:tree/\:master/\:archinstall/\:scripts> را بررسی نمایید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توصیه می‌شود \fBarchinstall\fP را از روی ایمیج رسمی ISO آرچ لینوکس اجرا کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
نصاب پیش از شروع فرآیند نصب، وای‌فای (WiFi) را پیکربندی نخواهد کرد. لازم است پیش از ادامه، راهنمای پیکربندی شبکه در آرچ لینوکس \%<https://\:wiki\:.archlinux\:.org/\:index\:.php/\:Network_configuration> را مطالعه کنید.
.UNINDENT
.UNINDENT
.SS "اجرای نصب هدایت‌شده (Running the guided installation)"
.sp
برای شروع نصاب، دستور زیر را در جدیدترین ISO آرچ لینوکس اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که نصاب هدایت‌شده \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:scripts/\:guided\:.py> اسکریپت پیش‌فرض است، اجرای این دستور معادل اجرای \fBarchinstall guided\fP می‌باشد.
.sp
نصب هدایت‌شده همچنین از نصب با پاسخ‌های از پیش پیکربندی‌شده برای تمام مراحل هدایت‌شده پشتیبانی می‌کند. این روش می‌تواند شیوه‌ای سریع و راحت برای اجرای دوباره یک یا چند نصب باشد.
.sp
دو فایل پیکربندی وجود دارد که استفاده از هر دوی آن‌ها اختیاری است.
.SS \fB\-\-config\fP
.sp
این پارامتر یک فایل محلی \fB\&.json\fP را به عنوان آرگومان می‌پذیرد و شامل پیکربندی کلی و پاسخ‌های منوها برای نصاب هدایت‌شده است.
.SS \fB\-\-config\-url\fP
.sp
این پارامتر یک فایل راه دور \fB\&.json\fP را به عنوان آرگومان می‌پذیرد و شامل پیکربندی کلی و پاسخ‌های منوها برای نصاب هدایت‌شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
همواره می‌توانید با دستور \fBarchinstall \-\-dry\-run\fP جدیدترین گزینه‌ها را برای این فایل به دست آورید؛ این فرمان نصاب هدایت‌شده را در یک حالت ایمن اجرا می‌کند که در آن هیچ اقدام دائمی روی سیستم شما اعمال نمی‌شود، بلکه یک اجرای شبیه‌سازی‌شده انجام شده و پیکربندی روی دیسک ذخیره می‌گردد.
.UNINDENT
.UNINDENT
.SS "نمونه‌های کاربردی (Example usage)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall \-\-config config.json
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
archinstall \-\-config\-url https://domain.lan/config.json
.EE
.UNINDENT
.UNINDENT
.sp
محتویات فایل \fBhttps://domain.lan/config.json\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqadditional\-repositories\(dq: [],
  \(dqarchinstall\-language\(dq: \(dqEnglish\(dq,
  \(dqaudio_config\(dq: null,
  \(dqbootloader_config\(dq: {
    \(dqbootloader\(dq: \(dqSystemd\-boot\(dq,
    \(dquki\(dq: false,
    \(dqremovable\(dq: false
  },
  \(dqbootloader\(dq: \(dqSystemd\-boot\(dq,
  \(dqdebug\(dq: false,
  \(dqdisk_config\(dq: {
    \(dqconfig_type\(dq: \(dqmanual_partitioning\(dq,
    \(dqdevice_modifications\(dq: [
      {
        \(dqdevice\(dq: \(dq/dev/sda\(dq,
        \(dqpartitions\(dq: [
          {
            \(dqbtrfs\(dq: [],
            \(dqflags\(dq: [
              \(dqboot\(dq
            ],
            \(dqfs_type\(dq: \(dqfat32\(dq,
            \(dqlength\(dq: {
              \(dqsector_size\(dq: null,
              \(dqtotal_size\(dq: null,
              \(dqunit\(dq: \(dqB\(dq,
              \(dqvalue\(dq: 99982592
            },
            \(dqmount_options\(dq: [],
            \(dqmountpoint\(dq: \(dq/boot\(dq,
            \(dqobj_id\(dq: \(dq369f31a8\-2781\-4d6b\-96e7\-75680552b7c9\(dq,
            \(dqstart\(dq: {
              \(dqsector_size\(dq: {
                \(dqsector_size\(dq: null,
                \(dqtotal_size\(dq: null,
                \(dqunit\(dq: \(dqB\(dq,
                \(dqvalue\(dq: 512
              },
              \(dqtotal_size\(dq: null,
              \(dqunit\(dq: \(dqsectors\(dq,
              \(dqvalue\(dq: 34
            },
            \(dqstatus\(dq: \(dqcreate\(dq,
            \(dqtype\(dq: \(dqprimary\(dq
          },
          {
            \(dqbtrfs\(dq: [],
            \(dqflags\(dq: [],
            \(dqfs_type\(dq: \(dqfat32\(dq,
            \(dqlength\(dq: {
              \(dqsector_size\(dq: null,
              \(dqtotal_size\(dq: null,
              \(dqunit\(dq: \(dqB\(dq,
              \(dqvalue\(dq: 100000000
            },
            \(dqmount_options\(dq: [],
            \(dqmountpoint\(dq: \(dq/efi\(dq,
            \(dqobj_id\(dq: \(dq13cf2c96\-8b0f\-4ade\-abaa\-c530be589aad\(dq,
            \(dqstart\(dq: {
              \(dqsector_size\(dq: {
                \(dqsector_size\(dq: null,
                \(dqtotal_size\(dq: null,
                \(dqunit\(dq: \(dqB\(dq,
                \(dqvalue\(dq: 512
              },
              \(dqtotal_size\(dq: {
                \(dqsector_size\(dq: null,
                \(dqtotal_size\(dq: null,
                \(dqunit\(dq: \(dqB\(dq,
                \(dqvalue\(dq: 16106127360
              },
              \(dqunit\(dq: \(dqMB\(dq,
              \(dqvalue\(dq: 100
            },
            \(dqstatus\(dq: \(dqcreate\(dq,
            \(dqtype\(dq: \(dqprimary\(dq
          },
          {
            \(dqbtrfs\(dq: [],
            \(dqflags\(dq: [],
            \(dqfs_type\(dq: \(dqext4\(dq,
            \(dqlength\(dq: {
              \(dqsector_size\(dq: null,
              \(dqtotal_size\(dq: null,
              \(dqunit\(dq: \(dqB\(dq,
              \(dqvalue\(dq: 15805127360
            },
            \(dqmount_options\(dq: [],
            \(dqmountpoint\(dq: \(dq/\(dq,
            \(dqobj_id\(dq: \(dq3e75d045\-21a4\-429d\-897e\-8ec19a006e8b\(dq,
            \(dqstart\(dq: {
              \(dqsector_size\(dq: {
                \(dqsector_size\(dq: null,
                \(dqtotal_size\(dq: null,
                \(dqunit\(dq: \(dqB\(dq,
                \(dqvalue\(dq: 512
              },
              \(dqtotal_size\(dq: {
                \(dqsector_size\(dq: null,
                \(dqtotal_size\(dq: null,
                \(dqunit\(dq: \(dqB\(dq,
                \(dqvalue\(dq: 16106127360
              },
              \(dqunit\(dq: \(dqMB\(dq,
              \(dqvalue\(dq: 301
            },
            \(dqstatus\(dq: \(dqcreate\(dq,
            \(dqtype\(dq: \(dqprimary\(dq
          }
        ],
        \(dqwipe\(dq: false
      }
    ]
  },
  \(dqdisk_encryption\(dq: {
    \(dqencryption_type\(dq: \(dqluks\(dq,
    \(dqpartitions\(dq: [
      \(dq3e75d045\-21a4\-429d\-897e\-8ec19a006e8b\(dq
    ]
  },
  \(dqhostname\(dq: \(dqarchlinux\(dq,
  \(dqkernels\(dq: [
    \(dqlinux\(dq
  ],
  \(dqlocale_config\(dq: {
    \(dqkb_layout\(dq: \(dqus\(dq,
    \(dqsys_enc\(dq: \(dqUTF\-8\(dq,
    \(dqsys_lang\(dq: \(dqen_US\(dq
  },
  \(dqmirror_config\(dq: {
    \(dqcustom_servers\(dq: [
      {
        \(dqurl\(dq: \(dqhttps://mymirror.com/$repo/os/$arch\(dq
      }
    ],
    \(dqmirror_regions\(dq: {
      \(dqAustralia\(dq: [
        \(dqhttp://archlinux.mirror.digitalpacific.com.au/$repo/os/$arch\(dq
      ]
    },
    \(dqoptional_repositories\(dq: [
      \(dqtesting\(dq
    ],
    \(dqcustom_repositories\(dq: [
      {
        \(dqname\(dq: \(dqmyrepo\(dq,
        \(dqurl\(dq: \(dqhttps://myrepo.com/$repo/os/$arch\(dq,
        \(dqsign_check\(dq: \(dqRequired\(dq,
        \(dqsign_option\(dq: \(dqTrustAll\(dq
      }
    ]
  },
  \(dqnetwork_config\(dq: {},
  \(dqno_pkg_lookups\(dq: false,
  \(dqntp\(dq: true,
  \(dqoffline\(dq: false,
  \(dqpackages\(dq: [],
  \(dqparallel downloads\(dq: 0,
  \(dqprofile_config\(dq: null,
  \(dqsave_config\(dq: null,
  \(dqscript\(dq: \(dqguided\(dq,
  \(dqsilent\(dq: false,
  \(dqswap\(dq: true,
  \(dqtimezone\(dq: \(dqUTC\(dq,
  \(dqversion\(dq: \(dq2.6.0\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS "گزینه‌های \fB\-\-config\fP"
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
تمامی ورودی‌های کلید و مقدار باید با استاندارد JSON مطابقت داشته باشند. در ادامه، نمونه‌هایی خوانا برای انسان همراه با پیوندها آورده شده است که ساختار نحوی معتبر JSON را می‌شکنند. توضیحات زیر را متناسب با نیازهای خود و قالب استاندارد JSON تطبیق دهید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای مشاهده گزینه‌های الزامی، جدول را به سمت راست پیمایش کنید.
.UNINDENT
.UNINDENT
.SS "گزینه‌های JSON"
.TS
box center;
l|l|l|l.
T{
کلید
T}	T{
مقدار(ها)
T}	T{
توضیحات
T}	T{
الزامی
T}
_
T{
additional\-repositories
T}	T{
[ multilib \%<https://\:wiki\:.archlinux\:.org/\:title/\:Official_repositories#\:multilib>, testing \%<https://\:wiki\:.archlinux\:.org/\:title/\:Official_repositories#\:Testing_repositories> ]
T}	T{
فعال‌سازی یک یا چند مورد از مخازن testing و multilib پیش از ادامه فرآیند نصب
T}	T{
خیر
T}
_
T{
archinstall\-language
T}	T{
lang \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:locales/\:languages\:.json>
T}	T{
زبان مورد استفاده در رابط کاربری متنی (TUI) را تنظیم می‌کند \fI(اطمینان حاصل کنید که از مقدار \(ga\(galang\(ga\(ga استفاده کنید نه \(ga\(gaabbr\(ga\(ga)\fP
T}	T{
خیر
T}
_
T{
audio_config
T}	T{
pipewire \%<https://\:wiki\:.archlinux\:.org/\:title/\:PipeWire>, pulseaudio \%<https://\:wiki\:.archlinux\:.org/\:title/\:PulseAudio>
T}	T{
سرور صوتی که باید نصب شود
T}	T{
خیر
T}
_
T{
bootloader_config
T}	T{
{ bootloader: Systemd\-boot \%<https://\:wiki\:.archlinux\:.org/\:title/\:Systemd-boot>, grub \%<https://\:wiki\:.archlinux\:.org/\:title/\:GRUB>, limine \%<https://\:wiki\:.archlinux\:.org/\:title/\:Limine>, uki: \fBtrue\fP/\fBfalse\fP, removable: \fBtrue\fP/\fBfalse\fP }
T}	T{
پیکربندی لودر بوت (بوت‌لودر). گزینه \fBbootloader\fP مشخص می‌کند کدام بوت‌لودر نصب شود \fI(استفاده از grub/limine در حالت BIOS اجباری است)\fP\&. گزینه \fBuki\fP تصاویر یکپارچه هسته (unified kernel images) را فعال می‌کند \fI(فقط UEFI، فقط systemd\-boot/limine)\fP\&. گزینه \fBremovable\fP به جای NVRAM، در مسیر پیش‌فرض رسانه‌های جداشدنی /EFI/BOOT/ نصب را انجام می‌دهد \fI(فقط UEFI، فقط grub/limine)\fP
T}	T{
بله
T}
_
T{
debug
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
فعال‌سازی خروجی اشکال‌زدایی (دیباگ)
T}	T{
خیر
T}
_
T{
disk_config
T}	T{
\fIاطلاعات بیشتر در بخش\fP پیکربندی دیسک \%<#\:disk-config>
T}	T{
شامل پیکربندی دیسک مورد نظر برای استفاده در طول نصب است
T}	T{
خیر
T}
_
T{
disk_encryption
T}	T{
\fIاطلاعات بیشتر در بخش\fP رمزنگاری دیسک \%<#\:disk-encryption>
T}	T{
پارامترهای رمزنگاری دیسک که علاوه بر \fBdisk_config\fP اعمال می‌شوند
T}	T{
خیر
T}
_
T{
hostname
T}	T{
\fBstr\fP
T}	T{
رشته‌ای که نام میزبان (hostname) دستگاه شما را در شبکه تعیین می‌کند \fI(پیش‌فرض \(ga\(gaarchinstall\(ga\(ga است)\fP
T}	T{
خیر
T}
_
T{
kernels
T}	T{
[ linux \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels>, linux\-hardened \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels>, linux\-lts \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels>, linux\-rt \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels>, linux\-rt\-lts \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels>, linux\-zen \%<https://\:wiki\:.archlinux\:.org/\:title/\:Kernel#\:Officially_supported_kernels> ]
T}	T{
تعیین می‌کند کدام هسته‌ها باید نصب شده و در گزینه‌های بوت‌لودر پیکربندی شوند
T}	T{
بله
T}
_
T{
custom_commands
T}	T{
\fIاطلاعات بیشتر در بخش\fP دستورات سفارشی \%<#\:custom-commands>
T}	T{
دستورات سفارشی که پس از نصب به‌صورت chroot در داخل سیستم نصب‌شده اجرا خواهند شد
T}	T{
خیر
T}
_
T{
locale_config
T}	T{
{kb_layout: lang \%<https://\:wiki\:.archlinux\:.org/\:title/\:Linux_console/\:Keyboard_configuration>, sys_enc: Character encoding \%<https://\:wiki\:.archlinux\:.org/\:title/\:Locale>, sys_lang: locale \%<https://\:wiki\:.archlinux\:.org/\:title/\:Locale>}
T}	T{
چیدمان کلیدهای صفحه‌کلید، کدگذاری سیستم و لوکال سیستم را مشخص می‌کند
T}	T{
خیر
T}
_
T{
mirror_config
T}	T{
{custom_mirrors: [ \%<https://>\&... ], mirror_regions: { \(dqWorldwide\(dq: [ \(dq\%<https://\:geo\:.mirror\:.pkgbuild\:.com/\:$repo/\:os/\:$arch>\(dq ] } }
T}	T{
مخازن آینه‌ای (میرورها) گوناگون را تنظیم می‌کند \fI(در صورت عدم تعیین، به صورت پیش‌فرض از \(ga\(ga/etc/pacman.d/mirrors\(ga\(ga در ISO استفاده می‌شود)\fP
T}	T{
خیر
T}
_
T{
network_config
T}	T{
\fI\(gaمشاهده گزینه‌ها در بخش پیکربندی شبکه\(ga\fP
T}	T{
مشخص می‌کند که چه نوع پیکربندی شبکه‌ای \fI(در صورت وجود)\fP باید استفاده شود
T}	T{
خیر
T}
_
T{
no_pkg_lookups
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
غیرفعال کردن بررسی بسته‌ها در \%<https://\:archlinux\:.org/\:packages>
T}	T{
خیر
T}
_
T{
ntp
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
پروتکل زمان شبکه NTP \%<https://\:wiki\:.archlinux\:.org/\:title/\:Network_Time_Protocol_daemon> را در طول نصب فعال یا غیرفعال می‌کند
T}	T{
خیر
T}
_
T{
offline
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
بررسی‌های آنلاین خاص مانند در دسترس بودن مخازن آینه‌ای و غیره را فعال یا غیرفعال می‌کند
T}	T{
خیر
T}
_
T{
packages
T}	T{
[ <package1>, <package2>, ... ]
T}	T{
فهرستی از بسته‌ها برای نصب در طول فرآیند نصب
T}	T{
خیر
T}
_
T{
parallel downloads
T}	T{
0\-∞
T}	T{
تعداد دانلودهای موازی مورد استفاده توسط pacman \%<https://\:wiki\:.archlinux\:.org/\:title/\:Pacman#\:Enabling_parallel_downloads> را تعیین می‌کند
T}	T{
خیر
T}
_
T{
profile_config
T}	T{
\fI\(gaاطلاعات بیشتر در بخش پروفایل‌ها\(ga\fP
T}	T{
در صورت تعریف، پروفایل مشخص‌شده را نصب می‌کند
T}	T{
خیر
T}
_
T{
script
T}	T{
guided \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:scripts/\:guided\:.py> \fI(پیش‌فرض)\fP, minimal \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:scripts/\:minimal\:.py>, only_hdd \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:master/\:archinstall/\:scripts/\:only_hdd\:.py>
T}	T{
هنگامی که برای اجرای خودکار نصب استفاده می‌شود، مشخص می‌کند که با کدام اسکریپت اجرای خودکار انجام شود
T}	T{
خیر
T}
_
T{
silent
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
پرسش‌های کاربری با استفاده از رابط متنی (TUI) را غیرفعال یا فعال می‌کند
T}	T{
خیر
T}
_
T{
swap
T}	T{
\fBtrue\fP, \fBfalse\fP
T}	T{
فضای تعویض (swap) را فعال یا غیرفعال می‌کند
T}	T{
خیر
T}
_
T{
timezone
T}	T{
timezone \%<https://\:wiki\:.archlinux\:.org/\:title/\:System_time#\:Time_zone>
T}	T{
منطقه زمانی را برای سیستم نصب‌شده تنظیم می‌کند
T}	T{
خیر
T}
.TE
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر هیچ ورودی در \fBdisk_config\fP یافت نشود، نصب هدایت‌شده archinstall بدون انجام هیچ‌گونه عملیات روی دیسک، از هر آنچه که در حال حاضر زیر مسیر \fB/mnt/archinstall\fP سوار (mount) شده است استفاده خواهد کرد.
.UNINDENT
.UNINDENT
.SS "گزینه‌های مربوط به \fB\-\-creds\fP"
.sp
فایل creds یک فایل پیکربندی جداگانه است تا گزینه‌های عادی را از داده‌های حساس‌تر مانند گذرواژه‌ها تفکیک کند.
در زیر نمونه‌ای از نحوه تنظیم گذرواژه ریشه آورده شده و در ادامه، توضیحات سایر مقادیر قابل تنظیم آمده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqroot_enc_password\(dq : \(dqSecretSanta2022\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS "گزینه‌های \fB\-\-creds\fP"
.TS
box center;
l|l|l|l.
T{
کلید
T}	T{
مقادیر
T}	T{
توضیحات
T}	T{
الزامی
T}
_
T{
\fB!encryption\-password\fP
T}	T{
\fBstr\fP
T}	T{
گذرواژه برای رمزنگاری دیسک؛ اگر گذرواژه ارائه نشود دیسک رمزنگاری نخواهد شد
T}	T{
خیر
T}
_
T{
\fBroot_enc_password\fP
T}	T{
\fBstr\fP
T}	T{
گذرواژه حساب کاربری ریشه (root)
T}	T{
خیر
T}
_
T{
\fBusers\fP
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqusername\(dq: \(dq<USERNAME>\(dq,
    \(dqenc_password\(dq: \(dq<PASSWORD_HASH>\(dq,
    \(dqsudo\(dq: false
}
.EE
.UNINDENT
.UNINDENT
T}	T{
فهرست اطلاعات اعتباری کاربران عادی؛ برای راهنمایی به بخش پیکربندی مراجعه کنید
T}	T{
مشروط
T}
.TE
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم \fBusers\fP تنها در صورتی اختیاری است که \fBroot_enc_password\fP تعیین شده باشد. در غیر این صورت، تنظیم \fBusers\fP اجباری خواهد بود و حداقل تعداد کاربران مورد نیاز با امتیازات sudo روی ۱ تنظیم می‌شود.
.UNINDENT
.UNINDENT
.SH "مسائل و مشکلات شناخته‌شده (KNOWN ISSUES)"
.sp
برخی مسائل خارج از حوزه پروژه archinstall \%<https://\:github\:.com/\:archlinux/\:archinstall> هستند و مواردی که ما از آن‌ها مطلع هستیم در زیر فهرست شده‌اند.
.SS انتظار برای همگام‌سازی زمان (Waiting for time sync) #2144 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:2144>
.sp
علت ریشه‌ای معمول این مشکل، توپولوژی شبکه است.
به‌طور خاص، \fBtimedatectl show\fP \%<https://\:github\:.com/\:archlinux/\:archinstall/\:blob/\:e6344f93f7e476d05bbcd642f2ed91fdde545870/\:archinstall/\:lib/\:installer\:.py#\:L136> نمی‌تواند یک همگام‌سازی صحیح زمان را در برابر سرورهای پیش‌فرض انجام دهد.
.sp
راه‌اندازی مجدد \fBsystemd\-timesyncd.service\fP ممکن است کارساز باشد، اما در بیشتر مواقع لازم است فایل \fB/etc/systemd/timesyncd.conf\fP را متناسب با ساختار شبکه خود پیکربندی کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر می‌دانید زمان روی دستگاه شما دقیق است، می‌توانید دستور \fBarchinstall \-\-skip\-ntp\fP را برای نادیده گرفتن همگام‌سازی زمان اجرا کنید.
.UNINDENT
.UNINDENT
.SS انتظار برای اتمام همگام‌سازی جاکلیدی آرچ لینوکس (archlinux\-keyring\-wkd\-sync) #2679 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:2679>
.sp
سرویس \fBarchlinux\-keyring\-wkd\-sync.service\fP یا تایمر \fBarchlinux\-keyring\-wkd\-sync.timer\fP ممکن است گاهی اوقات \(dqبرای همیشه\(dq معلق بماند (هنگ کند).
این وضعیت معمولاً به دلیل عدم امکان دسترسی به سرورهای کلید یا کندی اتصال به آن‌ها رخ می‌دهد.
.sp
اسکریپت \fB/usr/bin/archlinux\-keyring\-wkd\-sync\fP را می‌توان به صورت دستی اجرا کرد تا مشخص شود آیا به کندی اجرا می‌شود یا خیر.
.sp
اگر دستور \fBsystemctl show \-\-property=ActiveEnterTimestamp \-\-no\-pager archlinux\-keyring\-wkd\-sync.timer\fP چیزی نشان ندهد، به این معنی است که همگام‌سازی داخلی هرگز به پایان نرسیده است. به همین ترتیب، دستور \fBsystemctl show \-\-no\-pager \-p SubState \-\-value archlinux\-keyring\-wkd\-sync.service\fP به احتمال زیاد مقدار \fBdead\fP را نشان می‌دهد که یعنی سرویس هرگز تکمیل نشده است.
.sp
برای رفع این مشکل، موارد زیر را امتحان کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# killall gpg\-agent
# rm \-rf /etc/pacman.d/gnupg
# pacman\-key \-\-init
# pacman\-key \-\-populate
# pacman \-Sy archlinux\-keyring
# systemctl restart archlinux\-keyring\-wkd\-sync.timer
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر مطمئن هستید که ISO آخرین نسخه است و کلیدهای معتبر GPG دارید، دستور \fBarchinstall \-\-skip\-wkd\fP را برای صرف‌نظر از انتظار جهت همگام‌سازی امتحان کنید.
.sp
اگر از همگام‌سازی WKD صرف‌نظر کنید، ممکن است با خطای زیر مواجه شوید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> error: archinstall: signature from \(dqAnton Hvornum (Torxed) <torxed@archlinux.org>\(dq is unknown trust
> :: File /var/cache/pacman/pkg/archinstall\-1.2.3\-4\-x86_64.pkg.tar.xz is corrupted (invalid or corrupted package (PGP signature)).
> Do you want to delete it? [Y/n]
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS نبود درایور اختصاصی انویدیا (Missing Nvidia Proprietary Driver) #2002 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:2002>
.sp
در برخی موارد، ممکن است درایور nvidia تمام بسته‌های لازم را به صورت نصب‌شده نداشته باشد.
این موضوع به دلیل انتخاب هسته (کرنل) و/یا تنظیمات سخت‌افزاری است که برای عملکرد صحیح نیاز به بسته‌های اضافی دارند.
.sp
یک راهکار معمول، نصب بسته linux\-headers \%<https://\:archlinux\:.org/\:packages/\:core/\:x86_64/\:linux-headers> و nvidia\-dkms \%<https://\:archlinux\:.org/\:packages/\:extra/\:x86_64/\:nvidia-dkms> است.
.SS خطای پردازنده‌های ARM، ۳۲ بیتی و سایر انواع پردازنده #1686 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:1686>، #2185 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:2185>
.sp
این یک مسئله شناخته‌شده تا حدی فراگیر و کلی است.
به‌طور رسمی تنها معماری x86_64 \%<https://\:wiki\:.archlinux\:.org/\:title/\:Frequently_asked_questions#\:What_architectures_does_Arch_support?> توسط آرچ لینوکس پشتیبانی می‌شود.
از این رو، تلاش چندانی برای پشتیبانی از سایر پلتفرم‌ها صورت نگرفته است.
.sp
از نظر تئوری، سایر معماری‌ها باید کار کنند اما ممکن است اشکالات و رفتارهای پیش‌بینی‌نشده‌ای رخ دهند.
.sp
درخواست‌های ادغام (PR) مورد استقبال قرار می‌گیرند، اما لطفاً تأخیر در ادغام آن‌ها را پذیرا باشید.
سایر اصلاحات، مسائل یا ویژگی‌ها به دلایل فوق در اولویت قرار خواهند گرفت.
.SS قدیمی بودن جاکلیدی (Keyring is out of date) #2213 \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues/\:2213>
.sp
مشکلات مربوط به کلیدهای مفقود معمولاً به دلیل قدیمی بودن بسته archlinux\-keyring \%<https://\:archlinux\:.org/\:packages/\:core/\:any/\:archlinux-keyring> است که اغلب در نتیجه یک ISO قدیمی رخ می‌دهد.
تلاشی از سوی پروژه بالادست برای رفع این مشکل صورت گرفته است که همان سرویس archlinux\-keyring\-wkd\-sync.service \%<https://\:gitlab\:.archlinux\:.org/\:archlinux/\:archlinux-keyring/\:-/\:blob/\:7e672dad10652a80d1cc575d75cdb46442cd7f96/\:wkd_sync/\:archlinux-keyring-wkd-sync\:.service\:.in> می‌باشد.
.sp
این سرویس تقریباً بلافاصله در حین بوت شروع به کار می‌کند و اگر شبکه به موقع پیکربندی نشود — سرویس با شکست مواجه می‌شود.
متعاقباً، با وجود فعال بودن سرویس به‌روزرسانی برای این کار، ممکن است اجرای \fBarchinstall\fP با یک جاکلیدی قدیمی انجام شود.
.sp
در عمل هیچ راه پایدار و قابل اعتمادی در طول زمان برای رفع این مشکل در درون \fBarchinstall\fP وجود ندارد.
در عوض، تلاش‌ها برای بهبود سرویس بالادست و/یا عدم انقضای کلیدها در تعداد معقولی از نسخه‌های ISO باید به عنوان راهکار اصلی مد نظر قرار گیرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این مشکل حتی در ISOهای جدید نیز می‌تواند رخ دهد، حتی چند روز پس از انتشار؛ چرا که برخی کلیدها ممکن است بلافاصله پس از آنکه جاکلیدی روی تصویر ISO \fI\(dqتثبیت شد\(dq\fP منقضی شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مسئله رایج دیگری که به عدم پیکربندی شبکه مربوط می‌شود این است که ممکن است زمان سیستم به درستی تنظیم نشده باشد \- در نتیجه جاکلیدی قادر به به‌روزرسانی نخواهد بود. به بخش انتظار برای همگام‌سازی زمان #2144 مراجعه کنید.
.UNINDENT
.UNINDENT
.SS بسته‌های مخزن کاربری آرچ (AUR packages)
.sp
این نیز یک موضوع کلی و فراگیر است.
مخزن AUR پشتیبانی نمی‌شود \%<https://\:wiki\:.archlinux\:.org/\:title/\:Arch_User_Repository#\:Updating_packages> و تا زمانی که این وضعیت تغییر نکند، نمی‌توانیم از بسته‌های AUR برای حل درخواست‌های قابلیت در \fBarchinstall\fP استفاده کنیم.
.sp
این بدان معناست که امکان افزودن درخواست‌های قابلیتی مانند پشتیبانی از سیستم‌های پرونده نظیر ZFS \%<https://\:aur\:.archlinux\:.org/\:packages/\:zfs-linux> وجود ندارد و مشکلات نیز با استفاده از بسته‌های AUR قابل حل نیستند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اما در جهت ارائه حق انتخاب به جامعه کاربری، \fBarchinstall\fP از پلاگین‌های پایتون پشتیبانی می‌کند \%<#\:archinstall-plugins>، به این معنی که می‌توانید \fBarchinstall \-\-plugin <url>\fP را اجرا کرده و از یک پلاگین AUR بهره ببرید.
.sp
پروژه torxed/archinstall\-aur \%<https://\:github\:.com/\:torxed/\:archinstall-aur> یک پیاده‌سازی مرجع برای پلاگین‌ها است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://archlinux.life/aur\-plugin
.EE
.UNINDENT
.UNINDENT
.sp
پروژه phisch/archinstall\-aur \%<https://\:github\:.com/\:phisch/\:archinstall-aur> یک جایگزین دیگر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# archinstall \-\-plugin https://raw.githubusercontent.com/phisch/archinstall\-aur/master/archinstall\-aur.py
.EE
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این کار استفاده پشتیبانی‌نشده از AUR را در طول فرایند نصب ممکن می‌سازد.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "گزارش مشکلات و باگ‌ها (REPORT ISSUES & BUGS)"
.sp
مشکلات و باگ‌ها باید در نشانی \%<https://\:github\:.com/\:archlinux/\:archinstall/\:issues> گزارش شوند.
.sp
سوالات عمومی، پیشنهادات بهبود و مسائل امنیتی را نیز می‌توان در آنجا گزارش کرد.
برای مشکلات فوری یا در صورت نیاز به راهنمایی، به سرور دیسکورد که دارای کانال راهنمایی است مراجعه کنید.
.SS فایل‌های گزارش (Log files)
.sp
هنگام ارسال تیکت راهنمایی، لطفاً فایل \fB/var/log/archinstall/install.log\fP را ضمیمه کنید.
این فایل هم در محیط زنده (Live ISO) و هم در سیستم پرونده نصب‌شده (در صورتی که بسته‌های پایه نصب شده باشند) قابل دسترسی است.
.sp
\fBنکته کاربردی:\fP
.INDENT 0.0
.INDENT 3.5
.nf
یک روش آسان برای ارسال گزارش‌ها استفاده از دستور \fBarchinstall share\-log\fP است که فایل \fBinstall.log\fP را در paste.rs آپلود کرده و یک پیوند قابل اشتراک‌گذاری چاپ می‌کند.
هنگام ارسال سایر فایل‌های گزارش احتیاط کنید، اما \fBarchinstall\fP تضمین می‌کند که \fBinstall.log\fP برای انتشار عمومی ایمن باشد!
.fi
.sp
.UNINDENT
.UNINDENT
.sp
فایل‌های گزارش دیگری در مسیر \fB/var/log/archinstall/\fP وجود دارند که می‌توانند مفید باشند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB/var/log/archinstall/user_configuration.json\fP \- اکثر پاسخ‌های راهنمایی‌شده در نصاب را ذخیره می‌کند
.IP \(bu 2
\fB/var/log/archinstall/user_credentials.json\fP \- هرگونه نام کاربری یا گذرواژه را ذخیره می‌کند و می‌تواند به \fB\-\-creds\fP ارسال شود
.IP \(bu 2
\fB/var/log/archinstall/user_disk_layouts.json\fP \- دیسک‌های انتخاب‌شده و چیدمان آن‌ها را ذخیره می‌کند
.IP \(bu 2
\fB/var/log/archinstall/install.log\fP \- فایل گزارش از مراحلی که توسط archinstall پیموده شده است
.IP \(bu 2
\fB/var/log/archinstall/cmd_history.txt\fP \- تاریخچه کامل دستورات اجراشده به ترتیب
.IP \(bu 2
\fB/var/log/archinstall/cmd_output.txt\fP \- خروجی خام تمام دستوراتی که توسط archinstall اجرا شده‌اند
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
ما فقط تضمین می‌کنیم که \fB/var/log/archinstall/install.log\fP فاقد اطلاعات حساس است.
هر فایل گزارش دیگری باید با \fBنهایت احتیاط\fP ارسال شود!
.UNINDENT
.UNINDENT
.SH "دیسکورد (DISCORD)"
.sp
یک کانال دیسکورد وجود دارد که برخی از مشارکت‌کنندگان در آن حضور دارند \%<https://\:github\:.com/\:archlinux/\:archinstall/\:graphs/\:contributors>\&.
.sp
برای پیوستن به سرور، به پیوند \%<https://\:discord\:.gg/\:aDeMffrxNg> بروید و ملحق شوید.
قوانین چندانی به جز عقل سلیم و احترام به دیگران وجود ندارد. بخش گفتگوی عمومی برای مباحث متفرقه (off\-topic) نیز در دسترس است.
.sp
نقش \fB@Party Animals\fP در صورتی که مایل به دریافت اعلان‌های انتشار نسخه‌های جدید هستید در دسترس است که در کانال \fB#Release Party\fP ارسال می‌شود.
همچنین نقش \fB@Contributors\fP می‌تواند توسط مشارکت‌کنندگان با نوشتن \fB!verify\fP و دنبال کردن مراحل تأیید هویت فعال شود.
.sp
ملحق شوید، امیدواریم شما را آنجا ببینیم! : )
.SH "کتابخانه پایتون (PYTHON LIBRARY)"
.sp
کتابخانه archinstall در PyPi
\%<https://\:pypi\:.org>
با نام بسته archinstall
\%<https://\:pypi\:.org/\:project/\:archinstall>
عرضه می‌شود.
اما این کتابخانه را می‌توان به صورت دستی نیز نصب کرد.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
اگر قصد دارید از archinstall بر روی ایمیج رسمی ISO آرچ لینوکس استفاده کنید، نیازی به انجام این مراحل نیست.
.UNINDENT
.UNINDENT
.SS "نصب با pacman (Installing with pacman)"
.sp
بسته Archinstall در مخازن رسمی
\%<https://\:wiki\:.archlinux\:.org/\:index\:.php/\:Official_repositories>
موجود است.
و همچنین archinstall را به عنوان یک کتابخانه پایتون نصب خواهد کرد.
.sp
برای نصب هم‌زمان کتابخانه و اسکریپت archinstall:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pacman \-S archinstall
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توانید با استفاده از بسته
\fBpython\-archinstall\fP
تنها کتابخانه را بدون فایل اجرایی کمکی نصب کنید.
.SS "نصب از PyPI (Installing from PyPI)"
.sp
مفهوم پایه PyPI با استفاده از
\fIpip\fP
اعمال می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install archinstall
.EE
.UNINDENT
.UNINDENT
.SS "نصب با استفاده از کد منبع (Install using source code)"
.sp
همچنین می‌توانید برنامه را با استفاده از کد منبع نصب کنید.
برای سادگی در این مثال از
\fBgit clone\fP
استفاده می‌کنیم.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/archlinux/archinstall
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید پوشه را به درون پروژه خود منتقل کرده و به سادگی دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import archinstall
.EE
.UNINDENT
.UNINDENT
.sp
یا می‌توانید از ابزارهای build
\%<https://\:github\:.com/\:pypa/\:build>
و installer
\%<https://\:github\:.com/\:pypa/\:installer>
مربوط به PyPA برای نصب آن در مسیر ماژول‌های پایتون استفاده کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cd archinstall
$ python \-m build .
$ python \-m installer dist/*.whl
.EE
.UNINDENT
.UNINDENT
.SH "ماژول پایتون (PYTHON MODULE)"
.sp
برنامه archinstall از اجرا در حالت ماژول
\%<https://\:docs\:.python\:.org/\:3/\:library/\:__main__\:.html>
پشتیبانی می‌کند.
روش فراخوانی کتابخانه در حالت ماژول به اجرای اسکریپت‌های موجود در پوشه scripts
\%<https://\:github\:.com/\:archlinux/\:archinstall/\:tree/\:master/\:archinstall/\:scripts>
محدود است.
.sp
بنابراین مهم است که پیش از ساخت و نصب، هر اسکریپت یا نمایه‌ای را که مایل به فراخوانی آن هستید در پوشه examples قرار دهید.
.SS "پیش‌نیازها (Pre\-requisites)"
.sp
فرض می‌کنیم که روش «نصب با استفاده از کد منبع»
\%<#\:installing-python-manual>
را دنبال کرده‌اید.
پیش از نصب واقعی کتابخانه، لازم است اسکریپت‌های نصب سفارشی خود را به صورت یک فایل پایتون در پوشه scripts
\%<https://\:github\:.com/\:archlinux/\:archinstall/\:tree/\:master/\:archinstall/\:scripts>
قرار دهید.
.sp
توضیحات بیشتر در مورد نحوه ساخت این اسکریپت‌ها در بخش بعدی آمده است.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این مورد ممکن است در آینده تغییر کند چرا که این روش در حال حاضر کمی انعطاف‌ناپذیر است. مسیر اسکریپت به یک پارامتر تبدیل خواهد شد. اما در حال حاضر، این ساختار بر اساس طراحی فعلی است.
.UNINDENT
.UNINDENT
.SS "ایجاد یک اسکریپت (Creating a script)"
.sp
بیایید به عنوان مثال یک نصاب
\fItest_installer\fP
ایجاد کنیم. با این فرض که پوشه
\fI\&./archinstall\fP
یک کلون گیت از مخزن اصلی است.
کار را با ایجاد
\(dqscripts \%<https://\:github\:.com/\:archlinux/\:archinstall/\:tree/\:master/\:archinstall/\:scripts>\fB/test_installer.py\fP\(dq
آغاز می‌کنیم. جای‌گذاری این فایل بعداً حائز اهمیت خواهد بود.
.sp
این اسکریپت اکنون پس از نصب موفقیت‌آمیز خود کتابخانه، می‌تواند با استفاده از
\fBpython \-m archinstall \-\-script test_installer\fP
فراخوانی شود.
اما این اسکریپت کار زیادی انجام نخواهد داد. بنابراین به عنوان نمونه کار ساده‌ای مانند فهرست کردن تمام دیسک‌های سخت را انجام می‌دهیم.
.sp
برای این کار، با وارد کردن
\fBarchinstall\fP
در
\(dqscripts \%<https://\:github\:.com/\:archlinux/\:archinstall/\:tree/\:master/\:archinstall/\:scripts>\fB/test_installer.py\fP\(dq
شروع کرده و تابعی را درون
\fBarchinstall\fP
فراخوانی می‌کنیم.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from archinstall.lib.disk.device_handler import device_handler
from pprint import pprint

pprint(device_handler.devices)
.EE
.UNINDENT
.UNINDENT
.sp
اکنون به روش «نصب با استفاده از کد منبع»
\%<#\:installing-python-manual>
مراجعه فرمایید.
پس از اجرای
\fBpython \-m archinstall test_installer\fP
باید خروجی‌ای مشابه زیر چاپ شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[
    BDevice(
        disk=<parted.disk.Disk object at 0x7fbe17156050>,
        device_info=_DeviceInfo(
            model=\(aqPC801 NVMe SK hynix 512GB\(aq,
            path=PosixPath(\(aq/dev/nvme0n1\(aq),
            type=\(aqnvme\(aq,
            total_size=Size(value=512110190592, unit=<Unit.B: 1>,
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
            free_space_regions=[
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4250>,
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4c50>,
                <archinstall.lib.disk.device.DeviceGeometry object at 0x7fbe166c4a10>],
            sector_size=SectorSize(value=512, unit=<Unit.B: 1>),
            read_only=False,
            dirty=False
        ),
        partition_infos=[
            _PartitionInfo(
                partition=<parted.partition.Partition object at 0x7fbe166c4a90>,
                name=\(aqprimary\(aq,
                type=<PartitionType.PRIMARY: \(aqprimary\(aq>,
                fs_type=<FilesystemType.FAT32: \(aqfat32\(aq>,
                path=\(aq/dev/nvme0n1p1\(aq,
                start=Size(value=2048, unit=<Unit.sectors: \(aqsectors\(aq>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                length=Size(value=535822336, unit=<Unit.B: 1>, sector_size=SectorSize(value=512, unit=<Unit.B: 1>)),
                flags=[
                    <PartitionFlag.BOOT: flag_id=1, alias=None>,
                    <PartitionFlag.ESP: flag_id=18, alias=None>
                ],
                partn=1,
                partuuid=\(aqa26be943\-c193\-41f4\-9930\-9341cf5f6b19\(aq,
                uuid=\(aq6EE9\-2C00\(aq,
                disk=<parted.disk.Disk object at 0x7fbe17156050>,
                mountpoints=[
                    PosixPath(\(aq/boot\(aq)
                ],
                btrfs_subvol_infos=[]
            ),
            _PartitionInfo(...)
        ]
    )
]
.EE
.UNINDENT
.UNINDENT
.sp
این بدان معناست که اسکریپت شما در مکان درستی قرار دارد و
\fBarchinstall\fP
مطابق انتظار عمل می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بیشتر فراخوانی‌ها، از جمله مورد بالا، نیازمند دسترسی‌های کاربر ارشد (root)
\%<https://\:en\:.wikipedia\:.org/\:wiki/\:Superuser>
هستند.
.UNINDENT
.UNINDENT
.SH "افزونههای پایتون (PYTHON PLUGINS)"
.sp
برنامه
\fBarchinstall\fP
از طریق دو روش از افزونه‌ها پشتیبانی می‌کند.
.sp
روش نخست مستقیماً از طریق پارامتر
\fB\-\-plugin\fP
هنگام اجرا به عنوان یک ابزار خط فرمان (CLI) است. این کار یک افزونه مشخص را به صورت محلی یا از راه دور از طریق یک مسیر بارگذاری می‌کند.
.sp
روش دوم از طریق سازوکار داخلی کشف افزونه در پایتون
\%<https://\:packaging\:.python\:.org/\:en/\:latest/\:specifications/\:entry-points>
با استفاده از نقاط ورود (entry points)
\%<https://\:docs\:.python\:.org/\:3/\:library/\:importlib\:.metadata\:.html#\:entry-points>
دسته‌بندی شده به عنوان
\fBarchinstall.plugin\fP
است.
.SS "پارامتر \fB\-\-plugin\fP"
.sp
این پارامتر این مزیت را دارد که در وضعیت
\fB\-\-conf\fP
ذخیره می‌شود؛ به این معنا که هنگام اجرای مجدد یک فرآیند نصب، افزونه به طور خودکار بارگذاری خواهد شد.
محدودیت آن این است که نیازمند مشخص بودن و وارد کردن یک مسیر اولیه است که می‌تواند کمی دشوار باشد.
.SS "شناسایی افزونه (Plugin Discovery)"
.sp
این روش امکان بارگذاری چندین افزونه را فراهم می‌کند، با این محدودیت که افزونه‌ها باید از قبل بر روی سیستمی که
\fBarchinstall\fP
را اجرا می‌کند نصب شده باشند.
این روش عمدتاً کسانی را هدف قرار می‌دهد که ایمیج‌های ISO اختصاصی خود را می‌سازند و پیکربندی‌های خاصی را برای نیازهای خود بسته‌بندی می‌کنند.
.SS "چه مواردی پشتیبانی می‌شوند؟ (What\(aqs supported?)"
.sp
در حال حاضر مستندات مربوط به این بخش محدود است. تا زمانی که این موضوع برطرف شود، بهترین راه برای یافتن ویژگی‌های پشتیبانی‌شده جستجوی عبارات
plugin.on_
در کد منبع
\%<https://\:github\:.com/\:search?\:q=repo%3Aarchlinux%2Farchinstall+%22plugin\:.on_%22&\:type=code>
است؛ چرا که این کار تصویر روشنی از فراخوانی‌های انجام‌شده به افزونه‌ها ارائه می‌دهد.
.SS "چگونه کار می‌کند؟ (How does it work?)"
.sp
افزونه‌های
\fBarchinstall\fP
از رویکرد مبتنی بر کشف (discovery-driven) استفاده می‌کنند که در آن توابع خاصی از افزونه‌ها استعلام می‌شوند.
به عنوان مثال، اگر یک افزونه تابع زیر را داشته باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def on_pacstrap(*packages):
    ...
.EE
.UNINDENT
.UNINDENT
.sp
تابع
\fBarchinstall.Pacman().strap([\(dqsome packages\(dq])\fP
به صورت ثابت روی افزونه‌ها پیمایش کرده و به دنبال
\fBon_pacstrap\fP
در افزونه می‌گردد.
اگر تابع موجود باشد،
\fB\&.strap()\fP
تابع افزونه را فراخوانی کرده و لیست اولیه بسته‌ها را با نتیجه دریافتی از افزونه جایگزین می‌کند.
.sp
بهترین شیوه برای مستندسازی این فراخوانی‌ها در حال حاضر مشخص نیست، زیرا مستندسازی پویای این رفتار دشوار است.
.SS "نوشتن افزونه خودتان؟ (Writing your own?)"
.sp
ساده‌ترین راه در حال حاضر بررسی پیاده‌سازی‌های مرجع یا نمونه‌های جامعه کاربری است. دو مورد از آن‌ها عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
torxed/archinstall\-aur \%<https://\:github\:.com/\:torxed/\:archinstall-aur>
.IP \(bu 2
phisch/archinstall\-aur \%<https://\:github\:.com/\:phisch/\:archinstall-aur>
.UNINDENT
.sp
همچنین می‌توانید به جستجوی plugin.on_ در مخزن کد
\%<https://\:github\:.com/\:search?\:q=repo%3Aarchlinux%2Farchinstall+%22plugin\:.on_%22&\:type=code>
بپردازید تا ببینید
\fBarchinstall\fP
به دنبال چه چیزهایی می‌گردد. از درخواست‌های ادغام (PR) برای گسترش این پشتیبانی استقبال می‌شود.
.SH "نصاب ARCHINSTALL (ARCHINSTALL.INSTALLER)"
.sp
نصاب (installer) کلاس اصلی برای دسترسی به یک نمونه از فرآیند نصب (installation-instance) است.
می‌توانید به این کلاس به عنوان فرآیند نصبی که انجام داده‌اید یا انجام خواهید داد نگاه کنید.
.sp
هر آنچه مربوط به \fBدرون\fP فرآیند نصب باشد، در این کلاس یافت می‌شود.
.SH "نویسنده (Author)"
Anton Hvornum
.SH "کپیرایت (Copyright)"
2022, Anton Hvornum
.\" End of generated man page.