
Находит Dockerfiles, в которых sshd открыт для *sshole (CVE-2026-123158). CLI, pre-commit hook и GitHub Action.
Находит Dockerfile-файлы, в которых sshd открыт для *sshole (CVE-2026-123158), одной командой и до того, как что-либо будет собрано или развёрнуто.
uvx check-sshole
Он сканирует каждый Dockerfile в текущей папке. Без установки, без Docker,
без доступа к сети: он только читает файлы. (pipx run check-sshole или
pip install check-sshole тоже работают.)
.devcontainer/Dockerfile:2: sshd from 'openssh' on 'python:3.12-alpine3.15' accepts password logins: exposed to *sshole (CVE-2026-123158)
why: Alpine 3.15 never got a fixed openssh build
fix: turn password logins off: RUN echo 'PasswordAuthentication no' >> /etc/ssh/sshd_config
(or start sshd with -o PasswordAuthentication=no)
or: move to Alpine 3.16 or newer and require its fixed openssh build
more: https://sshhole.com/ (to silence, put '# check-sshole: ignore' above line 2)
services/sftp/Dockerfile:2: sshd from 'openssh-server' on 'alpine:3.22' accepts password logins: exposed to *sshole (CVE-2026-123158)
why: a fresh build may pull the fixed package, but nothing here requires it; older or cached builds have the bug
fix: turn password logins off: RUN echo 'PasswordAuthentication no' >> /etc/ssh/sshd_config
(or start sshd with -o PasswordAuthentication=no)
or: if you need password logins, require a fixed build: apk add 'openssh-server>=10.0_p1-r11'
more: https://sshhole.com/ (to silence, put '# check-sshole: ignore' above line 2)
check-sshole: 2 findings in 3 Dockerfiles
*sshole — это обход аутентификации по паролю в sshd из OpenSSH до 10.6p2, когда sshd собран с musl libc без PAM. Именно так Alpine собирает свой openssh-server по умолчанию, поэтому контейнер, в котором sshd устанавливается через apk и остаётся включённым вход по паролю (значение по умолчанию в OpenSSH), оказывается уязвим. Риску подвержены учётные записи, у которых поле пароля равно * (пользователи только с ключами, а также root в Alpine). Образы Debian, Ubuntu, RHEL и другие образы на glibc не затронуты.
check-sshole помечает стадию Dockerfile, когда выполняются все следующие условия:
| Условие | На что смотрит check-sshole |
|---|---|
| sshd установлен | apk add openssh, openssh-server, openssh-server-pam или openssh-server-krb5, в shell-форме, exec-форме, sh -c и heredoc; учитывается последующий apk del |
| база — musl | стадия использует apk и не является Wolfi/Chainguard (они на glibc) |
| вход по паролю включён | ничто не задаёт PasswordAuthentication no или AuthenticationMethods без пароля, в RUN, CMD/ENTRYPOINT (sshd -o …), файлах конфигурации sshd, скопированных из репозитория через COPY, или heredoc в COPY; UsePAM yes вместе с openssh-server-pam также считается отключением |
| исправленная сборка не требуется | пакет не закреплён (=, >=, ~) на исправленной сборке |
Многостадийные сборки отслеживаются: стадия наследует то, что установила и настроила её родительская стадия FROM <stage>, и проверяются только те стадии, на которых не строятся другие стадии.
check-sshole # every Dockerfile under the current folder
check-sshole services/ Dockerfile # some folders and files
check-sshole --format json . # machine-readable
Он подхватывает Dockerfile, Containerfile, Dockerfile.<anything> и
<anything>.Dockerfile, а также пропускает .git, node_modules и virtualenv.
Указанные вами файлы проверяются независимо от их названия.
| Код выхода | Значение |
|---|---|
| 0 | ничего не найдено |
| 1 | как минимум одно обнаружение |
| 2 | путь не существует или не может быть прочитан |
repos:
- repo: https://github.com/shenxianpeng/check-sshole
rev: v0.1.0
hooks:
- id: check-sshole
Чтобы проверить все Dockerfile сразу, а не только те, которые затрагивает коммит:
pre-commit run check-sshole --all-files.
jobs:
check-sshole:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: shenxianpeng/[email protected]
# with:
# path: services/ Dockerfile # default: the whole repository
Результаты отображаются в виде аннотаций в pull request и в сводке задания, и приводят к сбою задания. Действие выполняется на собственном Python раннера и ничего не устанавливает.
| Входной параметр | По умолчанию | Значение |
|---|---|---|
path | . | файлы или папки для сканирования, разделённые пробелами |
format | github | github (аннотации и сводка задания), text или json |
| Alpine | Первая исправленная сборка |
|---|---|
| edge | 10.6_p2-r0 |
| 3.24 | 10.3_p1-r2 |
| 3.23 | 10.2_p1-r1 |
| 3.22 | 10.0_p1-r11 |
| 3.21 | 9.9_p2-r1 |
| 3.20 | 9.7_p1-r6 |
| 3.19 | 9.6_p1-r3 |
| 3.18 | 9.3_p2-r4 |
| 3.17 | 9.1_p1-r7 |
| 3.16 | 9.0_p1-r6 |
| 3.15 и старше | нет: отключите вход по паролю или перейдите на более новую ветку |
Источник: коммиты aports "main/openssh: fix password authentication"
(2026-11-05) в каждой ветке *-stable.
check-sshole читает Dockerfiles, поэтому не может увидеть, что на самом деле содержит существующий образ. Чтобы проверить его, прочитайте установленную сборку и сравните её с таблицей:
docker run --rm --entrypoint apk IMAGE list --installed openssh-server
# openssh-server-10.0_p1-r11 aarch64 {openssh} (SSH-OpenSSH) [installed]
sshd -V и ssh -V не показывают ревизию Alpine (-r11), а
apk info -v не выводит версию, поэтому используйте apk list --installed.
Пересборка образа без --no-cache может сохранить старый уязвимый слой.
Поместите # check-sshole: ignore на строку выше RUN, который устанавливает sshd,
или выше FROM, чтобы пропустить целый этап (и этапы, построенные на нём):
FROM alpine:3.22
# check-sshole: ignore (sshd only listens on the internal network)
RUN apk add --no-cache openssh-server
FROM linuxserver/openssh-server), или конфигурацию sshd, которую скрипт entrypoint
изменяет во время выполнения. Проверяйте такие образы с помощью команды выше.pip install -e '.[test]'
pytest --cov # fails below 100% coverage
Релизы создаются путём публикации GitHub-релиза с тегом vX.Y.Z; рабочий процесс публикации собирает пакет и загружает его в PyPI.