NixOS 上的 Distrobox：包环境与宿主路径

# 临时启动一个带 python 和 gcc 的环境
nix-shell -p python3 gcc

# 或者用 flakes 语法
nix shell nixpkgs#python3 nixpkgs#gcc

+---------------------------------------------------+
|  NixOS Host (declarative packages)                      |
|  - Kernel, drivers, DE/WM (Hyprland)              |
|  - Core CLI tools (fish, git, neovim via nix)     |
|  - Container runtime (Podman)                     |
|                                                    |
|  +-- Distrobox Container (Arch Linux)             |
|  |   - AUR packages (yay/paru)                    |
|  |   - FHS-compliant filesystem (/usr/lib, /lib)  |
|  |   - Conventional package manager (pacman)      |
|  |   - Shared $HOME with host                     |
|  |                                                |
|  +-- Distrobox Container (Ubuntu 22.04)           |
|  |   - Binary-only software (.deb packages)       |
|  |   - Legacy toolchains with FHS assumptions     |
|  |   - Shared Wayland socket for GUI apps         |
+---------------------------------------------------+

# /etc/nixos/configuration.nix
{ config, pkgs, ... }:

{
  # 启用 Podman + Docker 兼容层
  virtualisation.podman = {
    enable = true;
    dockerCompat = true;        # 创建 docker -> podman 符号链接
    defaultNetwork.settings.dns_enabled = true;
  };

  # 安装 Distrobox（后端用 Podman）
  environment.systemPackages = with pkgs; [
    distrobox
    podman
  ];

  # Rootless 容器所需的 subuid/subgid 映射
  users.users.user = {
    subUidRanges = [
      { startUid = 100000; count = 65536; }
    ];
    subGidRanges = [
      { startGid = 100000; count = 65536; }
    ];
  };
}

nixos-rebuild dry-build
# 确认构建及配置后再应用：
# sudo nixos-rebuild switch

# ~/nixos-config/home/packages.nix 或对应的 home.nix
{ config, pkgs, ... }:

{
  home.packages = with pkgs; [
    distrobox
    podman
  ];
}

home-manager build
# home-manager switch

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs = { self, nixpkgs, flake-utils }:
    flake-utils.lib.eachDefaultSystem (system:
      let pkgs = nixpkgs.legacyPackages.${system};
      in {
        devShells.default = pkgs.mkShell {
          packages = with pkgs; [ distrobox podman ];
          shellHook = ''
            echo "Distrobox version: $(distrobox --version | head -1)"
          '';
        };
      });
}

nix develop

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

# /etc/nixos/configuration.nix
{ config, pkgs, ... }:

{
  virtualisation.podman = {
    enable = true;

    # 创建 docker -> podman 符号链接，兼容 docker 命令
    dockerCompat = true;

    # 为 rootless 容器启用 DNS
    defaultNetwork.settings.dns_enabled = true;
  };

  # 为用户分配 subordinate UID/GID 范围
  # 这是 rootless 容器的核心前提：容器内的 root (UID 0)
  # 被映射到宿主机的非特权 UID 范围
  users.users.user = {
    subUidRanges = [
      {
        startUid = 100000;   # 从属 UID 范围示例，实际映射取决于 userns/keep-id
        count = 65536;       # 映射 65536 个 UID（标准 /etc/subuid 长度）
      }
    ];
    subGidRanges = [
      {
        startGid = 100000;
        count = 65536;
      }
    ];
  };
}

nixos-rebuild dry-build
# 确认后应用：sudo nixos-rebuild switch
# 停止相关容器后再迁移，可能影响当前用户所有容器
podman system migrate           # 确保 rootless 模式迁移完成
podman run --rm hello-world     # 验证 rootless 容器可用

mkdir -p ~/.config/distrobox
cat > ~/.config/distrobox/distrobox.conf << 'EOF'
container_manager="podman"
# 0/1 设置只用于当前版本支持的选项
container_always_pull=0
EOF

# 在 Home Manager 中：
xdg.configFile."distrobox/distrobox.conf".text = ''
  container_manager="podman"
  container_always_pull=0
'';

# 通过 Home Manager 设置额外的挂载路径
xdg.configFile."distrobox/distrobox.conf".text = ''
  container_manager="podman"
  container_additional_volumes="/nix:/nix:ro /etc/profiles/per-user:/etc/profiles/per-user:ro"
'';

# 确保图形栈已启用
{ config, pkgs, ... }:
{
  hardware.graphics.enable = true;   # 启用 Mesa、/dev/dri 等
}

# 创建容器后验证 GPU 直通
distrobox create --name gpu-test --image ubuntu:22.04
distrobox enter gpu-test
sudo apt update && sudo apt install -y mesa-utils
glxinfo | grep "OpenGL renderer"
# 预期输出包含真实的 GPU 型号，而非 "llvmpipe"

{ config, pkgs, ... }:
{
  hardware.nvidia = {
    # open = true;             # 按 GPU 世代和驱动支持选择
    modesetting.enable = true;   # 按桌面/驱动要求启用
  };
  hardware.nvidia-container-toolkit.enable = true;
  services.xserver.videoDrivers = [ "nvidia" ];
}

systemctl status nvidia-container-toolkit-cdi-generator.service
# 按当前 nixpkgs 文档检查模块生成的 CDI；路径仍应与锁定 revision 核对
nix run nixpkgs#jq -- -r '.devices[].name' < /var/run/cdi/nvidia-container-toolkit.json
# 已安装相应工具时也可使用 nvidia-ctk cdi list
# 诊断输出（是否需权限由驱动/版本决定）：
# nvidia-ctk cdi generate --output=/tmp/nvidia-cdi-diagnostic.yaml
distrobox create --name cuda-box --image nvidia/cuda:12.4.0-devel-ubuntu22.04 \
  --additional-flags "--device nvidia.com/gpu=all --security-opt=label=disable"

NixOS 层（声明式软件与系统配置）
├── 系统核心：kernel, systemd, bootloader
├── 驱动层：GPU drivers, firmware, 硬件管理
├── DE/WM：Hyprland, waybar, rofi
├── 核心 CLI：git, fish, neovim, tmux, fzf
├── 开发语言运行时（可选）：rustup, go, python（通过 nix shell）
└── 容器运行时：podman, distrobox

Distrobox 层（可变）
├── AUR 包：yay, paru, 小众工具
├── 二进制闭源软件：微信（deepin-wine）、Teams、FPGA 工具
├── FHS 依赖的开发环境：某些嵌入式交叉编译工具链
├── 快速实验：临时测试某个工具而不污染 Nix 环境
└── 特定发行版工具：需要特定版本 glibc 或库的旧程序

# 1. 创建 Arch 容器，预装构建工具链
distrobox create --name aur-space --image archlinux:latest \
  --additional-packages "base-devel git"
distrobox enter aur-space

# 2. 在容器内安装 AUR helper
sudo pacman -Syu --needed git base-devel
git clone https://aur.archlinux.org/paru.git
cd paru
# 先审查 PKGBUILD 与下载源，再以普通 guest 用户构建
makepkg -si

# 3. 正常使用 AUR
paru -S some-aur-package

# 为需要经典 Linux 文件系统的程序创建 Ubuntu 容器
distrobox create --name fhs-runner --image ubuntu:22.04
distrobox enter fhs-runner

# 在容器内安装依赖
sudo apt update && sudo apt install -y libssl3 libgtk-3-0

# 运行宿主机的预编译二进制（通过 HOME 共享）
./some-binary-that-expects-fhs

# Python 项目 —— Fedora 有较新的 Python 版本
distrobox create --name proj-ml --image fedora:latest \
  --additional-packages "python3 python3-pip python3-devel gcc"

# Rust 项目 —— Arch 滚动更新适合 Rust 工具链
distrobox create --name proj-rust --image archlinux:latest \
  --additional-packages "rustup mold gcc"

# C/C++ 遗留项目 —— Ubuntu LTS 稳定性最好
distrobox create --name proj-legacy-cpp --image ubuntu:22.04 \
  --additional-packages "build-essential cmake gdb"

# 在容器中安装 GUI 应用
distrobox enter aur-space
paru -S freecad

# 导出 .desktop 文件到宿主机
distrobox-export --app freecad

# 宿主机上现在可以直接从启动器打开 FreeCAD
# Wayland socket 自动转发，无需额外配置

# 在 configuration.nix 中确认以下配置已存在：
users.users.user.subUidRanges = [
  { startUid = 100000; count = 65536; }
];
users.users.user.subGidRanges = [
  { startGid = 100000; count = 65536; }
];

# ~/.bashrc 或对应的 shell 配置
if [ -n "$CONTAINER_ID" ]; then
  # 在 Distrobox 容器内 —— 使用容器内路径
  export PATH="/usr/local/bin:/usr/bin:/bin:$HOME/.local/bin"
else
  # 在宿主机 —— 保持 Nix 路径
  # （此处内容不动）
fi

# 1. 确认宿主机 Wayland 环境变量
echo $WAYLAND_DISPLAY
echo $XDG_RUNTIME_DIR

# 2. 在容器内验证 Wayland socket 可见
distrobox enter your-box
ls -la $XDG_RUNTIME_DIR/$WAYLAND_DISPLAY

# 3. xeyes 验证 X11/XWayland，不单独证明原生 Wayland 通路
sudo apt install -y x11-apps
xeyes  # 应该弹出窗口

# 检查 Podman 网络
podman network ls
podman network inspect podman
# 默认 host 网络的 Distrobox 不走这个独立网络；需先检查实际 NetworkMode

# 确保 NixOS 配置中 DNS 已启用
# configuration.nix:
#   virtualisation.podman.defaultNetwork.settings.dns_enabled = true;

# 备选方案：手动挂载 NVIDIA 库
distrobox create --name nvidia-box --image ubuntu:22.04 \
  --additional-flags "
    --device /dev/nvidia0
    --device /dev/nvidiactl
    --device /dev/nvidia-modeset
    --device /dev/nvidia-uvm
    --volume /run/opengl-driver:/run/opengl-driver:ro
  "

# 在容器内
export LD_LIBRARY_PATH=/run/opengl-driver/lib:$LD_LIBRARY_PATH