| apk(8) | System Manager's Manual | apk(8) |
نام (NAME)
apk - ابزار مدیریت بستههای آلپاین (Alpine Package Keeper)
خلاصه دستور (SYNOPSIS)
apk [<گزینههای سراسری>...] دستور [<گزینهها>...] [<آرگومانها>...]
توضیحات (DESCRIPTION)
دستور apk بستههای نصبشده روی سیستم را مدیریت میکند. مجموعه محدودیتهای سطح بالا روی بستههای سیستم، world نامیده میشود (نگاه کنید به apk-world(5)).
دستور apk از زیردستورهای متعددی برای پرسوجو و مدیریت world و مخازن بستهها پشتیبانی میکند.
تمام دستورات apk که پایگاه داده را تغییر میدهند، در /var/log/apk.log ثبت میشوند.
بهطور پیشفرض apk به صورت غیرتعاملی اجرا میشود. برای تغییر این رفتار پیشفرض به حالت تعاملی، به بخش فایلها (FILES) یا گزینه --interactive مراجعه کنید.
تنها گزینههای سراسری باید پیش از دستور مشخص شوند. جهت سازگاری با نسخههای پیشین، تلاشی برای پردازش گزینههای اختصاصی هر اپلت پیش از دستور صورت میگیرد، اما این قابلیت منسوخ شده و در آینده حذف خواهد شد.
دستورات (COMMANDS)
هر دستور با جزئیات کامل در صفحه راهنمای اختصاصی خود مستند شده است.
نصب و حذف بسته (PACKAGE INSTALLATION AND REMOVAL)
| apk-add(8) | افزودن یا تغییر محدودیتها در world و اعمال تغییرات |
| apk-del(8) | حذف محدودیتها از world و اعمال تغییرات |
نگهداری سیستم (SYSTEM MAINTENANCE)
| apk-fix(8) | تعمیر، نصب مجدد یا ارتقای بستهها بدون تغییر world |
| apk-update(8) | بهروزرسانی نمایههای مخزن |
| apk-upgrade(8) | نصب ارتقاهای موجود از مخازن |
| apk-cache(8) | مدیریت حافظه موقت (کَش) محلی بستهها |
پرسوجوی اطلاعات بسته (QUERYING PACKAGE INFORMATION)
| apk-query(8) | پرسوجوی اطلاعات درباره بستهها بر اساس معیارهای گوناگون |
| apk-list(8) | فهرست کردن بستههای منطبق با یک الگو یا معیارهای دیگر |
| apk-dot(8) | ترسیم وابستگیها بهصورت گرافهای graphviz |
| apk-policy(8) | نمایش خطمشی مخزن برای بستهها |
| apk-search(8) | جستجوی بستهها بر اساس نام یا توضیحات |
| apk-info(8) | ارائه اطلاعات دقیق درباره بستهها یا مخازن |
نگهداری مخزن و بسته (REPOSITORY AND PACKAGE MAINTENANCE)
| apk-mkndx(8) | ایجاد فایل نمایه مخزن (نسخه ۳) از بستهها |
| apk-mkpkg(8) | ایجاد بسته (نسخه ۳) |
| apk-index(8) | ایجاد فایل نمایه مخزن (نسخه ۲) از بستهها |
| apk-fetch(8) | بارگیری بستهها از مخازن به یک دایرکتوری محلی |
| apk-manifest(8) | نمایش چکسامهای محتوای بسته |
| apk-extract(8) | استخراج محتویات فایل بسته |
| apk-verify(8) | تایید یکپارچگی و امضای بسته |
| apk-adbsign(8) | امضا، امضای مجدد یا فشردهسازی مجدد بستهها و نمایههای نسخه ۳ |
متفرقه (MISCELLANEOUS)
| apk-audit(8) | بازرسی سیستم برای یافتن تغییرات |
| apk-stats(8) | نمایش آمار درباره مخازن و موارد نصبشده |
| apk-version(8) | مقایسه نگارشهای بسته یا اجرای آزمونها روی رشتههای نگارش |
| apk-adbdump(8) | تخلیه فایلهای نسخه ۳ در قالب نمایش متنی |
| apk-adbgen(8) | تولید فایلهای نسخه ۳ از نمایش متنی |
| apk-convdb(8) | تبدیل پایگاه داده نصبشده نسخه ۲ به قالب نسخه ۳ |
| apk-convndx(8) | تبدیل نمایههای نسخه ۲ به قالب نسخه ۳ |
نحو گزینهها (OPTION SYNTAX)
آرگومان BOOL برای گزینهها برابر با 'yes' یا 'no' است. آرگومان AUTO برای گزینهها برابر با 'yes'، 'no' یا 'auto' است. مقدار پیشفرض برای این آرگومانها وابسته به هر گزینه است.
برای گزینههای دارای آرگومان AUTO یا BOOL، آرگومان باید با قالب --option=argument مشخص شود (به این معنی که قالب --option argument پشتیبانی نمیشود). علاوه بر این، نامهای مستعار زیر در دسترس هستند:
- --option معادل --option=yes است
- --no-option معادل --option=no است
گزینههای سراسری (GLOBAL OPTIONS)
گزینههای زیر برای تمام دستورات در دسترس هستند.
--allow-untrusted
--arch ARCH
هنگامی که همراه با --root استفاده شود، معماری نیز ذخیره خواهد شد.
--cache[=BOOL]
--cache-dir CACHEDIR
--cache-max-age AGE
--cache-packages[=BOOL]
--cache-predownload[=BOOL]
--check-certificate[=BOOL]
--force, -f
--force-binary-stdout
--force-broken-world
ابزار APK تلاش خواهد کرد محدودیتهای world را که باعث ایجاد بستههایی با وابستگیهای متداخل میشوند شناسایی کند و غیرفعال کردن محدودیتهای world را به همین ترتیب آغاز نماید تا زمانی که مجموعهای از محدودیتهای قابلحل باقی بماند. استفاده از این سوییچ در نصب روی دیسک سخت احتمالاً منجر به حذف غیرمنتظره برخی بستهها خواهد شد. در صورت عدم اطمینان، ابتدا آن را با --interactive یا --simulate استفاده کنید.
--force-missing-repositories
--force-no-chroot
--force-non-repository
--force-old-apk
--force-overwrite
--force-refresh
--help, -h
--interactive[=AUTO]
--keys-dir KEYSDIR
--legacy-info[=BOOL]
--logfile[=BOOL]
--network[=BOOL]
--preserve-env[=BOOL]
--pretty-print[=AUTO]
--preupgrade-depends DEPS
--print-arch
--progress[=AUTO]
--progress-fd FD
--purge[=BOOL]
--quiet, -q
--repositories-file REPOFILE
--repository, -X REPO
--repository-config REPOCONFIG
--root, -p ROOT
--root-tmpfs[=AUTO]
این گزینه موارد زیر را تحت تأثیر قرار میدهد:
- خواندن و ایجاد نمایه 'installed' در حافظه موقت
- پاکسازی بستهها در حافظه موقت
- بررسیهای ایمنی برای عدم نصب بستههای غیرمخزنی
--sync[=AUTO]
--timeout TIME
--update-cache, -U
--uvol-manager UVOL
--verbose, -v
--version, -V
--wait TIME
گزینههای اعمال تغییرات (COMMIT OPTIONS)
گزینههای زیر برای تمام دستوراتی که تغییرات را در پایگاه داده اعمال (commit) میکنند در دسترس هستند.
--clean-protected[=BOOL]
--commit-hooks[=BOOL]
--initramfs-diskless-boot
--overlay-from-stdin
--scripts[=BOOL]
--simulate[=BOOL], -s
گزینههای تولید (GENERATION OPTIONS)
گزینههای زیر برای تمام دستوراتی که فایلهای APKv3 را تولید میکنند در دسترس هستند.
--compression, -c ALGORITHM[:LEVEL]
- none
- deflate (سطح ۱-۹)
- zstd (سطح ۱-۲۲)
--sign-key KEYFILE
محیط (ENVIRONMENT)
APK_CONFIG
LANG
SOURCE_DATE_EPOCH
TERM
متغیرهایی برای پیکربندی libfetch داخلی (Variables to configure built-in libfetch)
FETCH_BIND_ADDRESS
NETRC
HTTP_AUTH
HTTP_REFERER
HTTP_USER_AGENT
HTTP_PROXY, http_proxy
HTTPS_PROXY, https_proxy
HTTP_PROXY_AUTH
NO_PROXY, no_proxy
SSL_CLIENT_CERT_FILE
SSL_CLIENT_KEY_FILE
SSL_NO_VERIFY_HOSTNAME
محیط برای اسکریپتهایی که APK اجرا میکند (Environment for the scripts APK executes)
بهطور معمول apk اسکریپتها را با یک محیط پاکسازیشده و حداقلی که تنها شامل PATH است اجرا میکند. همچنین برای انتقال متغیرهای محیطی بیشتر، --preserve-env را ببینید.
پیش از اجرای یک اسکریپت، apk دایرکتوری کاری را روی ROOT تنظیم کرده و مگر در صورتی که --force-no-chroot مشخص شده باشد یک chroot انجام میدهد. در هر دو حالت، باید با دایرکتوری کاری اسکریپت به عنوان ریشه سیستم رفتار شود.
متغیرهای محیطی تعریفشده توسط APK عبارتند از:
APK_PACKAGE
APK_SCRIPT
فایلها (FILES)
فایلهای پیکربندی (Configuration files)
/etc/apk/config
/lib/apk/config
یک فایل پیکربندی شامل یک گزینه طولانی در هر خط است. برای نمونه:
timeout 120
/etc/apk/interactive
فایلهای پیکربندی (نسبت به --root)
/etc/apk/arch
/etc/apk/cache
/etc/apk/commit_hooks.d/*
/lib/apk/commit_hooks.d/*
همچنین برای متغیرهای محیطی، بخش محیط (ENVIRONMENT) را ببینید.
اگر گزینه --no-scripts یا --no-commit-hooks مشخص شده باشد، این اسکریپتهای قلاب اجرا نخواهند شد.
/etc/apk/keys
/lib/apk/keys
/etc/apk/protected_paths.d/*.list
/etc/apk/repositories
/etc/apk/repositories.d/*.list
/lib/apk/repositories.d/*.list
/etc/apk/world
فایلهای پیکربندی برای libfetch داخلی (Configuration files for built-in libfetch)
/etc/apk/ca.pem
/etc/apk/crl.pem
/etc/apk/cert.key
/etc/apk/cert.pem
فایلهای سیستم (System files)
/lib/apk/db/lock
/lib/apk/db/installed
/lib/apk/db/scripts.tar
/lib/apk/db/scripts.tar.gz
/lib/apk/db/triggers
/lib/apk/db-uvol
/lib/apk/exec
/var/log/apk.log
نکات (NOTES)
این نسخه از apk قابلیت آماده کردن قهوه را نیز دارد.
| 2026-08-31 |