签名密钥环(linxira-keys / linxira-keyring)
为什么存在
pacman 要验证 [linxira] 仓库的包与数据库,系统里必须先有一把被本地信任的发布公钥。
让用户自己下载 ASCII 公钥、手工导入、再逐条设置信任,既容易出错,也无法审计。
密钥环把「公钥 + 指纹 + 本地签名」做成一个普通软件包,随系统一起交付。
私钥不在这个链路里:包只分发公钥,签名发生在维护者的构建环境。
职责边界
归它:
linxira-keyring包安装公钥与指纹:/usr/share/keyrings/linxira.gpg、/usr/share/keyrings/linxira-release-fingerprint。 包只带二进制公钥与指纹文件,不带 ASCII 公钥。- 安装脚本以 root 身份把公钥加入 pacman 的 keyring,并对发布密钥做本地签名
(
pacman-key --add、pacman-key --lsign-key)。 - 密钥金库(私有仓库
linxira-keys)保管加密的私钥材料与公钥源文件;加密口令由 密钥持有者单独保管,不在任何仓库里。
不归它:
- 不签名软件包;包与仓库数据库的签名由维护者的签名环境完成,发布流程在
packages仓库(scripts/publish-repo.sh)。 - 不托管仓库;
linxira-packages由 GitHub Pages 提供,且不产生签名。 - 不启用
[linxira]仓库;仓库配置在/etc/pacman.conf。 - 不清除旧密钥;卸载包时
post_remove是空操作。 - 不托管私钥恢复步骤。本 wiki 不记录解密、导入私钥或口令处理流程。
谁做什么
| 参与方 | 负责 | 不负责 |
|---|---|---|
私有金库 linxira-keys |
加密的私钥(linxira-master-secret.asc.enc、linxira-signing-subkey.asc.enc)、公钥源文件(linxira.asc、linxira.gpg) |
不签名、不分发、不含任何口令 |
packages 仓库的 linxira-keyring 包 |
打包公钥与指纹,post_install 与 post_upgrade 导入并本地签名 |
不签名软件包、不托管仓库、不启用仓库 |
linxira-packages(GitHub Pages) |
托管包、.sig、签名数据库、SHA256SUMS 与仓库版 x86_64/linxira.gpg |
不产生签名;发布自动化推入已签产物 |
| ISO 与 WSL 镜像 | 预装 linxira-keyring,作为首次信任的引导来源 |
不代替仓库对后续包验签 |
签名在维护者的签名环境里、用从金库恢复的签名子密钥完成。私钥与口令永远不进
[linxira] 仓库,也不进任何镜像。
怎么用
新装系统上,密钥环由 ISO 提供并由 pacman 正常安装(WSL 镜像的包清单同样包含
linxira-keyring)。之后启用仓库:
[linxira]
Server = https://linxira-os.github.io/linxira-packages/$arch
SigLevel = Required DatabaseOptional
公钥信息:
| 属性 | 值 |
|---|---|
| UID | Linxira OS Release Signing <release@linxira.org> |
| 主密钥指纹 | E1A4155F457D1481CA85EE6BF9D157739534BC29 |
| 签名子密钥指纹 | D477286C296F1E1C35735E52B22DF3E636274191 |
这些是公开信息,可以写进脚本或核对清单;私钥材料不是。
用户不需要手动导入公钥,也不需要在每台机器上重新设置信任——post_install 与
post_upgrade 都会重新执行导入与本地签名。
何时需要 root
- 读取
/usr/share/keyrings/下的公钥与指纹不需要 root;它们本来就是公开信息。 - 安装或升级
linxira-keyring是普通的 root 包操作(pacman执行)。 - 包脚本里的
pacman-key调用由 pacman 以 root 身份运行,用户不直接执行。 - 日常装包仍是 root 操作,但密钥信任已经在系统层完成。
已知限制
- 首次信任是自举的:密钥环包本身无法由它将要启用的
[linxira]仓库验证。 它必须来自 ISO 或其他已受信任的渠道;不要从未知镜像首次安装密钥环。 - 安装脚本对
pacman-key的失败不报错(调用后接|| true),所以装完应自行确认 该指纹已出现在本地 keyring 中,而不是假定信任一定建立。 - 卸载包不会删除 pacman keyring 里的密钥(
post_remove是空操作);需要撤销信任时 由管理员显式删除(pacman-key --delete <指纹>)。 - 私钥与口令只存在于私有密钥仓库和密钥持有者手中;本 wiki 不提供恢复流程, 也不应把私钥材料写进文档、脚本或 issue。
- 指纹轮换必须发新的密钥环包;安装新包只添加并本地签名当前公钥,不会自动删除本机 仍存在的旧公钥。
- 包里的公钥不是仓库的完整信任来源:
linxira-packages还会提供x86_64/linxira.gpg, 两者都来自同一把发布密钥。
深入设计
仓库托管与签名说明见
linxira-packages;
密钥环包定义见
packages/packages/linxira-keyring。