使用 Distrobox 需要哪些依赖和前置条件?

Distrobox 本身不直接运行发行版，它依赖一个容器管理器来创建容器。因此，使用前必须满足两个条件：宿主机上已安装 podman、docker 或 lilipod 三者之一，并且你使用的宿主发行版在支持范围内。满足这两点后，就可以通过命令行创建、进入和管理容器，容器会与宿主机紧密集成，共享 HOME 目录、外部存储、USB 设备以及图形应用（X11/Wayland）和音频。

核心依赖：容器管理器

Distrobox 使用 podman、docker 或 lilipod 来创建你选择的 Linux 发行版容器。三者任选其一即可，不需要全部安装。

官方文档中专门列出了“Install Podman without root”一节，说明在无 root 权限的环境下安装 Podman 也是一个需要单独处理的前置环节。如果你所在的宿主机不允许 root 操作，需要先按这一思路准备好容器管理器。

宿主环境支持

Distrobox 支持在多种宿主发行版上运行，官方文档的“Compatibility”部分列出了支持的宿主发行版，并单独提供了“Install on the Steamdeck”的说明。也就是说，Steam Deck 也是被明确支持的宿主环境之一。

在动手前，建议先确认你的宿主发行版是否出现在官方兼容性列表中，避免因宿主环境不匹配导致后续步骤无法进行。

安装 Distrobox 的方式

官方文档给出了几种安装路径，可按你的环境选择：

• Curl 或 Wget：通过脚本方式安装。
• Git：从 Git 获取源码进行安装。
• Alternative methods：其他替代安装方式。

安装完成后，Distrobox 提供两类命令：在宿主机上使用的是 distrobox-create、distrobox-enter、distrobox-list、distrobox-rm、distrobox-stop、distrobox-upgrade、distrobox-assemble、distrobox-ephemeral、distrobox-generate-entry 等；在容器内部使用的是 distrobox-export、distrobox-host-exec、distrobox-init。

验证与常见卡点

安装并准备好容器管理器后，可以用 distrobox-create 创建容器、用 distrobox-enter 进入容器、用 distrobox-list 查看已有容器，以此验证环境是否可用。

几个官方文档中单独列出的注意事项，容易成为卡点：

• 文档版本问题：GitHub 上的文档严格对应 main 分支的代码。官方文档以 https://distrobox.it 为准，查阅时应以该站点内容为依据，避免因分支差异产生误解。
• 无 root 安装 Podman：如果宿主机没有 root 权限，需要参考“Install Podman without root”的处理方式。
• 图形显示问题：官方“Useful tips”中专门有“Resolve 'Error cannot open display: :0'”一节，说明图形应用显示失败是常见问题之一。
• 容器管理器选择：podman、docker、lilipod 三者选其一即可，但需要确保所选管理器在宿主机上可用。

卸载

官方文档包含“Uninstallation”一节，说明 Distrobox 提供了对应的卸载方式。如果只是试用，可以先了解卸载路径再决定是否长期保留。