Distrobox 镜像与容器生命周期

# 创建容器时自动拉取镜像
distrobox create --name dev-ubuntu --image ubuntu:24.04

# 如果本地已有镜像，跳过拉取；若想强制重新拉取，使用 --pull
distrobox create --name dev-ubuntu --image ubuntu:24.04 --pull

# 使用 podman 拉取镜像（Distrobox 底层）
podman pull ubuntu:24.04
podman pull registry.fedoraproject.org/fedora:40
podman pull docker.io/archlinux:latest

# 使用 docker 拉取（如果容器后端是 Docker）
docker pull ubuntu:24.04

# 查看本地已有镜像（podman 方式）
podman images

# 查看本地已有镜像（docker 方式）
docker images

# 查看由 Distrobox 管理的容器列表（间接反映已用镜像）
distrobox list --verbose

distrobox create --name <名称> --image <镜像> [可选参数...]

# 1. 最简创建：名称 + 镜像
distrobox create --name mybox --image fedora:latest

# 2. 指定独立的 Home 目录（dotfiles 与宿主隔离）
distrobox create --name dev --image archlinux:latest \
  --home ~/.distrobox/dev-home

# 3. 创建时预装开发工具链
distrobox create --name gpu-box --image ubuntu:22.04 \
  --additional-packages "build-essential curl git vim"

# 4. 非交互式创建（脚本/自动化场景）
distrobox create --name test --image alpine:latest --yes

# 5. 创建带 systemd 的容器（运行 systemd 服务）
distrobox create --name server-box --image ubuntu:24.04 --init --additional-packages "systemd"

# 6. 挂载额外卷
distrobox create --name data-box --image ubuntu:24.04 \
  --volume /mnt/nas:/nas \
  --volume /mnt/scratch:/scratch

# 7. 从指定 registry 创建
distrobox create --name fedora-toolbox --image registry.fedoraproject.org/fedora-toolbox:40

# 8. 创建 rootful 容器（需要宿主机 root 权限）
distrobox create --name root-box --image ubuntu:24.04 --root

distrobox enter <名称> [-- 命令 [参数...]]

# 1. 进入容器的交互式 shell
distrobox enter mybox

# 2. 普通容器内以 root 身份运行一个命令
distrobox enter mybox -- sudo whoami
# 若容器由 rootful 后端创建，访问时再选择 --root
# distrobox enter --root root-box

# 3. 在容器中执行单条命令后退出
distrobox enter mybox -- whoami

# 4. 在容器中执行带参数的命令
distrobox enter mybox -- python3 --version

# 5. 在容器中执行 shell 组合命令
distrobox enter mybox -- bash -c "sudo apt update && sudo apt upgrade -y"

# 6. 在容器中启动一个服务/应用
distrobox enter mybox -- code --new-window

# 7. 从容器中运行带管道和重定向的复杂命令
distrobox enter mybox -- bash -c "find /usr -name '*.so' | wc -l"

# 基本列表
distrobox list

# 调试输出（verbose 不等于更多业务列）
distrobox list --verbose

ID           | NAME                 | STATUS                         | IMAGE
123abc       | dev-ubuntu           | Up 2 hours                     | ubuntu:24.04
456def       | gpu-box              | Exited (0) 3 days ago          | nvidia/cuda:12.4.1-devel-ubuntu22.04

# 停止指定容器
distrobox stop mybox

# 停止所有容器
distrobox stop --all

# 删除指定容器（必须先停止）
distrobox rm mybox

# 强制删除（可删除运行中的容器，确认已备份）
distrobox rm mybox --force

# 删除所有已停止的容器
distrobox stop --all
distrobox rm --all

# 升级单个容器内的所有软件包
distrobox upgrade mybox

# 升级所有容器
distrobox upgrade --all

distrobox-ephemeral --image <镜像> [可选参数] [-- 命令]

# 1. 进入临时 Fedora 容器玩耍，exit 后容器消失
distrobox-ephemeral --image fedora:latest

# 2. 运行单个命令，执行完后自动退出并销毁
distrobox-ephemeral --image alpine:latest -- uname -a

# 3. 比较临时用户空间的发行版信息；不是安全沙箱
distrobox-ephemeral --image ubuntu:24.04 -- cat /etc/os-release

# 4. 临时容器中安装并运行一个工具，用完即走
distrobox-ephemeral --image python:3.12-slim \
  --additional-packages "ffmpeg" \
  -- python3 -c "import sys; print(sys.version)"

# 5. 在临时容器中 clone 仓库并做一次性编译测试
distrobox-ephemeral --name build-test --image ubuntu:24.04 \
  --additional-packages "gcc make git" \
  -- bash -c "git clone https://github.com/example/project /tmp/p && cd /tmp/p && make"

distrobox-host-exec <宿主的命令和参数>

# 先从宿主进入容器
distrobox enter mybox

# === 以下命令在容器内部执行 ===

# 1. 在容器内打开宿主上的 Obsidian
distrobox-host-exec flatpak run md.obsidian.Obsidian

# 2. 在容器内查看宿主 systemd 用户服务状态
distrobox-host-exec systemctl --user status pipewire

# 3. 在容器内使用宿主安装的浏览器打开 URL
distrobox-host-exec firefox https://wiki.archlinux.org

# 4. 把容器内的数据通过宿主的工具处理
some-command | distrobox-host-exec wl-copy   # 复制到宿主 Wayland 剪贴板

# 5. 在容器内控制宿主 Flatpak 应用
distrobox-host-exec flatpak list
distrobox-host-exec flatpak run com.visualstudio.code

# fish shell (~/.config/fish/config.fish)
alias db-dev="distrobox enter dev-ubuntu"
alias db-arch="distrobox enter arch-box"

# bash (~/.bashrc)
alias db-dev="distrobox enter dev-ubuntu"
alias db-arch="distrobox enter arch-box"

distrobox create --name newbox --image ubuntu:24.04 && distrobox enter newbox

# 判断是否在 Distrobox 容器内
if [ -n "$CONTAINER_ID" ]; then
    echo "当前在容器: $CONTAINER_ID"
else
    echo "当前在宿主环境"
fi

# 在 ~/.bashrc 或 ~/.config/fish/config.fish 中添加
# bash 版本
if [ -n "$CONTAINER_ID" ]; then
    PS1="📦 [$CONTAINER_ID] \w $ "
fi

# fish 版本
if set -q CONTAINER_ID; and [ -n "$CONTAINER_ID" ]
    function fish_prompt
        echo -n "📦 [$CONTAINER_ID] "(prompt_pwd)" \$ "
    end
end

# Arch 容器使用独立的 HOME
distrobox create --name arch-box --image archlinux:latest \
  --home ~/.distrobox/arch-home

# Ubuntu 开发容器使用另一个 HOME
distrobox create --name dev-ubuntu --image ubuntu:24.04 \
  --home ~/.distrobox/ubuntu-dev-home

distrobox create \
  --name arch \
  --image quay.io/toolbx/arch-toolbox:latest \
  --home ~/distrobox-homes/arch \
  --volume /home/user:/host-home

distrobox create \
  --name arch \
  --image quay.io/toolbx/arch-toolbox:latest \
  --home ~/distrobox-homes/arch \
  --volume /home/user/projects:/projects

--volume "$HOME/.config/starship.toml:$HOME/distrobox-homes/arch/.config/starship.toml:ro"
--volume "$HOME/.config/fish:$HOME/distrobox-homes/arch/.config/fish:ro"

xdg.configFile."distrobox/distrobox.ini".text = ''
  [arch]
  image=quay.io/toolbx/arch-toolbox:latest
  home=~/.local/share/distrobox-homes/arch
  volume=/home/user:/host-home
  volume=/home/user/projects:/projects
'';