joshuachp/nixos

NixOS (Flakes Enabled) Docker镜像文档

镜像概述

本镜像基于NixOS Linux发行版构建，已预先启用Nix Flakes功能。NixOS是一款基于Nix包管理器的Linux系统，以原子化包管理、声明式配置和环境可复现性为核心特性。Flakes是Nix的实验性功能（现已广泛应用），提供了标准化的项目结构、依赖锁定机制和更好的命令行体验，解决了传统Nix配置中依赖管理复杂、可移植性不足的问题。

核心功能与特性

1. Flakes原生支持

• 已启用Nix Flakes功能，无需额外配置即可使用nix flake命令
• 支持通过flake.nix定义项目结构、依赖和构建流程
• 自动生成并使用flake.lock锁定依赖版本，确保环境一致性

2. 声明式配置管理

• 系统和应用配置通过Nix表达式（NixOS模块）声明式定义
• 配置变更可通过Nix命令原子化应用，支持版本控制和回滚
• 避免传统配置文件分散导致的管理混乱

3. 依赖隔离与原子化管理

• 基于Nix包管理器的原子化安装机制，所有依赖独立存储
• 不同项目可使用不同版本依赖，彻底消除"依赖地狱"问题
• 无用依赖可安全清理，不残留系统垃圾

4. 环境可复现性

• 通过flake.lock精确锁定所有依赖版本（包括Nixpkgs提交哈希）
• 跨设备、跨平台（Linux/macOS）一致的构建和运行结果
• 支持增量构建，仅重新编译变更的依赖和代码

5. 轻量级基础

• 基于NixOS最小化镜像构建，去除不必要组件
• 镜像体积优化，减少容器启动时间和资源占用
• 支持多架构（x86_64、aarch64等）

使用场景与适用范围

开发环境搭建

• 为项目提供隔离、一致的依赖环境，避免"在我机器上能运行"问题
• 快速切换不同项目的依赖版本（如不同Python/Node.js版本）
• 结合IDE远程开发功能，实现本地编辑、容器内运行调试

CI/CD流程集成

• 作为CI构建环境，确保构建结果与开发环境一致
• 自动化测试环境部署，通过Flakes配置快速拉起测试依赖
• 集成到Git工作流，通过flake.nix定义构建步骤，实现"代码即配置"

系统原型验证

• 快速验证NixOS系统配置（如服务部署、网络策略）
• 测试Flakes项目结构和依赖管理逻辑
• 学习Nix和NixOS的实验平台

生产环境部署

• 作为微服务基础镜像，提供稳定、可复现的运行环境
• 结合Nix的安全特性（最小权限、只读文件系统）增强容器安全性
• 支持通过Flakes动态更新应用配置，无需重建镜像

使用方法与配置说明

基本使用

启动交互式容器（默认进入bash shell）：

bash
docker run -it --rm docker.xuanyuan.run/nixos/nix:flakes-enabled

验证Flakes功能是否启用：

bash
nix flake --help  # 若输出帮助信息则表示Flakes已启用

挂载本地Flakes项目

将宿主机的Flakes项目目录挂载到容器中使用：

bash
# 假设宿主机当前目录包含flake.nix和flake.lock
docker run -it --rm -v $(pwd):/workspace docker.xuanyuan.run/nixos/nix:flakes-enabled sh -c "cd /workspace && nix flake show"

构建项目

在容器内构建Flakes项目（以Python应用为例）：

bash
# 假设flake.nix中定义了"packages.x86_64-linux.myapp"构建目标
docker run -it --rm -v $(pwd):/workspace docker.xuanyuan.run/nixos/nix:flakes-enabled sh -c "cd /workspace && nix build .#myapp"

构建产物将输出到宿主机当前目录的result符号链接下。

运行开发环境

通过nix develop进入项目开发环境（包含所有依赖）：

bash
docker run -it --rm -v $(pwd):/workspace docker.xuanyuan.run/nixos/nix:flakes-enabled sh -c "cd /workspace && nix develop"

Docker部署示例

基本运行示例

bash
# 启动容器并持久化Nix存储（避免重复下载依赖）
docker run -it --name nix-flakes-dev \
  -v nix-store:/nix/store \
  -v $(pwd):/project \
  docker.xuanyuan.run/nixos/nix:flakes-enabled

docker-compose配置示例

yaml
version: '3.8'
services:
  nix-dev:
    image: docker.xuanyuan.run/nixos/nix:flakes-enabled
    volumes:
      - ./:/project:rw  # 挂载项目目录
      - nix-store:/nix/store  # 持久化Nix存储
      - nix-config:/etc/nix  # 持久化Nix配置
    working_dir: /project
    tty: true
    stdin_open: true

volumes:
  nix-store:  # 存储Nix包和依赖
  nix-config:  # 存储Nix配置文件

配置参数与环境变量

常用环境变量

自定义Nix配置

如需修改Nix配置（如启用更多实验性功能），可通过挂载配置文件实现：

bash
docker run -it --rm \
  -v $(pwd)/nix.conf:/etc/nix/nix.conf \
  docker.xuanyuan.run/nixos/nix:flakes-enabled

示例nix.conf内容：

ini
experimental-features = nix-command flakes ca-references
build-users-group = root
sandbox = true

注意事项

• Flakes功能仍标记为"实验性"，但已在Nix 2.4+版本中稳定可用
• 首次运行会下载Nixpkgs和基础依赖，可能需要较长时间（可通过持久化/nix/store加速后续使用）
• 容器内默认以root用户运行，生产环境建议创建非特权用户并限制权限
• 如需使用Docker Buildx构建多架构镜像，需确保基础镜像支持对应架构
• 宿主机与容器的文件系统权限可能存在差异，挂载目录时建议设置适当的UID/GID映射