部署NixOS虚拟机：从GitLab导入配置触发无限递归错误求助

问题根源 #

你在configuration.nix的let块中使用了pkgs.fetchFromGitLab，但pkgs是NixOS模块系统的参数——模块系统需要先解析所有imports完成配置构建，才能确定pkgs的最终值；而你的imports又依赖pkgs拉取仓库，形成了循环依赖，直接触发无限递归错误。

这也是为什么填入不存在的参数也会报错：递归错误发生在仓库拉取之前，模块系统还没执行到拉取步骤就已崩溃。

对比官方示例中的fetchTarball，它是Nix的内置函数，不依赖pkgs参数，能在模块解析早期完成求值，因此不会触发递归。

解决办法 #

改用不依赖pkgs的拉取函数，比如Nix内置的builtins.fetchGit，或者lib库提供的fetchFromGitLab：

方案1：使用lib.fetchFromGitLab #

{ lib, ... }:
let
  repo = lib.fetchFromGitLab { 
    owner = "hectorj"; 
    repo = "nix-fleet";
    rev = "你的仓库提交哈希"; # 必填，指定拉取的版本
    sha256 = "提前计算的仓库内容哈希值"; # 必填，用于校验
    accessToken = builtins.getEnv "GITLAB_ACCESS_TOKEN"; # 私有仓库需提供访问令牌，建议用环境变量读取
  };
in {
  imports = [
    ./hardware-configuration.nix
    "${repo}/my-server-name/host.nix"
  ];
}

方案2：使用builtins.fetchGit #

{ ... }:
let
  repo = builtins.fetchGit {
    url = "https://oauth2:${builtins.getEnv "GITLAB_ACCESS_TOKEN"}@gitlab.com/hectorj/nix-fleet.git"; # 私有仓库需带凭证的URL
    rev = "你的仓库提交哈希";
    sha256 = "提前计算的仓库内容哈希值";
  };
in {
  imports = [
    ./hardware-configuration.nix
    "${repo}/my-server-name/host.nix"
  ];
}

关键注意事项 #

• rev和sha256是必填项：Nix需要明确的版本标识和校验值，避免非确定性构建。你可以用nix-prefetch-git命令提前计算这些值。
• 私有仓库认证：不要把明文访问令牌写入配置，优先用环境变量或Nix Secrets管理凭证，避免泄露风险。

内容的提问来源于stack exchange，提问作者HectorJ