こんにちは。エンジニアのjunです。
少し前に、ローカルAWSエミュレータとしてFlociを利用し始めた話を書きました。 ホイシルの開発環境では、Cognito や S3、Lambda といった AWS の依存をローカルで完結させるために Floci というローカル AWS エミュレータを使っています。
その記事では「Floci にホストの docker.sock は渡さない方針にしています」とだけ書き、理由には踏み込みませんでした。本記事はその補足です。「コンテナを操作するコンテナ」に Docker daemon をどう渡すかを、docker.sock 直渡し、socket-proxy による制限、使い捨ての隔離 DinD の順に整理します。例として Floci の Lambda 実行を使いますが、考え方はツールを問いません。
コンテナを操作するコンテナという構図
コドモンには、HTML を Playwright(ヘッドレス Chromium)でレンダリングして PDF を生成する処理を AWS Lambda に載せる、という出力パターンがあります。帳票まわりで何度も登場するため基盤として共通化していて、ホイシルでもこの仕組みで PDF を作っています。おおむね以下のような仕組みになっています。
flowchart TB
App["アプリケーション"]
Lambda["AWS Lambda<br/>(Playwright)<br/>HTMLレンダリング → PDF化"]
S3[("Amazon S3")]
Lambda -->|"② 指定パスにPDFを保存"| S3
App -->|"① 起動(キック)<br/>引数: HTML, PDF出力先(S3パス)"| Lambda
Lambda -.->|"③ 完了通知"| App
App -->|"④ 完了後、PDFを取得"| S3
Playwright はヘッドレス Chromium を同梱するため、関数のイメージはそれなりに大きく、ブラウザ込みの軽量コンテナとして動かすのが自然です。AWS 上ではこのコンテナを Lambda が実行しますが、ローカル環境での開発時にはその役割を先のブログ記事で紹介した Floci に肩代わりしてもらいます。Floci は Lambda を invoke するたびにランタイムイメージのコンテナを立ち上げ、その中で Lambda 関数のハンドラを動かします。
ゆえに Floci コンテナは、自分の外側で別のコンテナを起動できる必要があります。コンテナを起動するには Docker daemon を操作できる必要があり、Floci はいわば「コンテナを操作するコンテナ」になるということです。
これを実現するもっとも素直な方法が、ホストの Docker daemon のソケット /var/run/docker.sock を Floci コンテナにマウントすることです。
services: floci: image: floci/floci:<ver> volumes: - /var/run/docker.sock:/var/run/docker.sock # ← これが今回の主役
図にするとこのようなかたちになります。
%%{init: {
"flowchart": {
"htmlLabels": true,
"nodeSpacing": 50,
"rankSpacing": 70
}
}}%%
flowchart BT
Caller["任意のアプリケーション<br/>AWS CLI / SDK<br/>テストコード等"]
subgraph Host["開発マシン / Docker ホスト"]
subgraph FlociContainer["Floci コンテナ"]
Floci["Floci<br/>ローカル AWS エミュレータ"]
DockerClient["Docker API client<br/>DOCKER_HOST =<br/>unix:///var/run/docker.sock"]
end
Sock["/var/run/docker.sock<br/>Docker daemon への Unix socket"]
Daemon["Docker daemon<br/>/ Docker runtime"]
subgraph LambdaContainer["Floci が起動する Lambda"]
Runtime["AWS Lambda runtime image"]
Handler["Lambda handler<br/>例: Playwright で HTML → PDF"]
end
end
Caller -->|"Lambda invoke"| Floci
Floci -->|"実行要求"| DockerClient
DockerClient -->|"POST /containers/create<br/>POST /containers/{id}/start"| Sock
Sock -->|"daemon に転送"| Daemon
Daemon -->|"Lambda 用コンテナを作成・起動"| Runtime
Runtime --> Handler
Handler -->|"結果を返す / S3 保存"| Floci
Floci -->|"invoke 結果を返す"| Caller
これで Floci は Lambda を起動することができるようになります。
ただし、コンテナが汚染された(イメージや依存パッケージに悪意あるコードが紛れ込んだ)ときのことを考えると、この docker.sock のマウントには危険が伴います。
docker.sock マウントの危険性
docker.sock にアクセスできるということは、ホストの Docker daemon に何でも頼めるということです。Docker daemon は root 権限で動くため、daemon に任意のコンテナ作成を頼めば、ホストの任意のパスを root 権限でマウントして読み書きできます。ここに到達できる時点で、ホストの root に等しい権限を得たことになります。
docker.sock をマウントしたコンテナからはシェルを取らずとも、特定のファイルを狙うだけなら、その場所をマウントして読み出すだけで済みます。攻撃側はホストのユーザ名を知る必要すらありません。次のコマンドは、docker.sock をマウントしたコンテナ(汚染されたコンテナの再現)から /Users をマウントし、更新日がもっとも新しいユーザの AWS 認証情報を読み出します。
# docker.sockをマウントしたコンテナの代わりとして docker:cli を利用し、
# コンテナ内からdocker runしてawsのクレデンシャルを読み取る
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock docker:cli \
docker run --rm -v /Users:/users:ro alpine sh -c '
u=$(ls -t /users | head -1)
cat "/users/$u/.aws/credentials"
'
上記の例を見ればわかるように、macOS で動くことを想定して /Users を丸ごとマウントして内部を読み取っています。この例では .aws ですが、同じ要領で .ssh の鍵や管理しているソースコード、ドキュメント類も読み出せます。docker.sock を渡したコンテナの中では、同じことが docker API 経由で可能です。
問題になるのは、このコンテナが汚染された場合です。コンテナイメージや依存パッケージがいわゆるサプライチェーン攻撃を受けて悪意あるコードが紛れ込むと、その権限を握った攻撃者は、ホストのファイルや認証情報、ソースコードを盗み出し、書き換え、同じマシンで動く他のコンテナの中身まで取り出せます。「コンテナの中だから安全」という前提は、docker.sock を渡した時点で崩れます。
念のため補足すると、これは Floci 固有の弱点ではありません。docker.sock を渡されたコンテナであれば何であっても同じで、論点は「コンテナを操作するコンテナ」に Docker daemon の権限をどう渡すか、という構成の側にあります。
ローカル開発環境であっても、開発者の手元にはソースコードや外部サービスの認証情報が置かれています。docker.sock のマウントは、それを汚染されたコンテナに明け渡す経路を作ってしまいます。
HAProxy による緩和とその限界
docker.sock を渡す危険はよく知られていて、定番の対策として socket-proxy があります。
docker.sock の前に Docker API のプロキシ(以降 socket-proxy と呼びます)を一枚挟み、必要な API だけを通す方法です。例えば HAProxy を使い、ホストの docker.sock を backend に、許可する API だけを通す frontend を書くことで実現できます。
tecnativa/docker-socket-proxy というこの目的用のソフトウェアもあり、環境変数の設定だけで簡単に同じ制御を行うこともできるのですが、実態としてはHAProxyをベースに設定の書き方を簡単にしたものであります。依存関係を増やすほどにサプライチェーン攻撃のリスクは高まるという観点から、個人的には HAProxy をそのまま使うほうが好みです。
services: floci: image: floci/floci:<ver> environment: DOCKER_HOST: tcp://docker-socket-proxy:2375 # 直接ではなく proxy 越しに見る networks: [app-net] # docker.sock の前に立てる HAProxy。許可した API だけを通す docker-socket-proxy: image: haproxy:<ver> volumes: - ./haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro - /var/run/docker.sock:/var/run/docker.sock:ro # sock はここだけが持つ networks: [app-net]
これで Floci は docker.sock を直接持たず、HAProxy が許可した API しか叩けなくなります。/secrets や /configs のような機微なエンドポイントもパスで拒否できます。
haproxy.cfg の判定部分を抜き出すと、次のようになります。
frontend dockerfrontend
bind [::]:2375 v4v6
# メソッドは GET と POST だけ許可
http-request deny unless METH_GET || METH_POST
# 危険な API はパスで拒否(secrets / exec / swarm / system / volumes など)
http-request deny if { path,url_dec -m reg -i ^(/v[\d\.]+)?/secrets }
http-request deny if { path,url_dec -m reg -i ^(/v[\d\.]+)?/exec }
# …(auth / build / swarm / system / volumes なども同様に拒否)
# 必要な API はパスで許可
http-request allow if { path,url_dec -m reg -i ^(/v[\d\.]+)?/containers }
http-request allow if { path,url_dec -m reg -i ^(/v[\d\.]+)?/images }
# …(networks / info / version / _ping / events)
# どの行にも当たらなければ拒否
http-request deny
default_backend dockerbackend # backend は /var/run/docker.sock
判定はすべて path(と冒頭のメソッド)が対象で、リクエストボディは見ていません。/containers はコンテナ起動に必須なので開けざるを得ず、ここにセキュリティーホールが残ることになります。
socket-proxy 越しに成立する攻撃
Floci 等が Lambda を起動するには「コンテナを作る」操作、すなわち POST /containers/create の呼び出しが必要です。したがって haproxy.cfg からは /containers の許可と POST メソッドの許可は外せません。
ここで、POST /containers/create でどんなコンテナを作るかは、リクエストボディで決まります。HAProxy はパスとメソッドしか見ず、ボディを検査しないため、許可されたエンドポイントである以上、ボディに何を載せても素通りします。
例えば proxy 越しに次のボディを投げます。
# proxy は POST /containers/create を許可済み。ボディは検査されないので、
# /Users をマウントして「更新日が新しいユーザの認証情報」を読むコンテナを作れる
curl -s -X POST http://docker-socket-proxy:2375/containers/create \
-H 'Content-Type: application/json' \
-d '{
"Image": "alpine",
"Cmd": ["sh", "-c", "u=$(ls -t /users | head -1); cat /users/$u/.aws/credentials"],
"HostConfig": { "Binds": ["/Users:/users:ro"] }
}'
# 返ってきた Id を start して logs を読むと、認証情報が抜ける
curl -s -X POST http://docker-socket-proxy:2375/containers/<id>/start
curl -s "http://docker-socket-proxy:2375/containers/<id>/logs?stdout=1&stderr=1"
/containers を許可すると /containers/ 配下がまとめて通るため、create だけでなく start や logs、後述の archive も同じ許可で抜けられます。
ここでは /Users を読み取り専用でマウントしましたが、:ro を外せば書き込みもでき、SSH 鍵や cron を仕込むバックドアの注入も可能です。また GET /containers/{id}/archive も /containers 配下として通るので、同じ環境で動く他のコンテナ(たとえば MySQL)の中身を tar で吸い出すこともできます。
マウント先も自由です。Linux ホストなら Binds を ["/:/host"] にしてルートごと丸ごと載せられます。Docker Desktop for Mac の場合は / が LinuxKit VM のルートを指すため(手元で試すと VM 側の /Users は空でした)、macOS の実ファイルへはこの例のように共有パス(/Users など)を直接マウントして到達します。
コンテナを起動するツールにとってコンテナ作成は必須の操作なので、POST /containers/create を塞ぐ選択肢はありません。proxy はリクエストの経路を狭めますが、ホストの daemon を共有する構図そのものは変えられません。
共有 daemon の限界と DinD に閉じ込める構成
socket-proxy は、ホストの daemon を共有したまま危険な操作だけを塞ぐアプローチです。ホストの daemon を共有している以上、POST /containers/create のような強力な API を一つでも許せば、そこからホストを掌握できます。穴を塞いでも、共有している相手がホストの daemon である限り、事故時の被害がホストに直結する構図は変わりません。
flowchart TB
c["汚染されたコンテナ"] --> proxy["docker-socket-proxy"]
proxy --> sock["ホストの docker.sock"]
sock --> daemon["ホストの Docker daemon"]
daemon --> radius["ホストや他コンテナのファイルを<br/>盗み出し/改ざんできる"]
style c fill:#fdecea,stroke:#d33,color:#900
style radius fill:#fdecea,stroke:#d33,color:#900
そこで、ホストのデーモンを共有しない方針に切り替えます。権限としては強いものの隔離された環境、すなわち使い捨ての別の Docker daemon を用意し、そこに Docker 操作を閉じ込めるのです。この daemon は DinD(Docker-in-Docker)で立てます。
使い捨ての隔離 daemon に閉じ込めると、コンテナが汚染されても掌握できるのは「使い捨ての隔離 daemon」と、そこに read-only でマウントしたコード(Lambda エミュレータなら関数のコードなど)だけです。ホストの daemon にも、ソースコードにも、他のコンテナにも手は届きません。その隔離がネットワーク上どう実現されているかは、次の節で図にします。
compose.yml の要点を抜き出します(固有名やネットワーク名は一般化しています)。
services: floci: image: floci/floci:<ver> environment: # ホストの daemon ではなく、使い捨ての別 daemon を見る DOCKER_HOST: tcp://floci-dind:2375 networks: - app-net # アプリ本体から floci を呼ぶための共有ネット - tool-net # dind と話すための専用ネット depends_on: floci-dind: condition: service_healthy # Floci 専用の使い捨て Docker daemon。ホストの docker.sock には一切触れない。 floci-dind: image: docker:28-dind privileged: true # Mac の素の構成では rootless 不可のため必須(後述) environment: # 空にすると TLS なしで tcp://0.0.0.0:2375 と unix socket の両方を開く DOCKER_TLS_CERTDIR: "" networks: - tool-net # DB のいる app-net には載せない # ports: を書かない = ホストに 2375 を publish しない healthcheck: test: ["CMD", "docker", "info"] # unix socket 経由で dockerd の起動を確認 networks: app-net: tool-net:
ネットワークの所属を図にすると、次のようになります。
flowchart TB
subgraph appnet["app-net(アプリ用)"]
app["アプリ本体"]
db[("MySQL")]
floci_a["floci"]
end
subgraph toolnet["tool-net(dind 専用)"]
floci_t["floci"]
dind["floci-dind<br/>privileged /<br/> 使い捨て daemon"]
lambda["Lambda コンテナ<br/>dind 内部の bridge で起動"]
end
app --> floci_a
floci_a -. 同一コンテナ .- floci_t
floci_t -->|DOCKER_HOST| dind
dind --> lambda
db -. 到達不可 .- dind
style floci_a fill:#eef,stroke:#66c
style floci_t fill:#eef,stroke:#66c
要点は次の通りです。
ホストの docker.sock 参照を全廃する
Floci は docker.sock をマウントせず、DOCKER_HOST で隣の floci-dind(別コンテナの Docker daemon)を見ます。Floci が起動する Lambda はこの DinD の内部で起動するため、ホストの daemon には触れることができなくなります。
DinD をネットワーク的に隔離する
floci-dind を tool-net だけに接続し、MySQL などがいる app-net には参加させないようにします。
DinD が起動する Lambda コンテナは、さらにその内側(DinD 内の dockerd が作るブリッジ)で動く別レイヤです。floci-dind 自体が app-net にいないため、Lambda から app-net への経路はそもそも存在しません。DinD 内のコンテナから nc -vz <db-host> 3306 を試してもタイムアウトし、到達できないことを確認できます。
2375 をホストに publish しない
ports: を書かないことで、DinD の Docker API はコンテナ間ネットワークの内側にだけ見え、ホストや LAN には触れることができなくなります。
この構成では、DinD 内で動く Lambda の実行側が汚染されても、被害は使い捨て daemon の内側にとどまります。ホストのファイルやソースコードに手は届きませんし、app-net 側(MySQL など)へ抜けることもできません。
DinD の残存リスク
DinD はゼロリスクではありません。privileged で動かす必要があり、それ自体が嫌われやすい構成です。
残るリスクと、それでもこの構成を選んだ理由を整理します。
rootless が使えない場合は privileged で動かす
本来は rootless DinD で動かせれば理想的でした。dockerd を非 root で動かせれば、内側のコンテナから脱出されても得られるのは非特権ユーザの権限にとどまり、ホストの root には直結しません。 しかし Docker Desktop for Mac では、それを支える Sysbox のような仕組みを使うには、 Business Planでのみ利用可能な Enhanced Container Isolation(ECI) を有効にする必要があります。 弊社の開発環境ではBusinessプランに加入しているもののECIの設定を入れられておらず、rootless DinD は使えませんでした。 おそらくECIを有効にすれば rootless DinD が使えるようになると推測していますが、現時点では未検証です。
そのような場合には、docker:dind を動かすために --privileged を付けて起動するというアプローチがあります。
privileged コンテナはホストとの隔離が弱く、条件次第ではホストへ脱出されうるため、ここがこの構成での最も危険な箇所となります。
egress を許容する
DinD は Lambda ランタイムのイメージを pull する必要があり、ネットワークを完全に閉じる(internal: true)ことはできません。egress が開いている以上、汚染された場合に盗んだデータを外部へ送出する経路は残ります。
ただし最も保護したい対象(DB や secrets)は floci-dind から到達できないようネットワーク分離してあるため、外部へ送信できるのは pull するランタイムイメージと read-only でマウントした関数コードの範囲にとどまります。
まとめ
docker.sock 直渡しと socket-proxy は、どちらもホストの daemon をそのまま渡すため、侵害がそのままホストの侵害に直結します。
これまで紹介してきた3つの構成を比較すると、次の表のようになります。
| docker.sock 直渡し | socket-proxy 経由 | 使い捨て DinD | |
|---|---|---|---|
| ホストの daemon を共有するか | する | する(API を絞るだけ) | しない |
| ホストのファイルシステムへの到達 | 容易(共有パスを丸ごとマウント) | 可能(create を許せばボディ無検査で素通り) |
不可 |
| 他コンテナ(DB等)への到達 | 可能 | 可能(archive 等) |
ネットワーク分離で不可 |
| 侵害時にまず取られるもの | ホストの daemon | ホストの daemon | 使い捨ての隔離 daemon |
| 主な残存リスク | ほぼ無防備 | allowlist の穴 | privileged のみ |
DinD も privileged であるためゼロリスクではありませんが、一番守りたいものには触れられないように制御できているため、相対的にはリスクを下げられています。
本件で伝えたいことを要約すると以下の3点です。
docker.sockをそのまま渡すのは、ホストの root を渡すのに等しい- socket の前段に proxy を置いてリクエストを絞っても、
POST /containers/createを許可した時点でボディ無検査で素通りされ、根本的な防御にはならない - ホストの daemon を共有せず、使い捨ての隔離 DinD に閉じ込めるほうが安全である
DinD のリスク対策については、apple/container の情報を集めたり、Docker の隔離まわり(Sysbox や Docker Desktop の Enhanced Container Isolation など)の動向に合わせて、もう少し安全な環境を作れないかを検討していきます。