Docker 29.10でlocalhostのレジストリーへのpushが失敗する条件と直し方|insecure-registriesの変更を29.9と比べて確認
Docker Engine 29.10で、ローカルのレジストリーの扱いが変わった
Dockerのエンジン(Docker Engine)の29.10.0が、2026年11月16日に公開されました(29.10.0のリリースノート、Docker Engine 29のリリースノート)。リリースノートは、ローカルのレジストリーへの接続の変更を「Potential breaking change」(既存の環境を壊すおそれがある変更)として最初に挙げています。
レジストリーは、コンテナーのイメージを置いておく場所です。開発やCIでは、registryのイメージをlocalhost:5000で動かし、HTTPのままpushやpullをする使い方がよくあります。Dockerは、HTTPや信頼されない証明書でつなぐことを、「insecure registry」として設定に書いたレジストリーにだけ許します。これまでは、127.0.0.0/8と::1/128(自分自身を指すループバックのアドレス)を、設定に書かなくてもinsecureとして扱っていました。
29.10.0からは、daemon.jsonのinsecure-registriesか--insecure-registryでinsecure registryを設定していると、このループバックの扱いが付かなくなります。この記事では、Docker Hubの公式イメージで29.9.3と29.10.0を動かし、設定ごとに、HTTPで動かしたローカルのレジストリーへのpushとpullを比べました。当てはまる条件、出るエラー、自分の環境の確かめ方、設定の直し方を順に説明します。
要点
insecure-registriesを設定していて、そこにlocalhostのアドレスがない環境では、29.10.0でlocalhostのHTTPのレジストリーへのpush・pullが止まった。使うアドレスを書き足すと通った
Docker Engine 29.9.3と29.10.0を、同じ設定とHTTPのレジストリーで比べた結果です。
当てはまる条件
insecure-registriesが設定されていて、使っているlocalhostのアドレスがそこにない
daemon.jsonでもフラグでも、空の配列でも同じでした。
出るエラー
pushもpullも「http: server gave HTTP response to HTTPS client」で失敗した
localhost:5000と127.0.0.1:5000のどちらでも失敗しました。
直し方
使うアドレスをinsecure-registriesに書き足すと、29.10.0でも通った
localhost:5000と127.0.0.1:5000を両方使うなら、両方を書きます。範囲で書くなら127.0.0.0/8と::1/128の両方が要りました。
変わらない場合
insecure-registriesが設定されていなければ、29.10.0でもこれまでどおり通った
29.9.3では、試した5つの設定すべてで、2つのアドレスとも通りました。
29.9.3と29.10.0で、設定ごとにpushとpullを試した結果
検証では、Docker Hubの公式イメージdocker:29.9.3-dindとdocker:29.10.0-dindを使いました。dindは、コンテナーの中でDockerのエンジンを動かすためのイメージです。それぞれの中でregistry:3を-p 5000:5000で起動し(HTTP)、busyboxのイメージをlocalhost:5000と127.0.0.1:5000へpushし、消してからpullしました。insecure-registriesの設定だけを変えて、結果を比べています。
表の見方:左の列がinsecure-registriesの設定で、3行目だけはフラグ、ほかはdaemon.jsonです。「両方」はlocalhost:5000と127.0.0.1:5000の2つのアドレスを指します。pushとpullの結果は、どの行も同じでした。
| insecure-registriesの設定 | 29.9.3 | 29.10.0 |
|---|---|---|
| 設定しない | 両方とも成功 | 両方とも成功 |
["registry.example.internal:5000"](別のレジストリーだけ) |
両方とも成功 | 両方とも失敗 |
--insecure-registry=registry.example.internal:5000(フラグ) |
両方とも成功 | 両方とも失敗 |
[](空の配列) |
両方とも成功 | 両方とも失敗 |
["registry.example.internal:5000", "localhost:5000"] |
両方とも成功 | localhost:5000は成功、127.0.0.1:5000は失敗 |
["registry.example.internal:5000", "localhost:5000", "127.0.0.1:5000"] |
(試していない) | 両方とも成功 |
["registry.example.internal:5000", "127.0.0.0/8"] |
(試していない) | localhost:5000は失敗、127.0.0.1:5000は成功 |
["registry.example.internal:5000", "127.0.0.0/8", "::1/128"] |
(試していない) | 両方とも成功 |
29.10.0で失敗したのは、insecure-registriesを設定していて(空の配列とフラグを含む)、使ったアドレスがそこに入っていない行でした。"localhost:5000"のようにhost:portの形で書いた項目は、書いた名前とポートの組み合わせにだけ効き、127.0.0.1:5000までは含みませんでした。
範囲で書く場合は、::1/128も要りました。検証したdindのコンテナーの/etc/hostsでは、localhostが127.0.0.1とIPv6の::1の両方を指していて、127.0.0.0/8だけではlocalhost:5000が失敗しました。
空の配列で既定のループバックの扱いを外せるのは、29.10.0からです。リリースノートは、"insecure-registries": []と書くと既定のinsecureの扱いをすべて無効にできると説明しています。29.9.3では、空の配列を書いてもループバックのアドレスは通りました。
失敗すると、pushもpullも「server gave HTTP response to HTTPS client」になる
29.10.0で失敗した行では、DockerがHTTPSでレジストリーにつなごうとし、HTTPで返ってきた応答を受け付けずに止まりました。手元で出た最後の行は次のとおりです(ハッシュの部分は省略しています)。
$ docker push localhost:5000/demo/busybox:1.37
…
failed to do request: Head "https://localhost:5000/v2/demo/busybox/blobs/sha256:…": http: server gave HTTP response to HTTPS client
$ docker pull localhost:5000/demo/busybox:1.37
Error response from daemon: failed to resolve reference "localhost:5000/demo/busybox:1.37": failed to do request: Head "https://localhost:5000/v2/demo/busybox/manifests/1.37": http: server gave HTTP response to HTTPS client
Dockerを29.10に上げたあと、CIのジョブやローカルの開発環境で、ローカルのレジストリーへのpushがこのメッセージで止まるようになったら、この変更が原因の候補です。
docker infoのInsecure Registriesで、自分の環境を確かめる
当てはまるかどうかは、docker infoの「Insecure Registries」の欄で確かめられます。この欄には、daemon.jsonかフラグで書いた項目と、既定で足される項目が出ます。insecure-registriesにregistry.example.internal:5000だけを書いたとき、2つの版では次のように表示が違いました。
29.9.3
Insecure Registries:
registry.example.internal:5000
127.0.0.0/8
::1/128
29.10.0
Insecure Registries:
registry.example.internal:5000
手元の比較で失敗したのは、次の3つがそろったときでした。
docker versionのServerの版が29.10.0- insecure-registriesが設定されている(daemon.json、フラグ、空の配列のどれでも)
- HTTPで動かしているレジストリーを
localhostや127.0.0.1で使っていて、そのアドレスがInsecure Registriesにない(host:portで書くなら使う名前ごとに、範囲で書くなら127.0.0.0/8と::1/128の両方が要る)
29.9以前のエンジンでは、空の配列を書いていても、Insecure Registriesに127.0.0.0/8と::1/128が出ます(29.9.3で確認)。上げる前に確かめるときは、daemon.jsonとdockerdの起動フラグを見て、insecure-registriesが設定されているか(空の配列を含む)と、使うローカルのアドレスがそこに書いてあるかを確かめます。
手元のDocker Desktop 4.79.0(Engine 29.5.3)では、利用者の設定画面のdaemon.jsonにinsecure-registriesを書いていなくても、この欄にhubproxy.docker.internal:5555が127.0.0.0/8・::1/128と並んで出ていました。Docker Desktopを使っている場合は、更新して同梱のEngineが29.10以降になったときに、docker infoで127.0.0.0/8と::1/128が残っているかを確かめます。
insecure-registriesに使うアドレスを書き足して直す
リリースノートが勧めているのは、ローカルのレジストリーを信頼できる証明書のTLSで動かす方法と、localhost:5000のように必要なアドレスだけをinsecure-registriesに書き足す方法です。HTTPのまま使うなら、書き足し方は次の2つから選べます。
使うアドレスだけを書く(リリースノートの勧め)
{
"insecure-registries": [
"registry.example.internal:5000",
"localhost:5000",
"127.0.0.1:5000"
]
}
insecureにするのは書いたアドレスだけです。CIやスクリプトでlocalhostと127.0.0.1の両方を使うなら、両方を書きます。
29.9までと同じ扱いに戻す
{
"insecure-registries": [
"registry.example.internal:5000",
"127.0.0.0/8",
"::1/128"
]
}
ループバックのアドレスのどのポートもinsecureになります。127.0.0.0/8だけではlocalhost:5000が失敗したので、::1/128も書きます。
どちらも、1行目はもともと書いていたレジストリーの例です。29.10.0で、どちらの書き方でもlocalhost:5000と127.0.0.1:5000の両方へのpushとpullが通りました。
手順1
設定を書いている場所に、アドレスを書き足す
ここからの手順は、rootで動かすLinuxのdockerdの場合です。daemon.jsonに書いているなら、daemon.jsonに書き足します。Linuxのdaemon.jsonは/etc/docker/daemon.jsonです(dockerdのリファレンス)。--insecure-registryのフラグで設定しているなら、フラグを足します。daemon.jsonとフラグの両方にinsecure-registriesを書くと、dockerdは「the following directives are specified both as a flag and in the configuration file」というエラーで起動しませんでした。
手順2
daemon.jsonなら読み直させ、フラグなら起動し直して、docker infoで確かめる
# daemon.jsonに書き足した場合
sudo systemctl reload docker
# 起動フラグを足した場合
sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A5 "Insecure Registries"
daemon.jsonのinsecure-registriesは、dockerdを止めずにSIGHUPで読み直せる項目です(dockerdのリファレンス)。Dockerのソース(moby)にあるsystemdのdocker.serviceは、systemctl reloadでSIGHUPを送る定義になっています。検証では、dindの中のdockerdにSIGHUPを送ると、動いていたレジストリーのコンテナーを止めずに設定が反映され、一覧に書き足したアドレスが出ました。起動フラグはSIGHUPでは読み直されないので、フラグで足した場合はdockerdを起動し直します。起動し直すと動いているコンテナーも止まるので、ローカルのレジストリーのコンテナーも起動し直します。
手順3
ローカルのレジストリーへpushし直す
止まっていたpushやpullを、CIのジョブなら再実行します。
insecureの一覧を増やしたくない環境では、リリースノートが挙げるもう1つの方法として、ローカルのレジストリーを信頼できる証明書のTLSで動かします。
2026年11月18日に見たdockerdのリファレンスは、ループバックのアドレスが自動でinsecureになる動きについて、将来変わりうるので頼らないよう書いています。ローカルのレジストリーを使う設定をinsecure-registriesに明示しておくと、既定の扱いがまた変わっても影響を受けにくくなります。
参考資料
- Docker Engine 29.10.0のリリースノート(GitHub)
- Docker Engine 29のリリースノート(Docker Docs)
- moby/moby #53868: daemon: do not append defaults if insecure-registries are configured
- dockerdのリファレンス(insecure registries、daemon.jsonの場所、設定の読み直し)
検証環境
- macOS 27.2.1(Apple Silicon)、Docker Desktop 4.79.0(Engine 29.5.3)
- コンテナー: docker:29.9.3-dind・docker:29.10.0-dind、registry:3、busybox:1.37
- 検証日: 2026年11月18日
この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。











