Skip to content
Search AlmaLinux

This page uses Chinese content. Search opens the Chinese documentation.

    Browse this documentation

    AlmaLinux 10 的 GPG 验证体系:密钥环、两层校验与手动验签闭环实测

    This content is not available in your language yet.

    在 almalinux:10 容器(aarch64;10.2 Lavender Lion,rpm-4.19.1.1-23.el10.alma.1、dnf-4.20.0-22.el10_2.alma.1,2026-10-31)中实际执行:rpm 密钥环清单与密钥详情核对、dnf 两层 GPG 校验的配置取证与 repo_gpgcheck 阴阳对照实验、密钥删除/重新导入闭环、以及一次带篡改阴性对照的手动 GPG 验签。原始日志:plans/content-expansion/evidence/logs/alma-gpg-key-verify.log(sha256 dc8ee73961259db19677751b4a5d62cb224e97413313fd45ad6b0d811c6b12d1,## step 分段)。

    实验顺序刻意按「先启用正确 GPG key,再做验证」执行:repo_gpgcheck 对照先测错误代际密钥(阴性,rc=1)再测官方密钥(阳性,rc=0),两组是独立的 dnf 调用;手动验签先 gpg --import 再 gpg --verify。这个顺序不是形式——原因见下文两层校验一节。

    本页没有实测:rpm -K / rpmkeys -Kv 包级验签(日志仅有命令存在性记录)、第三方仓库密钥管理与吊销、密钥过期轮换、GPG Web of Trust 的 trust 管理。相关段落标注「文献口径」。

    rpm 的 GPG 密钥体系:gpg-pubkey 与指纹核对(实测)

    Section titled “rpm 的 GPG 密钥体系:gpg-pubkey 与指纹核对(实测)”

    rpm 把公钥当作一种特殊包管理,包名固定为 gpg-pubkey,version 是指纹末 8 位的短 id,release 是导入时间戳。查已导入的密钥清单:

    Terminal window
    $ rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\t%{SUMMARY}\n'
    gpg-pubkey-c2a1e572-668fe8ef AlmaLinux OS 10 <[email protected]> public key
    $ ls /etc/pki/rpm-gpg/
    RPM-GPG-KEY-AlmaLinux-10

    这台容器刚装好,密钥环里恰好一把官方密钥,密钥文件也只有一个。看完整信息(日志 step2):

    Terminal window
    $ rpm -qi gpg-pubkey-c2a1e572-668fe8ef
    Name : gpg-pubkey
    Version : c2a1e572
    Release : 668fe8ef
    ...
    Group : Public Keys
    Size : 0
    License : pubkey
    Build Date : Thu Jul 11 14:15:11 2024

    密钥本身是一段 ASCII armor 文本,就完整放在 rpm -qi 的描述字段里。要核对指纹,用 gpg --show-keys 读密钥文件(日志 step2 实测):

    Terminal window
    $ gpg --show-keys /etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-10
    pub rsa4096 2024-07-11 [SC]
    EE6DB7B98F5BF5EDD9DA0DE5DEE5C11CC2A1E572
    uid AlmaLinux OS 10 <[email protected]>

    EE6D…E572 的末 8 位 c2a1e572 正是 rpm 短 id——两种工具读到的密钥是同一把。这个指纹是后续所有验证的锚点:官方 wiki、repo 文件、ISO 清单签名用的是同一密钥代际(AlmaLinux 10)。

    一个容易踩的坑:容器默认没有装 gnupg2(rpm -q gnupg2 报 not installed),gpg --show-keys、gpg --import、gpg --verify 都需要先 dnf install -y gnupg2(实测装到 gnupg2-2.4.5-4.el10_1)。rpm 自身的密钥管理(rpm -q gpg-pubkey、rpm --import)不依赖它。

    dnf 的两层 GPG 校验:gpgcheck 与 repo_gpgcheck(实测对照)

    Section titled “dnf 的两层 GPG 校验:gpgcheck 与 repo_gpgcheck(实测对照)”

    dnf 有两个独立的 GPG 开关,管的不是同一层:

    开关校验对象官方默认
    gpgcheck=1包:下载的每个 rpm 的包签名21 处全开(7 个 repo 文件)
    repo_gpgcheck=1元数据:repomd.xml 索引的签名一处都没写(=默认 0,不校验)

    两个开关都依赖 repo 文件里的 gpgkey= 指路——官方 repo 用 file:///etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-10 落盘文件。配置取证(日志 step3):

    Terminal window
    $ grep -R "repo_gpgcheck" /etc/yum.repos.d/ || echo "(没有任何 repo_gpgcheck 行)"
    (7 个 repo 文件中没有任何 repo_gpgcheck 行)
    $ grep -h "gpgcheck" /etc/yum.repos.d/*.repo | sort | uniq -c
    21 gpgcheck=1

    也就是说 AlmaLinux 10 官方源默认校验包签名、不校验元数据签名。另外实测发现 dnf4 的 dnf repoinfo -v 输出里没有任何 gpg 字段(grep 不到 gpg),想知道某仓库两层开关的状态,只能读 repo 文件本身,repolist -v 帮不上忙。

    repo_gpgcheck=1 打开后 dnf 会对 repomd.xml 验签。用 --setopt 做一组阴阳对照(日志 step3,两组为独立 dnf 调用,先错 key 后对 key——每次都从「密钥就位」开始):

    Terminal window
    # 阴性对照:错误代际密钥(AlmaLinux 9 的 key)
    $ dnf -q --assumeyes --setopt=baseos.repo_gpgcheck=1 \
    --setopt=baseos.gpgkey=https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux-9 \
    repoinfo baseos >/tmp/pgc-neg.out 2>&1; echo rc=$?
    rc=1
    Error: Failed to download metadata for repo 'baseos':
    repomd.xml GPG signature verification error: Signing key not found
    # 阳性对照:官方 10 密钥(repo 文件默认的 file:/// 路径)
    $ dnf -q --assumeyes --setopt=baseos.repo_gpgcheck=1 repoinfo baseos >/tmp/pgc-pos.out 2>&1; echo rc=$?
    rc=0
    Importing GPG key 0xC2A1E572:
    Fingerprint: EE6D B7B9 8F5B F5ED D9DA 0DE5 DEE5 C11C C2A1 E572

    两个细节值得注意:其一,gpgkey 允许直接写 https URL,dnf 会现场下载并提示导入指纹(阴性组里的 0xB86B3716 就是 9 代密钥被导入了,但元数据签名对不上,仍然失败);其二,顺序重要——dnf 对已通过校验的元数据有缓存,如果先配错 key 跑过一遍、再改对重跑,dnf 可能直接用缓存而不重新验签,一个「rc=0」就不再是真实的验证结果。本页实验的阳性结论只从「密钥先就位」的干净调用中取得。

    密钥生命周期:删除与重新导入(实测)

    Section titled “密钥生命周期:删除与重新导入(实测)”

    rpm 4.19 起推荐用 rpmkeys 子命令管理密钥,rpmkeys --help(日志 step4 实测)列出全部入口:-K/--checksig(验包签名)、-i/--import(导入)、-t/--test(只测试不导入)、-d/--delete 与 -e/--erase(删除)。传统的 rpm --import / rpm -e 写法与之等价,本页实测用的就是后者:

    Terminal window
    $ rpm -e gpg-pubkey-c2a1e572-668fe8ef; echo rc=$?
    rc=0
    $ rpm -q gpg-pubkey; echo rc=$?
    package gpg-pubkey is not installed
    rc=1
    $ rpm --import https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux-10; echo rc=$?
    rc=0
    $ rpm -q gpg-pubkey --qf '%{NAME}-%{VERSION}-%{RELEASE}\n'
    c2a1e572-668fe8ef

    删掉再从官方 URL 导回,短 id 不变(c2a1e572-668fe8ef),rpm -qi 的 Install Date 更新为本次导入时间。结论:密钥的增删是普通包操作,gpg-pubkey 也能进 dnf history 的事务记录里。清理一把不再需要的第三方密钥(比如换源后遗留的旧 key),就是 rpm -e gpg-pubkey-<短id>。

    手动 GPG 验证闭环:CHECKSUM 验签与篡改对照(实测)

    Section titled “手动 GPG 验证闭环:CHECKSUM 验签与篡改对照(实测)”

    ISO 镜像不走 dnf,它附带的 CHECKSUM 文件是 PGP 签名消息,需要 GnuPG 手工验证。日志 step5 在 /tmp/gpgdemo 完整走了一遍正确顺序的闭环(先导入密钥,再验签):

    Terminal window
    $ mkdir -p /tmp/gpgdemo && cd /tmp/gpgdemo
    $ curl -fsSLO https://repo.almalinux.org/almalinux/10/isos/aarch64/CHECKSUM
    $ curl -fsSLO https://repo.almalinux.org/almalinux/RPM-GPG-KEY-AlmaLinux-10
    $ gpg --import RPM-GPG-KEY-AlmaLinux-10
    gpg: key DEE5C11CC2A1E572: public key "AlmaLinux OS 10 <[email protected]>" imported
    $ gpg --verify CHECKSUM; echo rc=$?
    gpg: using RSA key EE6DB7B98F5BF5EDD9DA0DE5DEE5C11CC2A1E572
    gpg: Good signature from "AlmaLinux OS 10 <[email protected]>" [unknown]
    gpg: WARNING: This key is not certified with a trusted signature!
    Primary key fingerprint: EE6D B7B9 8F5B F5ED D9DA 0DE5 DEE5 C11C C2A1 E572
    rc=0

    读这份输出有三个要点:

    • Good signature + 主指纹一致才是有效结论。指纹要与官方渠道公布的逐字符核对(本页对照的是 rpm 密钥环里同一把 EE6DB7B9…C2A1E572)。
    • WARNING: This key is not certified… 不是验签失败。它说的是 Web of Trust:你没有当面认证过这把 key,gpg 无法替你确认「这把 key 真的属于 AlmaLinux」。rc 仍是 0,签名数学上有效;「这把 key 是不是官方的」要靠指纹核对解决。
    • 验签成功只说明内容没被改,CHECKSUM 里每个 ISO 的 SHA256 还要再与实际下载文件比对(sha256sum -c CHECKSUM),那一步本页未展开,ISO 下载与校验的整体流程见下载指南。

    然后是关键的阴性对照——把 CHECKSUM 第 4 行末尾加一个词,重新验签:

    Terminal window
    $ sed -i "4s/\$/ tampered/" CHECKSUM && gpg --verify CHECKSUM; echo rc=$?
    gpg: BAD signature from "AlmaLinux OS 10 <[email protected]>" [unknown]
    rc=1

    内容动一个字节,Good 变 BAD、rc 变 1。这组对照证明了验证器真的在工作:只见过一次 rc=0 不能说明验证发生了,能复现失败才能。这也是「先对 key 再验证」的另一个理由——顺序错了,rc=0 可能只是缓存或旧结果。

    rpm 包签名验证:rpm -K / rpmkeys -Kv(未实测)

    Section titled “rpm 包签名验证:rpm -K / rpmkeys -Kv(未实测)”

    对单个 rpm 文件离线验签的入口是 rpm -K(等价 rpm --checksig / rpmkeys -Kv)——比如从镜像站手动下载了一个 rpm,装之前先确认签名。日志只记录了 rpmkeys --help 的存在性(-K, --checksig verify package signature(s)),没有对任何 rpm 文件执行过验签,所以本节不提供输出样例,行为口径以 rpm 官方手册为准:命令比对的三个对象是包的 header 签名、payload 摘要与 header 摘要,全部通过输出 digests signatures OK。

    它与 rpm -V 的分工容易混淆,列一张表(rpm -V 的实测细节见本站 rpm 验证 页):

    问题工具基准
    这个未安装的 rpm 文件是不是官方签的rpm -K / rpmkeys -Kv包内签名 vs 密钥环公钥
    装好的文件后来被动过没有rpm -V文件属性 vs 本地元数据库

    第三方仓库密钥安全(文献口径)

    Section titled “第三方仓库密钥安全(文献口径)”

    启用第三方仓库必然引入对方的 GPG key,这一段本页未实测,口径来自官方文档:

    • 密钥从哪来:优先由对应发行版/项目的 release 包携带(如 epel-release 自带 EPEL key,见本站 EPEL 10 页),或从项目官方渠道下载后核对指纹再导入;不要从不明镜像或论坛贴文里复制密钥。
    • 密钥怎么隔离:每个仓库在 repo 文件里用自己的 gpgkey= 指路,多把密钥可以在 rpm 密钥环里共存(rpm -q gpg-pubkey 会列出全部),互不干扰。
    • 失败怎么办:验签失败(rpm -K 报错、dnf 报 GPG check failed)第一反应是核对密钥来源与代际(本页 step3 的阴性对照就是「key 是 9 代、包是 10 代」的典型错配),而不是 --nogpgcheck 绕过——关掉校验等于放弃这一层保护。
    • 吊销与轮换:密钥泄露或到期后的吊销(revocation)、轮换流程涉及各项目自己的公告机制,通用做法是关注官方公告、删除旧短 id(rpm -e gpg-pubkey-id“)、导入新 key 后重验。AlmaLinux 10 官方密钥 2024-07-11 生成、未过期,轮换行为本页无法实测。
    • rpm -K / rpmkeys -Kv 包级验签:未实测(日志仅 rpmkeys --help 存在性记录),digests signatures OK 等输出解读以 rpm 官方手册文献口径撰写。
    • 第三方仓库密钥的多密钥共存、按仓库 pin、吊销:未实测(容器密钥环只有官方单密钥)。
    • 密钥过期/轮换后的 dnf/rpm 拒绝行为:未实测(官方 10 密钥未过期)。
    • GPG Web of Trust 的 trust 管理(消除 [unknown] 与 WARNING 的 ownertrust/签名认证路径):未实验。
    • 「先错 key 后对 key」导致的 dnf 元数据缓存跳过重验证:本页未构造该场景,仅有方法论提示;实验阳性结论均取自「密钥先就位」的干净调用。
    • CHECKSUM 的 x86_64 变体:日志仅验证 aarch64 清单(容器架构),x86_64 路径未采样。