quadlet-nix 的安装和配置教程

2025-05-18 16:54:20作者：卓艾滢Kingsley

项目基础介绍

quadlet-nix 是一个开源项目，用于在 NixOS 上管理 Podman 容器、网络等，通过 Quadlet 提供功能支持。它旨在简化容器和网络的配置与管理。该项目主要使用 Nix 语言进行开发。

项目使用的关键技术和框架

Nix: 一种功能强大的包管理器和配置管理工具，用于定义系统的配置和安装包。
Podman: 一个用于运行容器的高级工具，与 Docker 类似，但不需要守护进程。
Quadlet: 用于定义和管理容器化应用的配置文件。

项目安装和配置的准备工作

在开始安装 quadlet-nix 之前，请确保您的系统满足以下要求：

操作系统: NixOS
Nix 版本: 建议使用最新版本的 Nix
网络连接: 安装过程中需要访问网络以获取必要的包和依赖

安装步骤

安装 Nix (如果尚未安装)

如果您的系统中还没有安装 Nix，您可以从 Nix 官方网站下载安装脚本并运行。
```
curl -L https://nixos.org/install | sh
```
安装脚本会引导您完成安装过程。
添加 Nix channel

添加 NixOS 的 unstable channel，这将确保您拥有最新的包和更新。
```
nix-channel --add https://nixos.org/channels/nixos-unstable
nixos-rebuild switch
```
克隆 quadlet-nix 仓库

使用 Git 克隆 quadlet-nix 项目仓库到本地。
```
git clone https://github.com/SEIAROTg/quadlet-nix.git
cd quadlet-nix
```
安装依赖

在 Nix 环境中，使用以下命令安装 quadlet-nix 的依赖。
```
nix-env -iA nixpkgs.quadlet-nix
```

配置 quadlet-nix

根据您的需求，编辑 configuration.nix 文件来配置 quadlet-nix。以下是一个基础配置示例：

{ config, ... }:

{
  virtualisation.quadlet.containers = {
    my-nginx = {
      containerConfig.image = "docker.io/library/nginx:latest";
      serviceConfig.TimeoutStartSec = "60";
    };
  };
  virtualisation.quadlet.networks = {
    internal = {
      networkConfig.subnets = ["10.0.123.1/24"];
    };
  };
  virtualisation.quadlet.pods = {
    my-pod = {};
  };
}