DISTROBOX(1) User Manual DISTROBOX(1)

distrobox-compatibility - جدول و مستندات سازگاری توزیع‌ها و مدیران کانتینر در distrobox

این پروژه نیازی به ایمیج اختصاصی ندارد. این ابزار می‌تواند از هر ایمیج OCI موجود در docker-hub ،quay.io یا هر رجیستری دلخواه دیگری استفاده کند.

بسیاری از ایمیج‌های ابری عمداً برای کاهش حجم سبک‌سازی شده‌اند و ممکن است شامل دستوراتی مانند which، mount، less یا vi نباشند. بسته‌های اضافی را می‌توان پس از ورود به کانتینر نصب کرد. اگر نیاز دارید به طور مکرر کانتینرهای جدید بسازید، توصیه می‌کنیم از ابزار خودکارسازی دلخواه خود درون کانتینر استفاده کنید. نگهداری ایمیج سفارشی اختصاصی خود نیز گزینه دیگری است.

موضوع اصلی، وجود ابزارهای پایه‌ای لینوکس (mount)، ابزارهای پایه‌ای مدیریت کاربر (usermod, passwd)، و پیکربندی صحیح sudo است.

distrobox می‌تواند روی هر یک از ابزارهای podman، docker یا lilipodاجرا شود.

این ابزار به podman پیکربندی‌شده در حالت بدون ریشه (rootless mode) یا به docker پیکربندی‌شده بدون sudo وابسته است (طبق این دستورالعمل‌هاعمل کنید).

•
حداقل نسخه podman: 2.1.0
•
حداقل نسخه کلاینت docker: 19.03.15
•
حداقل نسخه lilipod: v0.0.1

راهنمای رسمی نصب را در اینجا دنبال کنید:

•
https://podman.io/getting-started/installation
•
https://docs.docker.com/engine/install
•
https://docs.docker.com/engine/install/linux-postinstall

مهمان‌های Distrobox با ایمیج‌های کانتینری زیر با موفقیت آزمایش شده‌اند:

توزیع نسخه ایمیج‌ها
AlmaLinux (Toolbox) 8 9 quay.io/toolbx-images/almalinux-toolbox:8 quay.io/toolbx-images/almalinux-toolbox:9 quay.io/toolbx-images/almalinux-toolbox:latest
Alpine (Toolbox) 3.20 3.21 3.22 edge 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
AmazonLinux (Toolbox) 2 2022 quay.io/toolbx-images/amazonlinux-toolbox:2 quay.io/toolbx-images/amazonlinux-toolbox:2023 quay.io/toolbx-images/amazonlinux-toolbox:latest
Archlinux (Toolbox) quay.io/toolbx/arch-toolbox:latest
ALT Linux p10 p11 sisyphus docker.io/library/alt:p10 docker.io/library/alt:p11 docker.io/library/alt:sisyphus
Bazzite Arch ghcr.io/ublue-os/bazzite-arch:latest ghcr.io/ublue-os/bazzite-arch-gnome:latest
Centos (Toolbox) stream9 stream10 quay.io/toolbx-images/centos-toolbox:stream9 quay.io/toolbx-images/centos-toolbox:stream10 quay.io/toolbx-images/centos-toolbox:latest
Debian (Toolbox) 11 12 13 testing unstable 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
Fedora (Toolbox) 38 39 40 41 42 43 Rawhide 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
openSUSE (Toolbox) registry.opensuse.org/opensuse/distrobox:latest
RedHat (Toolbox) 8 9 registry.access.redhat.com/ubi8/toolbox registry.access.redhat.com/ubi9/toolbox
Rocky Linux (Toolbox) 8 9 quay.io/toolbx-images/rockylinux-toolbox:8 quay.io/toolbx-images/rockylinux-toolbox:9 quay.io/toolbx-images/rockylinux-toolbox:latest
Ubuntu (Toolbox) 16.04 18.04 20.04 22.04 24.04 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
Chainguard Wolfi (Toolbox) quay.io/toolbx-images/wolfi-toolbox:latest
Ublue ubuntu-toolbox fedora-toolbox wolfi-toolbox archlinux-distrobox ghcr.io/ublue-os/ubuntu-toolbox ghcr.io/ublue-os/fedora-toolbox ghcr.io/ublue-os/wolfi-toolbox ghcr.io/ublue-os/arch-toolbox
AlmaLinux 8 8-minimal 9 9-minimal docker.io/library/almalinux:8 docker.io/library/almalinux:9
Alpine Linux 3.20 3.21 3.22 edge 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
AmazonLinux 1 2 2023 public.ecr.aws/amazonlinux/amazonlinux:1 public.ecr.aws/amazonlinux/amazonlinux:2 public.ecr.aws/amazonlinux/amazonlinux:2023
Archlinux docker.io/library/archlinux:latest
Blackarch docker.io/blackarchlinux/blackarch:latest
CentOS Stream 8 9 10 quay.io/centos/centos:stream8 quay.io/centos/centos:stream9 quay.io/centos/centos:stream10
Chainguard Wolfi cgr.dev/chainguard/wolfi-base:latest
Chimera Linux docker.io/chimeralinux/chimera:latest
Crystal Linux registry.gitlab.com/crystal-linux/misc/docker:latest
Debian 7 8 9 10 11 12 13 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
Debian Testing docker.io/library/debian:testing docker.io/library/debian:testing-backports
Debian Unstable docker.io/library/debian:unstable
deepin 20 (apricot) 23 (beige) docker.io/linuxdeepin/apricot docker.io/linuxdeepin/deepin:beige
Fedora 38 39 40 41 42 43 Rawhide 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
Gentoo Linux rolling docker.io/gentoo/stage3:latest
KDE neon Latest invent-registry.kde.org/neon/docker-images/plasma:latest
Kali Linux rolling docker.io/kalilinux/kali-rolling:latest
Mint 22.3 docker.io/linuxmintd/mint22.3-amd64
Neurodebian nd120 docker.io/library/neurodebian:nd120
openSUSE Leap registry.opensuse.org/opensuse/leap:latest
openSUSE Tumbleweed 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
Oracle Linux 8 8-slim 9 9-slim 10 10-slim 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
RedHat (UBI) 7 8 9 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
Rocky Linux 8 8-minimal 9 quay.io/rockylinux/rockylinux:8 quay.io/rockylinux/rockylinux:8-minimal quay.io/rockylinux/rockylinux:9 quay.io/rockylinux/rockylinux:latest
Slackware docker.io/vbatts/slackware:current
SteamOS ghcr.io/linuxserver/steamos:latest
Ubuntu 14.04 16.04 18.04 20.04 22.04 24.04 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
Vanilla OS VSO ghcr.io/vanilla-os/vso:main
Void Linux glibc musl ghcr.io/void-linux/void-glibc-full:latest ghcr.io/void-linux/void-musl-full:latest

ایمیج‌های مشخص‌شده با Toolbox ایمیج‌های سفارشی‌سازی‌شده‌ای هستند که حاصل تلاش‌های جامعه کاربری در toolbx-images/imagesمی‌باشند؛ بنابراین این ایمیج‌ها برای استفاده در محیط میزکار مناسب‌تر بوده و راه‌اندازی اولیه آنها زمان کمتری خواهد برد. با این حال توجه داشته باشید که اگر از یک ایمیج از‌پیش‌پیکربندی‌نشده (غیر Toolbox) استفاده کنید، نخستین distrobox-enter که اجرا می‌کنید ممکن است کمی زمان ببرد، زیرا نیازمندی‌ها و وابستگی‌های ناموجود را بارگیری و نصب خواهد کرد.

این زمان اندک، هزینه‌ای ناچیز در ازای امکان استفاده از هر نوع ایمیجی است. این فرایند پس از بار اول دیگر رخ نخواهد داد، و ورودهای بعدی بسیار سریع‌تر خواهند بود.

سیستم‌عامل NixOS به عنوان یک توزیع کانتینری پشتیبانی نمی‌شود و در حال حاضر هیچ برنامه‌ای برای افزودن پشتیبانی از آن وجود ندارد. اگر به دنبال محیط‌های بدون امتیاز (unprivileged) در NixOS هستید، پیشنهاد می‌کنیم به nix-shell یا nix portableنگاهی بیندازید.

اگر توزیع مورد نظر شما در فهرست نیست، یک ایشو (issue) باز کنید و درخواست پشتیبانی از آن را ثبت نمایید؛ ما می‌توانیم با همکاری یکدیگر امکان افزودن پشتیبانی برای آن را بررسی کنیم.

یا می‌توانید آن را امتحان کنید؛ اگر کار کرد، یک ایشو باز کنید تا به فهرست اضافه شود!

برای توزیع‌های قدیمی‌تر مانند CentOS 5 ،CentOS 6 ،Debian 6 و Ubuntu 12.04، سازگاری تضمین نمی‌شود.

نسخه libc آنها با نسخه‌های کرنل >=4.11 ناسازگار است. یک راهکار برای دور زدن این مشکل، استفاده از پرچم vsyscall=emulate در بوت‌لودر سیستم میزبان است.

همچنین به یاد داشته باشید که ممکن است مخازن آینه‌ای (mirrors) برای چنین نسخه‌های قدیمی از دسترس خارج شده باشند؛ بنابراین باید یک ایمیج سفارشی distrobox بسازید تا مطمئن شوید وابستگی‌های پایه‌ای برآورده شده‌اند.

برای پردازنده‌های گرافیکی Intel و AMD، این پشتیبانی به صورت توکار فراهم است، زیرا کانتینرها جدیدترین درایورهای موجود mesa/dri را نصب خواهند کرد.

برای NVidia، می‌توانید از پرچم --nvidia هنگام ایجاد کانتینر استفاده کنید؛ مستندات distrobox-create را برای آشنایی با نحوه استفاده از آن بررسی نمایید.

همچنین می‌توانید از ابزار nvidia-container-toolkit برای راه‌اندازی این یکپارچه‌سازی، مستقل از پرچم اختصاصی distrobox استفاده کنید.

Mar 2026 Distrobox