
ソースコードが同じでも、ビルド環境が変われば同じバイナリができるとは限りません。Reproducible Builds プロジェクトも、コンパイラやビルドツールとそのバージョンをビルド環境の一部と位置づけています。
コンテナを使えば、OS、コンパイラ、ビルドツール、依存関係といったビルド環境の大部分をひとまとめにできます。ただし、それはコンテナイメージ自体が同じ内容のまま手に入ることが前提です。Docker のタグは書き換えられるため、タグが同じでも中身のイメージが変わることがあります。
2026年9月、Docker Hub の traefik:v3.7.13 について、タグは変わっていないのにイメージダイジェストが変わっている、とユーザから報告がありました。Traefik の説明によると、Alpine にセキュリティ修正が入ったことを受けて、Docker が公式イメージを再ビルドしたためです。Traefik のバイナリ自体は同じでも、それを包む OS レイヤーは変わっていました。
つまり、再ビルドの前と後では、同じ traefik:v3.7.13 をプルしても別のイメージが返ってきます。多くの利用者にとっては問題なく、セキュリティ修正が入る分、むしろ歓迎すべき変化です。しかし、古いイメージが残っているマシンと、再ビルド後のイメージをプルしたマシンが混在すると、どちらも traefik:v3.7.13 を指定しているのに、実際には別の環境で動くことになります。おなじみの「自分の PC では動くのに」現象は、こうして起こります。
上流のイメージが変わるのを待つのではなく、この状況を自分たちで再現してみました。題材は小さなサンプルプログラムの GNU Hello で、自分たちで管理するタグの中身を差し替えます。違いが分かりやすいよう、今回は GCC 12 を GCC 13 に入れ替えました。実際には、イメージ内のシステムパッケージが更新される程度の小さな変化でも、再現性は崩れることがあります。
結論から言うと、Docker タグで公開した GCC 12 のイメージで GNU Hello をビルドし、同じイメージを StableBuild 経由でキャッシュしておけば、元のバイナリを後から再現できました。Docker Hub 上の同じタグを GCC 13 のイメージに差し替えた後、Docker Hub は GCC 13 を返すようになりましたが、StableBuild はキャッシュ済みの GCC 12 を返し続けました。StableBuild のイメージで GNU Hello をビルドし直すと、元のバイナリとバイト単位で一致しました。
testing-v1
GCC 12
testing-v1
GCC 12
testing-v1
GCC 12 · キャッシュ済み
testing-v1
GCC 13 · 変更後
testing-v1
GCC 12 · キャッシュ済み
検証は次の4つのステップで進めます。タグは最初から最後まで testing-v1 のままで、変わるのは Docker Hub がそのタグで配信するイメージだけです。
testing-v1 の GCC 13 への差し替えまず、GCC 12.5.0 のイメージを tfryer/sb-hello-build-env:testing-v1 として公開しました。
docker pull --platform linux/amd64 gcc:12.5.0-bookworm
docker tag gcc:12.5.0-bookworm tfryer/sb-hello-build-env:testing-v1
docker push tfryer/sb-hello-build-env:testing-v1
このイメージで、新たに取得した GNU Hello 2.12.1 のソースを ./configure と make -j1 でビルドしました。ここで生成した original/hello が比較の基準です。
続いて、同じイメージを StableBuild の Docker ミラー経由でプルしました。
docker pull --platform linux/amd64 <stablebuild-mirror>/tfryer/sb-hello-build-env:testing-v1
この時点で StableBuild は、Docker Hub が testing-v1 として配信していた GCC 12 のイメージをキャッシュしています。
testing-v1 の GCC 13 への差し替え次に、同じタグで GCC 13.5.0 のイメージを公開しました。
docker pull --platform linux/amd64 gcc:13.5.0-bookworm
docker tag gcc:13.5.0-bookworm tfryer/sb-hello-build-env:testing-v1
docker push tfryer/sb-hello-build-env:testing-v1
これで、Docker Hub の tfryer/sb-hello-build-env:testing-v1 は GCC 13 のイメージを返すようになりました。
ローカルに残ったイメージが結果に影響しないよう、プルし直す前に Docker のキャッシュを削除しました。
docker system prune -af
そのうえで、Docker Hub から直接と StableBuild 経由の両方で testing-v1 をプルしました。
docker pull --platform linux/amd64 tfryer/sb-hello-build-env:testing-v1
docker pull --platform linux/amd64 <stablebuild-mirror>/tfryer/sb-hello-build-env:testing-v1
それぞれのイメージに入っているコンパイラのバージョンを確認します。
docker run --rm --platform linux/amd64 tfryer/sb-hello-build-env:testing-v1 gcc --version
docker run --rm --platform linux/amd64 <stablebuild-mirror>/tfryer/sb-hello-build-env:testing-v1 gcc --version
Docker Hub のイメージは GCC 13.5.0、StableBuild のイメージは GCC 12.5.0 でした。

次に、それぞれのイメージで、新たに取得した GNU Hello 2.12.1 のソースをビルドしました。ソースも ./configure と make -j1 も基準ビルドと同じです。これで3つのバイナリがそろいました。
| バイナリ | 使用した Docker イメージ |
|---|---|
original/hello |
testing-v1 の差し替え前に Docker Hub から取得した GCC 12 |
dockerhub/hello |
testing-v1 の差し替え後に Docker Hub から取得した GCC 13 |
stablebuild/hello |
testing-v1 の差し替え前に StableBuild がキャッシュした GCC 12 |
SHA-256 ハッシュを比較します。
sha256sum original/hello dockerhub/hello stablebuild/hello

original/hello と stablebuild/hello のハッシュは一致し、GCC 13 でビルドした dockerhub/hello だけが異なりました。StableBuild にキャッシュした GCC 12 のイメージを使えば、元の GNU Hello のバイナリをバイト単位で再現できるということです。
今回固定したのは、ビルド環境のうちコンパイラのイメージという一部分です。上流の Docker タグが変わった後も、元のビルドで使ったイメージを使い続けられるようにしました。
何が変わったのかは最初から分かっていたので、今回は SHA-256 の比較で十分でした。GCC 12 から GCC 13 への変更は、あえて分かりやすくしたものです。原因の分からない差分が出たときは、diffoscope で成果物を比べると、どこが違うのかを突き止められます。ビルド中に紛れ込む非決定的なデータが差分の原因になることもあり、その一部は strip-nondeterminism で正規化できます。
StableBuild が受け持つのは、これとは別の部分です。外部の依存関係が上流で変更・削除された後も、それを取得できる状態に保ちます。
今回の検証では、GCC 12 の Docker イメージがその依存関係にあたります。testing-v1 が差し替えられる前に StableBuild がキャッシュしていたからこそ、後から元のバイナリを再現できました。traefik:v3.7.13 の再ビルドは、タグはそのままにイメージだけが変わるという同じ問題が、実際に起きた例です。
外部の依存関係を保存しておくだけで、再現性の問題がすべて解決するわけではありません。それでも、再現に必要なビルド環境の一部が、上流の都合で失われることは防げます。
この考え方は Docker に限りません。StableBuild は、Ubuntu、Debian、Alpine の過去のリポジトリ、過去の状態を保持する PyPI ミラー、HuggingFace のミラー、その他の外部ファイル向けのキャッシュも提供しています。
StableBuild は Community プランなら無料で使えます。ビルドに必要な外部依存関係を、上流から消えてしまう前に保存しておきましょう。