Monero 可复现构建环境搭建:GNU Guix 安装、配置与故障排查完全指南
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打包)help2manpo4atexinfo
构建系统工具:
g++(需支持 C++11)libtoolautoconfautomakepkg-config(有时名为pkgconf)makecmake
杂项:
gitgnupgpython3
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,本节不适用:
- shell 安装脚本;
- fanquake 的 Docker 镜像;
- 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 检查一切是否正常
如果你完整走完了以上所有步骤,可以用下面这份检查清单确认环境是否"整洁规范":
-
/etc/profile.d/guix.sh应存在,并在每次 shell 登录时被 source; -
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 -
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:临时把系统时钟拨回去
基本步骤:
- 关闭 NTP;
- 把系统时间设为 2020-10-01;
- 执行
guix build --no-substitutes /gnu/store/vhphki5sg9xkdhh2pbc8gi6vhpfzryf0-gnutls-3.6.12.drv; - 把系统时间改回正确时间;
- 重新开启 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 并重来:
-
卸载 Guix 本体,按你当初的安装方式执行(例如 Ubuntu 包装对应
sudo apt purge guix,源码安装对应sudo make uninstall)。 -
移除所有构建用户与组
用以下命令检查相关用户与组:
getent passwd | grep guix getent group | grep guix然后移除:
sudo userdel <user> sudo groupdel <group> -
删除所有可能的 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"还是"全部从零构建"的关键一步。