一个 Ansible playbook,用于在 Alpine Linux 上升级 OpenSSH 以修复 CVE-2026-123158(“sshhole”),随后再次运行检测脚本,如果主机仍然存在暴露风险则失败。
在不使用 PAM 的 musl libc 上,对于 shadow 字段恰好为 * 的账户,sshd 会接受任何长度超过 256 字节的密码。这并非涵盖所有无密码账户:busybox 的 adduser -D 会写入 !,而脚本只统计 *。在做出假设之前,请先用检测脚本检查你的主机实际具有的情况。
该修复已进入 OpenSSH 10.6p2,该版本位于 edge 分支,而 stable 分支仍停留在 10.0p1。
ansible-core 2.16 或更新版本。python3;设置 -e sshole_bootstrap_python=false 可自行管理。become 权限。alpine 组,参见 inventory.example.ini。该 playbook 是一个普通的 ansible-playbook,不包含角色、集合,也没有交互式提示,因此可在 AWX、Red Hat Ansible Automation Platform 和 Semaphore UI 下原样运行。
| 平台 | 最低要求 | 说明 |
|---|---|---|
| AWX | 带有 ansible-core 2.16+ 的执行环境 | 较新的 awx-ee 即可,用 ansible --version 验证 |
| Ansible Automation Platform | 2.5 或更新版本(自带 ansible-core 2.16) | 2.4 自带 2.14,会在 meta: end_host 处失败 |
| Semaphore UI | 带有 ansible-core 2.16+ 的 runner | 官方镜像此前曾滞后,请固定版本或自行安装 |
alpine 组。mode、sshole_sha256 和 alpine_reboot 作为 survey 变量或额外变量传入。become。delegate_to: localhost 在执行环境或 runner 容器内运行,而非在你的笔记本电脑上运行。写入其中的任何内容都是临时的,因此请依赖作业日志而非文件。sshole_script_url 和 edge_repo。* 账户名称,因此会写入作业日志,可能被比你预期更多的人看到。mode 添加为 survey 变量。alpine 组的清单、包含 SSH 密钥的环境,以及传入 -e mode=openssh 的任务模板。cp inventory.example.ini inventory.ini # then edit it
ansible-playbook -i inventory.ini sshhole-remediate.yml -e mode=openssh
mode=openssh(默认)仅从 edge 升级已安装的 openssh* 软件包。它会向 /etc/apk/repositories 追加一行:
@edge https://dl-cdn.alpinelinux.org/alpine/edge/main
该标签将 openssh 软件包固定到 edge。在 apk 中,带标签的软件包会将标签传递给其依赖项,因此未标记的仓库无法满足的依赖项也可以来自 edge。在 Alpine 3.22 上,实际上只有六个 openssh* 软件包会移动,因为稳定版库已满足它们。仅添加 edge/main;如果某个依赖项位于 edge/community 中,则会导致升级明显失败。
如果没有该固定,下一次 apk upgrade --available 会将稳定版本拉回,并悄无声息地重新打开漏洞。一旦 apk add 运行,该固定就会存在于 /etc/apk/world 中,因此它能在重启和后续升级后保留。
mode=full 会将每一行未注释的仓库行重写为 edge,刷新索引并运行 apk upgrade --available。这是一次单向升级:没有受支持的降级路径可以回到稳定版,只能重新安装。之前的 @edge 行和 world 条目会保留在原处;一旦每个仓库都指向 edge,它们就是多余的,但无害。
/etc/apk/repositories:@edge 行,或在 full 模式下的每一行。/etc/apk/world:openssh 软件包会被固定到 @edge。ssh-keygen -A 会在升级后运行。OpenSSH 10.6 新增了 ML-DSA 主机密钥类型,如果密钥未就位就重启,会导致密钥交换失败,而 sshd -t 仍返回 0。sshd 会被重启,而不是重新加载。就地升级后,SIGHUP 会使其通过 /proc/self/exe 重新执行已删除的旧二进制文件,因此新连接会中断。重启会保留已建立的会话,只替换监听器。随后 play 会检查监听器进程是否运行升级后的二进制文件,如果不是则失败。/etc/ssh/sshd_config 永远不会被触碰。该 playbook 不会锁定账户或禁用密码认证。
在没有软件包变更的情况下第二次运行会报告 ok,并且不会重启 sshd,除非监听器仍在运行较旧的二进制文件,在这种情况下它会被重启并报告为已更改。
full 模式会在触碰任何内容之前保留一份副本:
cp -a /etc/apk/repositories.pre-edge /etc/apk/repositories
仅恢复仓库文件并不能撤销 openssh 模式。apk add openssh@edge records openssh@edge in /etc/apk/world,因此删除唯一的
@edge 仓库定义会留下一个无处解析的 world 约束。顺序很重要:
/etc/apk/world 中的 openssh 条目移除 @edge 后缀。/etc/apk/repositories 中移除 @edge 行。apk update。apk 不会自行降级,
因此必须固定版本,例如
apk add --upgrade 'openssh=10.0_p1-r11'。在依赖降级之前,先在金丝雀环境上测试它。
该 playbook 不内置该脚本。它在运行时从上游仓库 oz9un/sshole 下载该脚本:
https://raw.githubusercontent.com/oz9un/sshole/main/check.sh
它在控制器上获取,从不在目标主机上获取,并在每个目标主机上以 root 身份执行。
0:已暴露1:未暴露2:无法判断2 会产生警告,而不是失败。任何其他退出码都会导致 play 失败。
默认跟踪 main。当你希望确保所执行的内容时,请固定版本:
ansible-playbook -i inventory.ini sshhole-remediate.yml \
-e mode=openssh \
-e sshole_sha256=<sha256 of check.sh>
--check 会在目标上执行目标验证、软件包清单和暴露检查,模拟仓库编辑,并跳过软件包升级和事后检查。它只是部分预览,并非完整模拟。
mode=full 通常会拉取一个新内核。将 -e alpine_reboot=true 设置为在结束时通过 ansible.builtin.reboot 重启,后者会等待主机恢复。
| 变量 | 默认值 | 含义 |
|---|---|---|
mode | openssh | openssh 或 full |
alpine_branch | edge | 写入仓库的分支 |
edge_repo | https://dl-cdn.alpinelinux.org/alpine/edge/main | 固定为 @edge 的仓库 |
openssh_min_version | 10.6_p2 | 与 apk version -t 进行比较 |
sshole_script_url | main 上的上游 check.sh | 检测脚本来源 |
sshole_sha256 | 空 | 脚本的可选校验和固定值 |
sshole_bootstrap_python | true | 缺失时安装 python3 |
alpine_reboot | false | 结束时重启 |
MIT,参见 LICENSE。检测脚本不属于本仓库,并在上游保留其自己的许可证。
ansible-lint