'\" t
.\
.\"
.TH "DISTROBOX" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-compatibility \- جدول و مستندات سازگاری توزیع‌ها و مدیران کانتینر در distrobox
.SH "سازگاری (COMPATIBILITY)"
این پروژه \f[B]نیازی به ایمیج اختصاصی ندارد\f[R].
این ابزار می‌تواند از هر ایمیج OCI موجود در docker\-hub ،quay.io یا هر رجیستری دلخواه دیگری استفاده کند.
.PP
بسیاری از ایمیج‌های ابری عمداً برای کاهش حجم سبک‌سازی شده‌اند و ممکن است شامل دستوراتی مانند \f[CR]which\f[R]، \f[CR]mount\f[R]،
\f[CR]less\f[R] یا \f[CR]vi\f[R] نباشند.
بسته‌های اضافی را می‌توان پس از ورود به کانتینر نصب کرد.
اگر نیاز دارید به طور مکرر کانتینرهای جدید بسازید، توصیه می‌کنیم از ابزار خودکارسازی دلخواه خود درون کانتینر استفاده کنید.
نگهداری ایمیج سفارشی اختصاصی خود نیز گزینه دیگری است.
.PP
موضوع اصلی، وجود ابزارهای پایه‌ای لینوکس (\f[CR]mount\f[R])،
ابزارهای پایه‌ای مدیریت کاربر (\f[CR]usermod, passwd\f[R])، و
پیکربندی صحیح \f[CR]sudo\f[R] است.
.SS "مدیران کانتینر پشتیبانی‌شده (SUPPORTED CONTAINER MANAGERS)"
\f[CR]distrobox\f[R] می‌تواند روی هر یک از ابزارهای \f[CR]podman\f[R]،
\f[CR]docker\f[R] یا \c
.UR https://github.com/89luca89/lilipod
\f[CR]lilipod\f[R]
.UE \c
اجرا شود.
.PP
این ابزار به \f[CR]podman\f[R] پیکربندی‌شده در
\f[CR]حالت بدون ریشه (rootless mode)\f[R] یا به \f[CR]docker\f[R] پیکربندی‌شده بدون sudo
وابسته است (طبق \c
.UR https://docs.docker.com/engine/install/linux-postinstall
این دستورالعمل‌ها
.UE \c
عمل کنید).
.IP \[bu] 2
حداقل نسخه podman: \f[B]2.1.0\f[R]
.IP \[bu] 2
حداقل نسخه کلاینت docker: \f[B]19.03.15\f[R]
.IP \[bu] 2
حداقل نسخه lilipod: \f[B]v0.0.1\f[R]
.PP
راهنمای رسمی نصب را در اینجا دنبال کنید:
.IP \[bu] 2
\c
.UR https://podman.io/getting-started/installation
.UE \c
.IP \[bu] 2
\c
.UR https://docs.docker.com/engine/install
.UE \c
.IP \[bu] 2
\c
.UR https://docs.docker.com/engine/install/linux-postinstall
.UE \c
.SS "توزیع‌های کانتینر (CONTAINERS DISTROS)"
مهمان‌های Distrobox با ایمیج‌های کانتینری زیر با موفقیت آزمایش شده‌اند:
.PP
.TS
tab(@);
lw(23.3n) lw(23.3n) lw(23.3n).
T{
توزیع
T}@T{
نسخه
T}@T{
ایمیج‌ها
T}
_
T{
AlmaLinux (Toolbox)
T}@T{
8  9
T}@T{
quay.io/toolbx\-images/almalinux\-toolbox:8 
quay.io/toolbx\-images/almalinux\-toolbox:9 
quay.io/toolbx\-images/almalinux\-toolbox:latest
T}
T{
Alpine (Toolbox)
T}@T{
3.20  3.21  3.22  edge
T}@T{
quay.io/toolbx\-images/alpine\-toolbox:3.20 
quay.io/toolbx\-images/alpine\-toolbox:3.21 
quay.io/toolbx\-images/alpine\-toolbox:3.22 
quay.io/toolbx\-images/alpine\-toolbox:edge 
quay.io/toolbx\-images/alpine\-toolbox:latest
T}
T{
AmazonLinux (Toolbox)
T}@T{
2  2022
T}@T{
quay.io/toolbx\-images/amazonlinux\-toolbox:2 
quay.io/toolbx\-images/amazonlinux\-toolbox:2023 
quay.io/toolbx\-images/amazonlinux\-toolbox:latest
T}
T{
Archlinux (Toolbox)
T}@T{
T}@T{
quay.io/toolbx/arch\-toolbox:latest
T}
T{
ALT Linux
T}@T{
p10  p11  sisyphus
T}@T{
docker.io/library/alt:p10  docker.io/library/alt:p11 
docker.io/library/alt:sisyphus
T}
T{
Bazzite Arch
T}@T{
T}@T{
ghcr.io/ublue\-os/bazzite\-arch:latest 
ghcr.io/ublue\-os/bazzite\-arch\-gnome:latest
T}
T{
Centos (Toolbox)
T}@T{
stream9  stream10
T}@T{
quay.io/toolbx\-images/centos\-toolbox:stream9 
quay.io/toolbx\-images/centos\-toolbox:stream10 
quay.io/toolbx\-images/centos\-toolbox:latest
T}
T{
Debian (Toolbox)
T}@T{
11  12  13  testing  unstable
T}@T{
quay.io/toolbx\-images/debian\-toolbox:11 
quay.io/toolbx\-images/debian\-toolbox:12 
quay.io/toolbx\-images/debian\-toolbox:13 
quay.io/toolbx\-images/debian\-toolbox:testing 
quay.io/toolbx\-images/debian\-toolbox:unstable 
quay.io/toolbx\-images/debian\-toolbox:latest
T}
T{
Fedora (Toolbox)
T}@T{
38  39  40  41  42  43  Rawhide
T}@T{
registry.fedoraproject.org/fedora\-toolbox:38 
registry.fedoraproject.org/fedora\-toolbox:39 
registry.fedoraproject.org/fedora\-toolbox:40 
quay.io/fedora/fedora\-toolbox:41  quay.io/fedora/fedora\-toolbox:42 
quay.io/fedora/fedora\-toolbox:43 
quay.io/fedora/fedora\-toolbox:rawhide
T}
T{
openSUSE (Toolbox)
T}@T{
T}@T{
registry.opensuse.org/opensuse/distrobox:latest
T}
T{
RedHat (Toolbox)
T}@T{
8  9
T}@T{
registry.access.redhat.com/ubi8/toolbox 
registry.access.redhat.com/ubi9/toolbox
T}
T{
Rocky Linux (Toolbox)
T}@T{
8  9
T}@T{
quay.io/toolbx\-images/rockylinux\-toolbox:8 
quay.io/toolbx\-images/rockylinux\-toolbox:9 
quay.io/toolbx\-images/rockylinux\-toolbox:latest
T}
T{
Ubuntu (Toolbox)
T}@T{
16.04  18.04  20.04  22.04  24.04
T}@T{
quay.io/toolbx/ubuntu\-toolbox:16.04 
quay.io/toolbx/ubuntu\-toolbox:18.04 
quay.io/toolbx/ubuntu\-toolbox:20.04 
quay.io/toolbx/ubuntu\-toolbox:22.04 
quay.io/toolbx/ubuntu\-toolbox:24.04 
quay.io/toolbx/ubuntu\-toolbox:latest
T}
T{
Chainguard Wolfi (Toolbox)
T}@T{
T}@T{
quay.io/toolbx\-images/wolfi\-toolbox:latest
T}
T{
Ublue
T}@T{
ubuntu\-toolbox  fedora\-toolbox  wolfi\-toolbox  archlinux\-distrobox
T}@T{
ghcr.io/ublue\-os/ubuntu\-toolbox  ghcr.io/ublue\-os/fedora\-toolbox 
ghcr.io/ublue\-os/wolfi\-toolbox  ghcr.io/ublue\-os/arch\-toolbox
T}
T{
T}@T{
T}@T{
T}
T{
AlmaLinux
T}@T{
8  8\-minimal  9  9\-minimal
T}@T{
docker.io/library/almalinux:8  docker.io/library/almalinux:9
T}
T{
Alpine Linux
T}@T{
3.20  3.21  3.22  edge
T}@T{
docker.io/library/alpine:3.20  docker.io/library/alpine:3.21 
docker.io/library/alpine:3.22  docker.io/library/alpine:edge 
docker.io/library/alpine:latest
T}
T{
AmazonLinux
T}@T{
1  2  2023
T}@T{
public.ecr.aws/amazonlinux/amazonlinux:1 
public.ecr.aws/amazonlinux/amazonlinux:2 
public.ecr.aws/amazonlinux/amazonlinux:2023
T}
T{
Archlinux
T}@T{
T}@T{
docker.io/library/archlinux:latest
T}
T{
Blackarch
T}@T{
T}@T{
docker.io/blackarchlinux/blackarch:latest
T}
T{
CentOS Stream
T}@T{
8  9  10
T}@T{
quay.io/centos/centos:stream8  quay.io/centos/centos:stream9 
quay.io/centos/centos:stream10
T}
T{
Chainguard Wolfi
T}@T{
T}@T{
cgr.dev/chainguard/wolfi\-base:latest
T}
T{
Chimera Linux
T}@T{
T}@T{
docker.io/chimeralinux/chimera:latest
T}
T{
Crystal Linux
T}@T{
T}@T{
registry.gitlab.com/crystal\-linux/misc/docker:latest
T}
T{
Debian
T}@T{
7  8  9  10  11  12  13
T}@T{
docker.io/debian/eol:wheezy  docker.io/debian/eol:buster 
docker.io/debian/eol:bullseye 
docker.io/library/debian:bookworm\-backports 
docker.io/library/debian:stable\-backports
T}
T{
Debian
T}@T{
Testing
T}@T{
docker.io/library/debian:testing 
docker.io/library/debian:testing\-backports
T}
T{
Debian
T}@T{
Unstable
T}@T{
docker.io/library/debian:unstable
T}
T{
deepin
T}@T{
20 (apricot)  23 (beige)
T}@T{
docker.io/linuxdeepin/apricot  docker.io/linuxdeepin/deepin:beige
T}
T{
Fedora
T}@T{
38  39  40  41  42  43  Rawhide
T}@T{
quay.io/fedora/fedora:38  quay.io/fedora/fedora:39 
quay.io/fedora/fedora:40  quay.io/fedora/fedora:41 
quay.io/fedora/fedora:42   quay.io/fedora/fedora:43 
quay.io/fedora/fedora:rawhide
T}
T{
Gentoo Linux
T}@T{
rolling
T}@T{
docker.io/gentoo/stage3:latest
T}
T{
KDE neon
T}@T{
Latest
T}@T{
invent\-registry.kde.org/neon/docker\-images/plasma:latest
T}
T{
Kali Linux
T}@T{
rolling
T}@T{
docker.io/kalilinux/kali\-rolling:latest
T}
T{
Mint
T}@T{
22.3
T}@T{
docker.io/linuxmintd/mint22.3\-amd64
T}
T{
Neurodebian
T}@T{
nd120
T}@T{
docker.io/library/neurodebian:nd120
T}
T{
openSUSE
T}@T{
Leap
T}@T{
registry.opensuse.org/opensuse/leap:latest
T}
T{
openSUSE
T}@T{
Tumbleweed
T}@T{
registry.opensuse.org/opensuse/distrobox:latest 
registry.opensuse.org/opensuse/tumbleweed:latest 
registry.opensuse.org/opensuse/toolbox:latest 
registry.opensuse.org/opensuse/distrobox\-bpftrace:latest
T}
T{
Oracle Linux
T}@T{
8  8\-slim  9  9\-slim  10  10\-slim
T}@T{
container\-registry.oracle.com/os/oraclelinux:8 
container\-registry.oracle.com/os/oraclelinux:8\-slim 
container\-registry.oracle.com/os/oraclelinux:9 
container\-registry.oracle.com/os/oraclelinux:9\-slim 
container\-registry.oracle.com/os/oraclelinux:10 
container\-registry.oracle.com/os/oraclelinux:10\-slim
T}
T{
RedHat (UBI)
T}@T{
7  8  9
T}@T{
registry.access.redhat.com/ubi7/ubi  registry.access.redhat.com/ubi8/ubi
\ registry.access.redhat.com/ubi8/ubi\-init 
registry.access.redhat.com/ubi8/ubi\-minimal 
registry.access.redhat.com/ubi9/ubi 
registry.access.redhat.com/ubi9/ubi\-init 
registry.access.redhat.com/ubi9/ubi\-minimal
T}
T{
Rocky Linux
T}@T{
8  8\-minimal  9
T}@T{
quay.io/rockylinux/rockylinux:8 
quay.io/rockylinux/rockylinux:8\-minimal 
quay.io/rockylinux/rockylinux:9  quay.io/rockylinux/rockylinux:latest
T}
T{
Slackware
T}@T{
T}@T{
docker.io/vbatts/slackware:current
T}
T{
SteamOS
T}@T{
T}@T{
ghcr.io/linuxserver/steamos:latest
T}
T{
Ubuntu
T}@T{
14.04  16.04  18.04  20.04  22.04  24.04
T}@T{
docker.io/library/ubuntu:14.04  docker.io/library/ubuntu:16.04 
docker.io/library/ubuntu:18.04  docker.io/library/ubuntu:20.04 
docker.io/library/ubuntu:22.04  docker.io/library/ubuntu:24.04
T}
T{
Vanilla OS
T}@T{
VSO
T}@T{
ghcr.io/vanilla\-os/vso:main
T}
T{
Void Linux
T}@T{
glibc  musl
T}@T{
ghcr.io/void\-linux/void\-glibc\-full:latest 
ghcr.io/void\-linux/void\-musl\-full:latest
T}
.TE
.PP
ایمیج‌های مشخص‌شده با \f[B]Toolbox\f[R] ایمیج‌های سفارشی‌سازی‌شده‌ای هستند که حاصل تلاش‌های جامعه کاربری در \c
.UR https://github.com/toolbx-images/images
toolbx\-images/images
.UE \c
می‌باشند؛ بنابراین این ایمیج‌ها برای استفاده در محیط میزکار مناسب‌تر بوده و راه‌اندازی اولیه آنها زمان کمتری خواهد برد.
با این حال توجه داشته باشید که اگر از یک ایمیج از‌پیش‌پیکربندی‌نشده (غیر Toolbox) استفاده کنید،
\f[B]نخستین\f[R] \f[CR]distrobox\-enter\f[R] که اجرا می‌کنید ممکن است کمی زمان ببرد،
زیرا نیازمندی‌ها و وابستگی‌های ناموجود را بارگیری و نصب خواهد کرد.
.PP
این زمان اندک، هزینه‌ای ناچیز در ازای امکان استفاده از هر نوع ایمیجی است.
این فرایند پس از بار اول \f[B]دیگر رخ نخواهد داد\f[R]، و
\f[B]ورودهای بعدی بسیار سریع‌تر خواهند بود.\f[R]
.PP
سیستم‌عامل NixOS به عنوان یک توزیع کانتینری پشتیبانی نمی‌شود و در حال حاضر هیچ برنامه‌ای برای افزودن پشتیبانی از آن وجود ندارد.
اگر به دنبال محیط‌های بدون امتیاز (unprivileged) در NixOS هستید، پیشنهاد می‌کنیم به \c
.UR https://nixos.org/manual/nix/unstable/command-ref/nix-shell.html
nix\-shell
.UE \c
\ یا \c
.UR https://github.com/DavHau/nix-portable
nix portable
.UE \c
نگاهی بیندازید.
.SS "پشتیبانی از توزیع‌های جدید (NEW DISTRO SUPPORT)"
اگر توزیع مورد نظر شما در فهرست نیست، یک ایشو (issue) باز کنید و درخواست پشتیبانی از آن را ثبت نمایید؛
ما می‌توانیم با همکاری یکدیگر امکان افزودن پشتیبانی برای آن را بررسی کنیم.
.PP
یا می‌توانید آن را امتحان کنید؛ اگر کار کرد، یک ایشو باز کنید تا به فهرست اضافه شود!
.SS "توزیع‌های قدیمی‌تر (OLDER DISTRIBUTIONS)"
برای توزیع‌های قدیمی‌تر مانند CentOS 5 ،CentOS 6 ،Debian 6 و Ubuntu 12.04، سازگاری تضمین نمی‌شود.
.PP
نسخه \f[CR]libc\f[R] آنها با نسخه‌های کرنل \f[CR]>=4.11\f[R] ناسازگار است.
یک راهکار برای دور زدن این مشکل، استفاده از پرچم \f[CR]vsyscall=emulate\f[R] در بوت‌لودر سیستم میزبان است.
.PP
همچنین به یاد داشته باشید که ممکن است مخازن آینه‌ای (mirrors) برای چنین نسخه‌های قدیمی از دسترس خارج شده باشند؛
بنابراین باید یک ایمیج سفارشی distrobox بسازید تا مطمئن شوید وابستگی‌های پایه‌ای برآورده شده‌اند.
.SS "پشتیبانی از شتاب‌دهنده گرافیکی (GPU ACCELERATION SUPPORT)"
برای پردازنده‌های گرافیکی Intel و AMD، این پشتیبانی به صورت توکار فراهم است، زیرا کانتینرها جدیدترین درایورهای موجود mesa/dri را نصب خواهند کرد.
.PP
برای NVidia، می‌توانید از پرچم \f[CR]\-\-nvidia\f[R] هنگام ایجاد کانتینر استفاده کنید؛
مستندات distrobox\-create را برای آشنایی با نحوه استفاده از آن بررسی نمایید.
.PP
همچنین می‌توانید از ابزار nvidia\-container\-toolkit برای راه‌اندازی این یکپارچه‌سازی، مستقل از پرچم اختصاصی distrobox استفاده کنید.