DISTROBOX(1) User Manual DISTROBOX(1) نام (NAME) distrobox-compatibility - جدول و مستندات سازگاری توزیع‌ها و مدیران کانتینر در distrobox سازگاری (COMPATIBILITY) این پروژه نیازی به ایمیج اختصاصی ندارد. این ابزار می‌تواند از هر ایمیج OCI موجود در docker-hub ،quay.io یا هر رجیستری دلخواه دیگری استفاده کند. بسیاری از ایمیج‌های ابری عمداً برای کاهش حجم سبک‌سازی شده‌اند و ممکن است شامل دستوراتی مانند which، mount، less یا vi نباشند. بسته‌های اضافی را می‌توان پس از ورود به کانتینر نصب کرد. اگر نیاز دارید به طور مکرر کانتینرهای جدید بسازید، توصیه می‌کنیم از ابزار خودکارسازی دلخواه خود درون کانتینر استفاده کنید. نگهداری ایمیج سفارشی اختصاصی خود نیز گزینه دیگری است. موضوع اصلی، وجود ابزارهای پایه‌ای لینوکس (mount)، ابزارهای پایه‌ای مدیریت کاربر (usermod, passwd)، و پیکربندی صحیح sudo است. مدیران کانتینر پشتیبانی‌شده (SUPPORTED CONTAINER MANAGERS) distrobox می‌تواند روی هر یک از ابزارهای podman، docker یا lilipod اجرا شود. این ابزار به podman پیکربندی‌شده در حالت بدون ریشه (rootless mode) یا به docker پیکربندی‌شده بدون sudo وابسته است (طبق این دستورالعمل‌ها عمل کنید). • حداقل نسخه podman: 2.1.0 • حداقل نسخه کلاینت docker: 19.03.15 • حداقل نسخه lilipod: v0.0.1 راهنمای رسمی نصب را در اینجا دنبال کنید: • • • توزیع‌های کانتینر (CONTAINERS DISTROS) مهمان‌های 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 quay.io/toolbx-images/debian-toolbox:11 unstable 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 registry.fedoraproject.org/fedora-toolbox:38 Rawhide 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 quay.io/toolbx/ubuntu-toolbox:16.04 22.04 24.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 quay.io/toolbx-images/wolfi-toolbox:latest (Toolbox) Ublue ubuntu-toolbox ghcr.io/ublue-os/ubuntu-toolbox fedora-toolbox ghcr.io/ublue-os/fedora-toolbox wolfi-toolbox ghcr.io/ublue-os/wolfi-toolbox archlinux-distrobox ghcr.io/ublue-os/arch-toolbox AlmaLinux 8 8-minimal 9 docker.io/library/almalinux:8 9-minimal 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 docker.io/linuxdeepin/apricot (beige) docker.io/linuxdeepin/deepin:beige Fedora 38 39 40 41 42 43 quay.io/fedora/fedora:38 quay.io/fedora/fedora:39 Rawhide 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 container-registry.oracle.com/os/oraclelinux:8 10 10-slim 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 docker.io/library/ubuntu:14.04 20.04 22.04 24.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 نگاهی بیندازید. پشتیبانی از توزیع‌های جدید (NEW DISTRO SUPPORT) اگر توزیع مورد نظر شما در فهرست نیست، یک ایشو (issue) باز کنید و درخواست پشتیبانی از آن را ثبت نمایید؛ ما می‌توانیم با همکاری یکدیگر امکان افزودن پشتیبانی برای آن را بررسی کنیم. یا می‌توانید آن را امتحان کنید؛ اگر کار کرد، یک ایشو باز کنید تا به فهرست اضافه شود! توزیع‌های قدیمی‌تر (OLDER DISTRIBUTIONS) برای توزیع‌های قدیمی‌تر مانند CentOS 5 ،CentOS 6 ،Debian 6 و Ubuntu 12.04، سازگاری تضمین نمی‌شود. نسخه libc آنها با نسخه‌های کرنل >=4.11 ناسازگار است. یک راهکار برای دور زدن این مشکل، استفاده از پرچم vsyscall=emulate در بوت‌لودر سیستم میزبان است. همچنین به یاد داشته باشید که ممکن است مخازن آینه‌ای (mirrors) برای چنین نسخه‌های قدیمی از دسترس خارج شده باشند؛ بنابراین باید یک ایمیج سفارشی distrobox بسازید تا مطمئن شوید وابستگی‌های پایه‌ای برآورده شده‌اند. پشتیبانی از شتاب‌دهنده گرافیکی (GPU ACCELERATION SUPPORT) برای پردازنده‌های گرافیکی Intel و AMD، این پشتیبانی به صورت توکار فراهم است، زیرا کانتینرها جدیدترین درایورهای موجود mesa/dri را نصب خواهند کرد. برای NVidia، می‌توانید از پرچم --nvidia هنگام ایجاد کانتینر استفاده کنید؛ مستندات distrobox-create را برای آشنایی با نحوه استفاده از آن بررسی نمایید. همچنین می‌توانید از ابزار nvidia-container-toolkit برای راه‌اندازی این یکپارچه‌سازی، مستقل از پرچم اختصاصی distrobox استفاده کنید. Distrobox Mar 2026 DISTROBOX(1)