Monero 可复现构建环境搭建:GNU Guix 安装、配置与故障排查完全指南

原创2026-09-23 17:51:131,452 阅读
文章标签:区块链金融科技

Monero 可复现构建环境搭建:GNU Guix 安装、配置与故障排查完全指南

导读

Monero 通过 contrib/guix 目录实现"可引导构建"(Bootstrappable Builds),以 GNU Guix 这一函数式包管理器构建完整工具链,从而对二进制产物进行审计与复现,而非盲信预编译下载。本指南以 contrib/guix/INSTALL.md 为骨架,完整讲解在 Monero 构建机上首次安装并配置 Guix 的全部路径:官方 shell 安装脚本、官方二进制 tarball,以及从源码自行编译 Guix。读完本文,你将掌握三种安装方式的取舍、Guix 依赖的构建与混用技巧、guix-daemon 服务的正确配置、guix pull 后环境的切换方法,以及构建失败时的系统化排障思路,为后续执行 ./contrib/guix/guix-build 复现 Monero 二进制打好基础。

说明:Guix 的安装与配置每台机器只需执行一次。若你的机器已完成安装,可直接进入 contrib/guix/README.md 的 Usage 章节执行构建。


一、为什么 Monero 的二进制构建需要 Guix

在 Monero 仓库中,contrib/guix/README.md 明确阐述了这一设计动机:可引导性(Bootstrappability) 进一步加强了项目的二进制安全保证——允许开发者审计并复现自己的工具链,而不是盲目信任二进制下载。Monero 通过将 Guix 作为函数式包管理器来实现这一点:每个包的构建被表述为一个无副作用的"派生"(derivation),同一输入必然得到逐位一致的输出。

INSTALL.md 在整个工作流中的角色是"前奏":它只负责把 Guix 本身安装好、把 guix-daemon 跑起来,构建 Monero 的具体操作则由同目录下的 guix-build 脚本(见 README.md)完成。

在开始之前,请先确认硬件条件(同样来自 contrib/guix/README.md):

  • 一台 x86_64 机器;
  • /gnu/store 所在分区至少 16GB 空闲磁盘空间;
  • 每计划构建一个平台三元组(platform triple,见 HOSTS 环境变量),额外需要 8GB 空闲空间。

例如默认构建 8 个平台三元组时,磁盘需求约为 16GB + 8×8GB = 80GB 起步。


二、三种安装路径:如何选择

INSTALL.md 提供了三种安装 Guix 的方式,先明确各自特点再动手,可以避免后续返工:

特性 ① 官方 shell 安装脚本 ② 官方二进制 tarball ③ 从源码编译
维护方 Guix 开发者 Guix 开发者 你自己
难度 最易(自动完成大部分设置) 普通(需完整手动配置) 困难但值得
发行版兼容性 几乎覆盖所有 Linux 发行版 几乎覆盖所有 Linux 发行版 大多数 Linux 发行版可用
可安装版本 仅最新发布版 任意发布版 任意 commit(更细粒度)
安装性质 仅二进制,需要较高信任度 仅二进制,需要较高信任度 源码安装,信任度要求更低
前置条件 脚本需以 root 运行,运行前应先行检查脚本内容 无 见下文"从源码构建"章节

三条路径的详细步骤分别对应下文第三、四、五章。


三、路径一/二:官方 shell 安装脚本与二进制 tarball

官方 shell 安装脚本与二进制 tarball 的安装指令,均收录于 GNU Guix 官方手册的 "Binary Installation"(二进制安装)章节。文档特别指出:

  • 手动走完二进制 tarball 的安装步骤,在效果上等价于 shell 安装脚本所做工作的手工版;
  • 截至文档写作时间(2021 年 7 月 5 日),shell 安装脚本会自动创建一个 /etc/profile.d 条目,而二进制 tarball 的官方安装说明不会要求你创建该条目。但为了更好的桌面集成,你很可能仍然需要这个条目——如何手工添加 /etc/profile.d/guix.sh 见 第六章 6.1 节。

无论采用哪种方式,对 /etc/profile.d 的改动都要等到下一次 shell 或桌面会话才会生效,因此修改后请注销并重新登录。


四、路径三:从源码构建 Guix

从源码构建 Guix 是一个相当繁琐、但回报丰厚的过程,尤其适合希望最小化信任、最大化可定制性的开发者(例如构建 Guix 的某个特定 commit)。有 autotools 风格构建系统使用经验会很有帮助。文档作者强烈建议:在开始敲命令前,先把本小节完整通读一遍,能省去大量不必要的痛苦。

4.1 安装通用构建工具

以下基础工具是后续几乎所有构建环节都需要的,先统一安装:

文本转换 / i18n:

  • autopoint(有时随 gettext 打包)
  • help2man
  • po4a
  • texinfo

构建系统工具:

  • g++(需支持 C++11)
  • libtool
  • autoconf
  • automake
  • pkg-config(有时名为 pkgconf)
  • make
  • cmake

杂项:

  • git
  • gnupg
  • python3

4.2 构建 Guix 的依赖

在从源码构建 Guix 本体之前,需要确保其依赖已安装且可被发现。最新最权威的依赖清单以 GNU Guix 参考手册的 "Requirements"(依赖要求)章节为准。好消息是:根据发行版不同,大部分甚至全部依赖可能已经打包,无需手工编译安装。

4.2.1 快速路径:直接安装发行版的 Guix 构建依赖

如果你不关心逐个源码构建依赖,且你的发行版已经打包了 Guix,那么只需安装 Guix 的构建依赖即可。以 Ubuntu/Debian 为例,启用 deb-src 源并安装:

sed -i 's|# deb-src|deb-src|g' /etc/apt/sources.list
apt update
apt-get build-dep -y guix

如果这一步成功,你很可能可以直接跳到 4.3 节"构建并安装 Guix 本体"。

4.2.2 Guile

Guix 本身以 Guile(Scheme 方言)编写,Guile 是其运行时基础。

边界情况:一个系统上存在多个 Guile 版本

建议只安装所需版本的 Guile,以免构建系统在"该用哪个 Guile"上产生混淆。如果你坚持安装多个版本,那么必须一致地在 Guix 及其依赖的所有 ./configure 调用中指定 GUILE_EFFECTIVE_VERSION=3.0。

安装 Guile

如果你的发行版把包拆分为带 -dev 后缀和不带 -dev 后缀的子包(Debian 系发行版如此),请务必两个都装。例如在 Debian/Ubuntu 上安装 Guile v3.0:

apt install guile-3.0 guile-3.0-dev

4.2.3 混用发行版包与源码编译包

截至文档写作时,多数发行版只打包了部分 Guix 依赖,这意味着你很可能要"发行版包装一部分、源码编译一部分"。

这里有个关键陷阱:发行版包通常安装到 /usr,而源码编译包 ./configure 的默认前缀是 /usr/local。因此,如果你混用两类包,又没有对源码包显式指定 --prefix=/usr,就必须通过环境变量 GUILE_LOAD_PATH 与 GUILE_LOAD_COMPILED_PATH 让 Guile 到正确的前缀下去寻找源码编译的包。

以 Guile v3.0、包位于 /usr/local 前缀为例,将以下内容加入 ~/.profile 或 ~/.bash_profile(对所有未来的登录 shell 生效),或在当前 POSIX shell 中直接粘贴(仅临时修改当前会话):

# Help Guile v3.0.x find packages in /usr/local
export GUILE_LOAD_PATH="/usr/local/share/guile/site/3.0${GUILE_LOAD_PATH:+:}$GUILE_LOAD_PATH"
export GUILE_LOAD_COMPILED_PATH="/usr/local/lib/guile/3.0/site-ccache${GUILE_LOAD_COMPILED_PATH:+:}$GUILE_COMPILED_LOAD_PATH"

注意:./configure 阶段就会用这两个环境变量来探测包,所以若想使用 /usr 以外的前缀,应尽早设置它们。

4.2.4 源码编译包的通用构建流程

重要:有少数依赖存在不直观的怪癖/勘误,已记录在下面的小节中。在动手编译这些包之前请先阅读对应小节。

虽然应以各依赖自带的 README / INSTALL 文件为准,但大多数依赖采用 autoconf 风格构建系统(检查仓库根目录是否存在 configure.ac),按以下流程通常不会出错。

克隆仓库并检出最新发布版:

git clone <git-repo-of-dependency>/<dependency>.git
cd <dependency>
git tag -l  # 查看最新发布版
git checkout <latest-release>

autoconf 风格(仓库根目录存在 ./autogen.sh 或 configure.ac):

./autogen.sh || autoreconf -vfi
./configure --prefix=<prefix>
make
sudo make install

CMake 风格(仓库根目录存在 CMakeLists.txt):

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=<prefix>
sudo cmake --build . --target install

如果 ./configure 时没有显式指定 --prefix=/usr,请务必仔细阅读上文 4.2.3 节关于混用包的内容。

4.2.5 绑定(binding)包需要对应 -dev 包

  • 适用对象:所有人。

构建绑定包时,原包的 -dev 版本必须已安装。例如在 Debian 系发行版上构建 Guile-zlib 要求先装 zlib1g-dev。

使用绑定包时同样需要 -dev 包,这在使用打包有问题的发行版包时尤为恼人——例如 Ubuntu Focal 中的 guile-sqlite3,安装它不会自动把 libsqlite3-dev 作为依赖装上。

文档给出了当时 Debian 下相关 Guile 绑定与 -dev 包的对应关系:

Guile 绑定包 Debian 的 -dev 包
guile-gcrypt libgcrypt-dev
guile-git libgit2-dev
guile-gnutls (无)
guile-json (无)
guile-lzlib liblz-dev
guile-ssh libssh-dev
guile-sqlite3 libsqlite3-dev
guile-zlib zlib1g-dev

4.2.6 guile-git 实际依赖 libgit2 >= 1.1 的版本陷阱

  • 适用对象:从源码针对 libgit2 < 1.1 构建 guile-git 的人;以及发行版中 guile-git 基于 libgit2 < 1.1 构建的人。

自 v0.5.2 起,guile-git 声称只需要 libgit2 >= 0.28.0,但实际上需要 libgit2 >= 1.1,否则它会错误解析 origin/keyring 这样的引用:本应理解为"origin 远程的 keyring 分支",却被解释成"字面名为 origin/keyring 的分支"。

这一点尤其值得注意:Ubuntu Focal 打包的是 libgit2 v0.28.4,且其 guile-git 正是基于它构建的。若你处于这种境地,需要同时从源码构建 libgit2 v1.1.x 和 guile-git。

4.3 构建并安装 Guix 本体

首先克隆 Guix 仓库:

git clone https://codeberg.org/guix/guix.git
cd guix

通常应构建最新发布版。文档写作时(2023 年 11 月)最新发布版为 v1.4.0。查看并检出发布分支:

git branch -a -l 'origin/version-*'  # 查看最新发布版
git checkout <latest-release>

引导构建系统:

./bootstrap

按推荐的 --localstatedir 标志配置:

./configure --localstatedir=/var

注意:如果你未来打算参与 Guix 开发,所有后续 Guix 的 ./configure 调用都必须带同样的 --localstatedir= 标志(原因见 GNU Guix 参考手册 Requirements 章节的末尾段落)。

构建 Guix(耗时较长):

make -j$(nproc)

安装 Guix:

sudo make install

4.4 源码安装后的收尾

4.4.1 创建固定 argv[0] 的 guix-daemon-original 服务

此时 Guix 已安装到 ${bindir}(若 ./configure 时未覆盖目录变量,通常为 /usr/local/bin;标准 Automake 目录变量的更多信息见 GNU Automake 手册的 "Standard Directory Variables" 章节)。

但问题在于:Guix 自带的 init 脚本与服务配置(Upstart、systemd、SysV、OpenRC,位于 ${libdir})所启动的是

${localstatedir}/guix/profiles/per-user/root/current-guix/bin/guix-daemon

而该路径尚不存在,要等 root 首次执行 guix pull 之后才会出现。

因此需要创建这些 init 脚本的 -original 版本,使其指向我们刚 make install 到 ${bindir}(通常为 /usr/local/bin)的二进制。以 systemd 为例(以 root 身份执行):

# 通过修改 guix-daemon.service 创建 guix-daemon-original.service
libdir=# 根据你的 PREFIX 设置(默认是 /usr/local/lib)
bindir="$(dirname $(command -v guix-daemon))"
sed -E -e "s|/\S*/guix/profiles/per-user/root/current-guix/bin/guix-daemon|${bindir}/guix-daemon|" "${libdir}"/systemd/system/guix-daemon.service > /etc/systemd/system/guix-daemon-original.service
chmod 664 /etc/systemd/system/guix-daemon-original.service

# 让 systemd 识别新服务
systemctl daemon-reload

# 确保不可用的 guix-daemon.service 被停止并禁用
systemctl stop guix-daemon
systemctl disable guix-daemon

# 确保可用的 guix-daemon-original.service 被启动并启用
systemctl enable guix-daemon-original
systemctl start guix-daemon-original

4.4.2 创建 guix-daemon 用户与组

构建守护进程需要专用的构建用户/组。具体操作请参见 GNU Guix 参考手册的 "Build Environment Setup"(构建环境设置)章节。


五、可选的精修设置

到这一步,你已经可以 用 Guix 构建 Monero 了。但如果想让环境更"符合 Guix 的设计意图",可以继续完成以下小节。

5.1 添加 /etc/profile.d/guix.sh

如果你通过以下任一方式安装 Guix,本节不适用:

  1. shell 安装脚本;
  2. fanquake 的 Docker 镜像;
  3. Debian 的 guix 包。

背景

Guix 知道如何自我更新、更新包,但它的方式是非侵入式的(不会修改 /usr/local/bin/guix)。具体而言:

  • 执行 guix pull 后,它更新 /var/guix/profiles/per-user/$USER/current-guix,并在 $HOME/.config/guix/current 创建一个指向该目录的符号链接;
  • 执行 guix install 后,它更新 /var/guix/profiles/per-user/$USER/guix-profile,并在 $HOME/.guix-profile 创建指向它的符号链接。

为了让这些操作真正影响你的 shell/桌面会话(并符合"最少惊讶原则"),对应的目录必须被加入 $PATH、$INFOPATH、$XDG_DATA_DIRS 等众所周知的环境变量。

换句话说:如果 $HOME/.config/guix/current/bin 不在 $PATH 中,那么 guix pull 对你正在使用的 guix 毫无效果;$HOME/.guix-profile/bin 与 guix install、已装包之间的关系同理。

方便的是,guix pull 或 guix install 之后会打印类似下面的提示:

hint: Consider setting the necessary environment variables by running:

     GUIX_PROFILE="$HOME/.guix-profile"
     . "$GUIX_PROFILE/etc/profile"

Alternately, see `guix package --search-paths -p "$HOME/.guix-profile"'.

但每个想正常使用 Guix 的用户都要为 guix pull 和 guix install 各做一遍这种事,相当繁琐。文档作者建议改为向 /etc/profile.d 添加条目(Debian 包在 1.2.0-4 之后及 shell 脚本安装器都会默认这么做)。

操作步骤

创建 /etc/profile.d/guix.sh,内容如下:

# _GUIX_PROFILE: `guix pull` profile
_GUIX_PROFILE="$HOME/.config/guix/current"
if [ -L $_GUIX_PROFILE ]; then
  export PATH="$_GUIX_PROFILE/bin${PATH:+:}$PATH"
  # 导出 INFOPATH,使更新后的 info 页面可被
  # /usr/bin/info 和/或 $GUIX_PROFILE/bin/info 找到并阅读
  # 当 INFOPATH 未设置时,追加尾部冒号,使 Emacs
  # 搜索 'Info-default-directory-list'。
  export INFOPATH="$_GUIX_PROFILE/share/info:$INFOPATH"
fi

# GUIX_PROFILE: 用户的默认 profile
GUIX_PROFILE="$HOME/.guix-profile"
[ -L $GUIX_PROFILE ] || return
GUIX_LOCPATH="$GUIX_PROFILE/lib/locale"
export GUIX_PROFILE GUIX_LOCPATH

[ -f "$GUIX_PROFILE/etc/profile" ] && . "$GUIX_PROFILE/etc/profile"

# 将 Guix 安装内容加入 XDG_DATA_DIRS
export XDG_DATA_DIRS="$GUIX_PROFILE/share:${XDG_DATA_DIRS:-/usr/local/share/:/usr/share/}"

请注意:该文件同样要到下一次 shell 或桌面会话(注销重登录)才会生效。

5.2 root 执行 guix pull

动手之前,必须先阅读 选择你的安全模型 一节,并按你的选择调整 guix 与 guix-daemon 的参数——因为执行 guix pull 可能从 substitute 服务器拉取预编译包(这可能是你不想要的)。

如前所述,Guix 期望 ${localstatedir}/guix/profiles/per-user/root/current-guix 中存有 root 的 Guix profile(由某个旧版 Guix guix pull 并构建得到)。但源码安装时这个目录是空的,因此必须以 root 身份执行一次 guix pull:

sudo --login guix pull --branch=version-<latest-release-version>
# 或
sudo --login guix pull --commit=<particular-commit>

guix pull 是个相当漫长的过程(尤其是使用了 --no-substitutes 时)。若遇到构建问题,请参考 第七章 排障。

注意:裸执行 guix pull(不指定 commit 或 branch)会拉取 Guix master 分支的最新 commit,通常没问题,但不推荐。

如果是从源码安装的 Guix,可能遇到如下错误:

error: while creating symlink '/root/.config/guix/current' No such file or directory

解决方法很简单——先创建目录再重试:

sudo mkdir -p /root/.config/guix

guix pull 成功后,${localstatedir}/guix/profiles/per-user/root/current-guix 即被填充。

使用新拉取的 guix:重启 daemon

根据你的安装方式,现在应确保 init 脚本与服务配置指向新拉取的 guix-daemon。

如果你是从源码构建的 Guix

按 4.4.1 节"固定 argv[0]" 操作过的,现在可以:

systemctl stop guix-daemon-original
systemctl disable guix-daemon-original

systemctl enable guix-daemon
systemctl start guix-daemon

记得在 $libdir/systemd/system/guix-daemon.service 中设置 --no-substitutes 以及其他你在 guix-daemon-original.service 中用到过的自定义参数。

其他情况

直接:

systemctl restart guix-daemon

5.3 检查一切是否正常

如果你完整走完了以上所有步骤,可以用下面这份检查清单确认环境是否"整洁规范":

  1. /etc/profile.d/guix.sh 应存在,并在每次 shell 登录时被 source;

  2. guix describe 不应打印 guix describe: error: failed to determine origin,而应输出类似:

    Generation 38   Feb 22 2021 16:39:31    (current)
      guix f350df4
        repository URL: https://codeberg.org/guix/guix.git
        branch: version-1.2.0
        commit: f350df405fbcd5b9e27e6b6aa500da7f101f41e7
    
  3. guix-daemon 应从 ${localstatedir}/guix/profiles/per-user/root/current-guix 运行。


六、仓库侧的构建环境佐证

安装好 Guix 后,Monero 仓库本身还提供了若干支撑文件,理解了它们能让你在排障与定制构建时更有底气:

  • 固定 Guix 版本:contrib/guix/libexec/prelude.bash 中的 time-machine() 函数会以 guix time-machine --url=${GUIX_REPO:-https://codeberg.org/guix/guix.git} --commit=0c2eff26... 将构建固定到某个特定 commit,从而保证"跨时间可复现";它还会把 --cores="$JOBS"、SUBSTITUTE_URLS、ADDITIONAL_GUIX_COMMON_FLAGS 等透传给所有 guix 命令。这些环境变量的完整说明见 README.md 的 Recognized environment variables 小节。
  • 构建容器内的包清单:contrib/guix/manifest.scm 声明了构建容器内所需的包(如 bash、coreutils-minimal、gnu-make、cmake-minimal、rust、git-minimal 等),并针对 -mingw32、-linux-gnu、freebsd、android、darwin 等目标平台按需追加交叉工具链(含 contrib/guix/patches 下的 gcc-remap-guix-store.patch、glibc 系列补丁等)。这与本文 4.2 节"构建 Guix 依赖"的思想一脉相承——全部依赖要么来自发行版,要么由 Guix 自身以受控方式构建。
  • 构建与清理:构建由 ./contrib/guix/guix-build 触发(详见 README.md);contrib/guix/guix-clean 会以 git clean -xdff 清理工作树中的中间产物(depends/work、guix-build-*/distsrc-* 等),同时通过读取各次构建留下的 precious_dirs 文件,避免误删 SOURCES_PATH、BASE_CACHE 等"珍贵目录"。
  • 背书与验证:构建产物可通过 guix-attest 进行 GPG 背书、用 guix-verify 交叉验证其他签名者的背书,相关命令见 README.md。

七、故障排查手册

7.1 Derivation failed to build

当你看到类似下面的构建失败输出:

building /gnu/store/...-foo-3.6.12.drv...
/ 'check' phasenote: keeping build directory `/tmp/guix-build-foo-3.6.12.drv-0'
builder for `/gnu/store/...-foo-3.6.12.drv' failed with exit code 1
build of /gnu/store/...-foo-3.6.12.drv failed
View build log at '/var/log/guix/drvs/../...-foo-3.6.12.drv.bz2'.
cannot build derivation `/gnu/store/...-qux-7.69.1.drv': 1 dependencies couldn't be built
cannot build derivation `/gnu/store/...-bar-3.16.5.drv': 1 dependencies couldn't be built
cannot build derivation `/gnu/store/...-baz-2.0.5.drv': 1 dependencies couldn't be built
guix time-machine: error: build of `/gnu/store/...-baz-2.0.5.drv' failed

它表示 guix 构建名为 foo 的包失败,而该包是 qux、bar、baz 的依赖。关键认知:最后一行 "failed" 不一定是根因,第一个 "failed" 行才是。

大多数情况下,构建失败源于偶发的测试失败,或包的构建系统/测试套件在多线程下崩溃。若要仅以单线程方式重建该派生(别忘了按需追加 --no-substitutes 等其他 guix 标志):

$ guix build --cores=1 /gnu/store/...-foo-3.6.12.drv

若单线程重建仍未成功,就需要深入排查。可以用 less 查看 foo 的构建日志(请把路径替换为构建失败输出中给出的实际路径):

$ bzcat /var/log/guix/drvs/../...-foo-3.6.12.drv.bz2 | less

foo 的构建目录也被保留在 /tmp/guix-build-foo-3.6.12.drv-0。不过,如果 foo 构建失败多次,目录可能是 /tmp/...drv-1、/tmp/...drv-2。始终以构建失败输出中的信息为准。

7.2 python(-minimal): [Errno 84] Invalid or incomplete multibyte or wide character

该错误发生在你的 $TMPDIR(默认为 /tmp)位于一个拒绝 UTF-8 字符集以外字符的文件系统上时。典型例子:开启了 utf8only=on 选项的 ZFS。

7.3 openssl-1.1.1l 与 openssl-1.1.1n

OpenSSL 包含一些一旦某个证书过期就会失败的测试。可直接套用下面 GnuTLS 小节中的 workaround 方法。

7.4 GnuTLS: test-suite FAIL: status-request-revoked

该派生通常标识为:/gnu/store/vhphki5sg9xkdhh2pbc8gi6vhpfzryf0-gnutls-3.6.12.drv

这个不幸的错误最常见于不使用 substitute 且安装了 Guix v1.2.0 的构建者。问题根源是 GnuTLS 的某个测试使用了硬编码的证书,已于 2020-10-24 过期。

更麻烦的是,这个 GnuTLS 派生在 Guix 依赖图中比较特殊,不受 --without-tests= 这类包变换标志的影响。

最容易的解决办法是安装更新版本的 Guix。此外还有三个 workaround:

Workaround 1:仅为该单一派生使用 substitutes

如果你已授权官方 Guix 构建农场的密钥(方法见 README.md 的 Step 1: Authorize the signing keys),则可以仅为这一个派生启用 substitutes:

guix build --substitute-urls="https://ci.guix.gnu.org" /gnu/store/vhphki5sg9xkdhh2pbc8gi6vhpfzryf0-gnutls-3.6.12.drv

如果你不想保留构建农场密钥的授权,可参考 README.md 的 Removing authorized keys 小节 移除。

Workaround 2:临时把系统时钟拨回去

基本步骤:

  1. 关闭 NTP;
  2. 把系统时间设为 2020-10-01;
  3. 执行 guix build --no-substitutes /gnu/store/vhphki5sg9xkdhh2pbc8gi6vhpfzryf0-gnutls-3.6.12.drv;
  4. 把系统时间改回正确时间;
  5. 重新开启 NTP。

例如:

sudo timedatectl set-ntp no
sudo date --set "01 oct 2020 15:00:00"
guix build /gnu/store/vhphki5sg9xkdhh2pbc8gi6vhpfzryf0-gnutls-3.6.12.drv
sudo timedatectl set-ntp yes

Workaround 3:在 Guix 源码中禁用该单一派生的测试

如果以上 workaround 都失效,还可以通过 arguments 选项禁用该派生的 tests phase(方法见 GNU Guix 官方手册的 package 参考)。例如禁用 openssl-1.1 的 check phase:

diff --git a/gnu/packages/tls.scm b/gnu/packages/tls.scm
index f1e844b..1077c4b 100644
--- a/gnu/packages/tls.scm
+++ b/gnu/packages/tls.scm
@@ -494,4 +494,5 @@ (define-public openssl-1.1
     (arguments
      `(#:parallel-tests? #f
+       #:tests? #f
        #:test-target "test"

7.5 coreutils: FAIL: tests/tail-2/inotify-dir-recreate

inotify-dir-create 测试在 overlayfs(Docker 的默认文件系统)等"远程"文件系统上会失败,因为该文件系统被误判为非远程。

一个相对简单的 workaround:确保在 /tmp(guix-daemon 执行构建的位置)挂载较为传统的文件系统。对 Docker 用户而言,这意味着使用卷(volume)、从宿主机绑定挂载,或(内存与交换空间充足时)使用 --tmpfs 标志挂载 tmpfs。


八、卸载与彻底清理 Guix

在极少数把 Guix 安装弄到不可挽回的情况下,你可能想彻底清除 Guix 并重来:

  1. 卸载 Guix 本体,按你当初的安装方式执行(例如 Ubuntu 包装对应 sudo apt purge guix,源码安装对应 sudo make uninstall)。

  2. 移除所有构建用户与组

    用以下命令检查相关用户与组:

    getent passwd | grep guix
    getent group | grep guix
    

    然后移除:

    sudo userdel <user>
    sudo groupdel <group>
    
  3. 删除所有可能的 Guix 相关目录

    • /var/guix/
    • /var/log/guix/
    • /gnu/
    • /etc/guix/
    • /home/*/.config/guix/
    • /home/*/.cache/guix/
    • /home/*/.guix-profile/
    • /root/.config/guix/
    • /root/.cache/guix/
    • /root/.guix-profile/

九、下一步:开始可复现构建

Guix 就绪后,回到 Monero 仓库顶层执行:

./contrib/guix/guix-build

即可按默认配置对所有支持的平台三元组进行可复现构建。更详细的用法(HOSTS 选择目标平台、SOURCES_PATH/BASE_CACHE 外置缓存、JOBS 与 --max-jobs 并发控制、SOURCE_DATE_EPOCH 时间戳固定、--no-substitutes 安全模型选择等)请继续阅读 contrib/guix/README.md,并在构建前认真思考 你的安全模型——这是决定"信任预编译 substitute"还是"全部从零构建"的关键一步。

登录后查看全文
monero