Project Icon

distrobox

跨发行版容器化 Linux 环境管理工具

Distrobox 是一款跨 Linux 发行版的容器化环境管理工具。它利用 Podman、Docker 或 Lilipod 创建容器,实现与主机系统的无缝集成,包括共享用户主目录、图形应用和音频等功能。通过 Distrobox,用户可以在不同 Linux 发行版间实现兼容,为开发、游戏和日常使用提供灵活多样的环境选择。

Distrobox

前一个 logo 版权归属 j4ckr3d
当前 logo 版权归属 David Lapshin

Lint CI GitHub GitHub release (latest by date) Packaging status GitHub issues by-label

在终端中使用任何 Linux 发行版。实现软件的向前和向后兼容性,并自由选择您最熟悉的发行版。 Distrobox 使用 podmandockerlilipod 创建容器,使用您选择的 Linux 发行版。 创建的容器将与主机紧密集成,允许共享用户的 HOME 目录、外部存储、外部 USB 设备以及图形应用程序(X11/Wayland)和音频。


文档 - Matrix 聊天室 - Telegram 群组


概述


[!警告]
GitHub 上的文档严格参考主分支中的代码。如需查看官方文档, 请访问 https://distrobox.it


功能介绍

简单来说,它是一个围绕 podmandockerlilipod 的高级封装,用于创建和启动与宿主系统高度集成的容器。

Distrobox 环境基于 OCI 镜像。 该镜像用于创建一个与操作系统其他部分无缝集成的容器,提供对用户家目录、 Wayland 和 X11 套接字、网络、可移动设备(如 USB 存储设备)、 systemd 日志、SSH 代理、D-Bus、 ulimits、/dev 和 udev 数据库等的访问。

它实现了 https://github.com/containers/toolbox 引入的相同概念, 但以简化的方式使用 POSIX sh,旨在实现更广泛的兼容性。

所有功劳归功于他们,因为他们有这个绝妙的想法来实现这些功能。

它分为 12 个命令:

  • distrobox-assemble - 根据配置文件创建和销毁容器
  • distrobox-create - 创建容器
  • distrobox-enter - 进入容器
  • distrobox-ephemeral - 创建临时容器,退出 shell 时销毁
  • distrobox-list - 列出用 distrobox 创建的容器
  • distrobox-rm - 删除用 distrobox 创建的容器
  • distrobox-stop - 停止用 distrobox 创建的运行中容器
  • distrobox-upgrade - 一次升级一个或多个用 distrobox 创建的运行中容器
  • distrobox-generate-entry - 在应用程序列表中为已创建的容器创建条目
  • distrobox-init - 容器的入口点(不meant于手动使用)
  • distrobox-export - 用于容器内部, 用于将应用程序和服务从容器导出到宿主系统
  • distrobox-host-exec - 在容器内运行宿主系统的命令/程序

它还包括一个小型封装器,可以使用 distrobox COMMAND 启动命令, 而不是调用单个文件。

请查看这里的使用文档一些有用的使用技巧

实际演示

感谢 castrojo,你可以在这个解释性视频中看到 Distrobox 的 实际运行,该视频展示了他使用 Distrobox、Toolbx、 Fedora Silverblue 为 uBlue 项目设置的环境 (值得一看!)

视频

为什么使用

  • 在不可变操作系统上提供可变环境,如 ChromeOS、Endless OS、 Fedora Silverblue、OpenSUSE Aeon/Kalpa、Vanilla OSSteamOS3
  • 为无 sudo 权限的设置提供本地特权环境 (例如,公司提供的笔记本电脑、安全原因等)
  • 将稳定的基础系统(如 Debian Stable、Ubuntu LTS、RedHat) 与用于开发或游戏的前沿环境混合搭配 (如 Arch、OpenSUSE Tumbleweed 或带有最新 Mesa 的 Fedora)
  • 利用 docker/podman 的大量精心策划的发行版镜像来 管理多个环境。

请参阅兼容性列表,了解支持的宿主发行版此处和容器发行版此处的概述。

目标

本项目旨在将任何发行版的用户空间带到任何其他支持 podmandockerlilipod 的发行版。 它使用 POSIX shell 编写,以尽可能具有可移植性,并且不会 出现依赖项和 glibc 版本兼容性问题。

请参阅此处获取 支持的容器管理器列表和最低支持版本。

它还旨在尽可能快地进入容器,如果你将容器用作终端的默认环境, 每一毫秒的延迟都会累积:

以下是我在弱性笔记本上对同一容器运行 distrobox-enter 的一些示例结果:

~$ hyperfine --warmup 3 --runs 100 "distrobox enter bench -- whoami"
Benchmark 1: distrobox enter bench -- whoami
  Time (mean ± σ):     395.6 ms ±  10.5 ms    [User: 167.4 ms, System: 62.4 ms]
  Range (min … max):   297.3 ms … 408.9 ms    100 runs

安全影响

隔离和沙箱化不是项目的主要目标,相反, 它旨在将容器与宿主系统紧密集成。 容器将完全访问你的家目录、U盘等, 所以不要期望它像普通的 docker/podman 容器或 Flatpak 那样高度沙箱化。

⚠️ 注意:⚠️ 如果你使用 docker,或者使用带有 --root/-r 标志的 podman/lilipod, 容器将以 root 身份运行,所以root 用户在有 root 权限的容器内可以修改 容器外的系统内容, 还要注意,在 root 模式下,你将被要求设置用户密码,这将 至少确保容器不是一个无密码进入 root 的大门, 但如果你对此有安全顾虑,请使用以无 root 模式运行的 podmanlilipod。 无 root 的 docker 仍然无法按预期工作,将在未来 完善后包含在内。

话虽如此,正在进行与宿主系统解耦的一些工作, 如此处讨论:#28 沙箱模式


快速入门

创建新的 distrobox:

distrobox create -n test

创建带有 Systemd 的新 distrobox(类似于 LXC):

distrobox create --name test --init --image debian:latest --additional-packages "systemd libpam-systemd pipewire-audio-client-libraries"

进入已创建的 distrobox:

distrobox enter test

添加一个不同发行版的容器, 例如 Ubuntu 20.04:

distrobox create -i ubuntu:20.04

在 distrobox 中执行命令:

distrobox enter test -- command-to-execute

列出运行中的 distrobox:

distrobox list

停止运行中的 distrobox:

distrobox stop test

删除 distrobox: distrobox rm test

您可以在这里查看更高级的用法,并在这里查看有用技巧的综合列表

组装 Distrobox

可以使用清单文件声明一组 distrobox,并使用 distrobox-assemble 批量创建/销毁它们。

查看 distrobox-assemble 的使用文档以获取更详细的指南。

配置 Distrobox

配置文件可以放置在以下路径中,按重要性从低到高排列:

  • /usr/share/distrobox/distrobox.conf
  • /usr/etc/distrobox/distrobox.conf
  • /etc/distrobox/distrobox.conf
  • ${HOME}/.config/distrobox/distrobox.conf
  • ${HOME}/.distroboxrc

您可以在 distrobox 配置文件中指定配置和特定于 distrobox 的环境变量。

配置文件示例:

container_always_pull="1"
container_generate_entry=0
container_manager="docker"
container_image_default="registry.opensuse.org/opensuse/toolbox:latest"
container_name_default="test-name-1"
container_user_custom_home="$HOME/.local/share/container-home-test"
container_init_hook="~/.local/distrobox/a_custom_default_init_hook.sh"
container_pre_init_hook="~/a_custom_default_pre_init_hook.sh"
container_manager_additional_flags="--env-file /path/to/file --custom-flag"
container_additional_volumes="/example:/example1 /example2:/example3:ro"
non_interactive="1"
skip_workdir="0"
PATH="$PATH:/path/to/custom/podman"

或者,也可以使用环境变量指定首选项:

  • DBX_CONTAINER_ALWAYS_PULL
  • DBX_CONTAINER_CUSTOM_HOME
  • DBX_CONTAINER_IMAGE
  • DBX_CONTAINER_MANAGER
  • DBX_CONTAINER_NAME
  • DBX_CONTAINER_ENTRY
  • DBX_NON_INTERACTIVE
  • DBX_SKIP_WORKDIR

安装

Distrobox 已在以下发行版中打包,如果您的发行版在此列表中,您可以参考您的软件源进行安装:

打包状态

感谢维护者们的工作:M0Rf30alcirdfaggioliAtilaSaraivamichel-slm

替代安装方法

以下是安装 distrobox 的替代方法列表。

Curl 或 Wget

如果您喜欢冒险,或者想要最新版本,您可以信任我,在终端中简单运行:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh

或使用 wget:

wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh

如果您想选择自定义目录进行安装而无需 sudo:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --prefix ~/.local

或使用 wget:

wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --prefix ~/.local

如果您想安装最新的开发版本,直接从 Git 上的最新提交安装,可以使用:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh -s -- --next

或使用 wget:

wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh -s -- --next

或:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --next --prefix ~/.local

或使用 wget:

wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh -s -- --next --prefix ~/.local

升级

只需再次运行 curlwget 命令。

[!警告] 记得将你选择的前缀路径/bin 添加到你的 PATH 中,以使其生效。

Git

或者,您可以使用 git clone 克隆项目,或使用这里的最新发布版本。

进入目录并运行 ./install,默认情况下它会尝试安装在 ~/.local 中,但如果您以 root 身份运行脚本,它将默认安装在 /usr/local 中。您可以使用 --prefix 标志指定自定义目录,例如 ./install --prefix ~/.distrobox

前缀说明:主要的 distrobox 文件安装到 ${prefix}/bin,而手册页安装到 ${prefix}/share/man


查看宿主发行版兼容性列表以获取特定发行版的说明。

依赖项

Distrobox 依赖于容器管理器才能工作,您可以选择安装 podmandockerlilipod

请查看兼容性表以了解您的发行版注意事项。

有一些方法可以在没有 root 权限的情况下在 home 目录中静态安装 Podman在没有 root 权限的情况下在 home 目录中静态安装 Lilipod。这应该能很好地适用于完全无 sudo 的设置和 Steam Deck(SteamOS)等设备。


卸载

如果您使用 install 脚本在默认安装目录中安装了 distrobox,请使用以下命令:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/uninstall | sudo sh

或者如果您指定了自定义路径:

curl -s https://raw.githubusercontent.com/89luca89/distrobox/main/uninstall | sh -s -- --prefix ~/.local

如果您使用 git clone 克隆了项目或从这里下载了最新的发布版本存档,

进入目录并运行 ./uninstall,默认情况下,如果以 root 身份运行,它会假设安装目录为 /usr/local,否则为 ~/.local。如果需要,您可以指定另一个目录,例如 ./uninstall --prefix ~/.local


distro-box 本作品使用了由 J0Y 创作的 纸板箱 模型, 该模型采用 知识共享署名 4.0 许可协议
本作品使用了由 GNOME 项目 创作的 GTK 循环动画 作为预配置场景,该动画采用 知识共享署名-相同方式共享 3.0 许可协议

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号