*sshole (CVE-2026-123158) に露出した sshd を同梱する Dockerfile を、ビルドやデプロイの前に、1つのコマンドで見つけます。
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 は、OpenSSH 10.6p2 より前の sshd におけるパスワード認証バイパスです。条件は、sshd が PAM なしで musl libc に対してビルドされている場合です。Alpine はデフォルトの openssh-server をこの方法でビルドしているため、apk で sshd をインストールし、パスワードログインを有効のまま(OpenSSH のデフォルト)にしているコンテナが影響を受けます。リスクがあるのは、パスワードフィールドが * になっているアカウント(鍵認証のみのユーザー、および Alpine の root)です。Debian、Ubuntu、RHEL などの glibc イメージは影響を受けません。
check-sshole は、以下のすべてが当てはまる場合に Dockerfile のステージをフラグします:
| 条件 | check-sshole が確認する内容 |
|---|---|
| sshd がインストールされている | apk add openssh、openssh-server、openssh-server-pam、openssh-server-krb5 を、シェル形式、exec 形式、sh -c、ヒアドキュメントで検出。apk del が後続する場合は追跡 |
| ベースが musl | ステージが apk を使用し、Wolfi/Chainguard ではない(これらは glibc) |
| パスワードログインが有効 | PasswordAuthentication no またはパスワード不要の AuthenticationMethods を設定しているものがない。確認対象は RUN、CMD/ENTRYPOINT(sshd -o …)、リポジトリから COPY された sshd 設定ファイル、COPY ヒアドキュメント。openssh-server-pam での UsePAM yes も無効とみなす |
| 修正済みビルドが必須でない | パッケージが修正済みビルドに固定(=、>=、~)されていない |
マルチステージビルドも追跡されます。ステージは 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 | 少なくとも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
検出結果はプルリクエスト上のアノテーションとジョブサマリーに表示され、ジョブを失敗させます。このアクションはランナー自身の 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 以前 | なし: パスワードログインを無効にするか、新しいブランチへ移行してください |
出典: 各 *-stable ブランチにおける aports のコミット「main/openssh: fix password authentication」(2026-11-05)。
check-sshole は Dockerfile を読み取るため、既存のイメージに実際に何が含まれているかは分かりません。イメージを確認するには、インストールされているビルドを読み取り、表と比較してください:
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 なしでイメージを再ビルドすると、古い脆弱なレイヤーが残る可能性があります。
sshd をインストールする RUN の上の行に # check-sshole: ignore を配置するか、ステージ全体(およびそれを基にビルドされるステージ)をスキップするには 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 設定は検出できません。これらのイメージは上記のコマンドで確認してください。pip install -e '.[test]'
pytest --cov # fails below 100% coverage
リリースは vX.Y.Z というタグを付けた GitHub リリースを公開することで作成されます。publish
ワークフローがパッケージをビルドし、PyPI にアップロードします。