コンテナのネットワーク — localhostで繋がらないのは当然

コンテナのネットワーク。ケーブルでスイッチにつながる複数のコンテナ。

※本記事はアフィリエイト広告(PR)を含みます。

コンテナ間でlocalhostは使えません。Dockerのネットワークがどう繋がっているのかを確かめます。

前回: ボリュームでデータを残す — コンテナを消すとデータも消える

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の Composeなら1コマンドで立ち上がる の続きとして、そこでサービス名だけで繋がっていたのがなぜかを確かめる回です。

この記事のコマンドは、すべてVMの中(Ubuntu Server)で打ちます。 前提: Dockerの導入を終えて、docker ps が sudo なしで通ること。 本線で作ったものには触りません。 練習用に ~/netlab を作り、最後に全部消します。

はじめて2つのコンテナを繋ごうとしたとき、こう書きました。

bash
$ docker run -d --name api -p 3000:3000 myapi
$ docker run --rm alpine wget -qO- http://localhost:3000/
wget: can't connect to remote host (127.0.0.1): Connection refused

-p 3000:3000 で公開したのに、繋がりません。

このとき私は -p の書き方を疑って30分溶かしました。間違っていたのは localhost のほうです。 コンテナの中の localhost は、そのコンテナ自身を指します。隣のコンテナではありません。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • コンテナごとにネットワークが分かれている。だから localhost は隣に届かない
  • 既定の bridge では名前で繋がらない。名前解決が効くのはユーザー定義ネットワークだけ
  • -p 3000:3000 は「穴を開ける」のではなく、ホストの受付をコンテナへ転送している
  • -p 3000:3000 と -p 127.0.0.1:3000:3000 は意味が全く違う。前者は世界に開く
  • Docker が ufw を素通りするのは、ルールが評価される場所が違うから
  • Compose がサービス名で繋がるのは、専用のネットワークを自動で作っているから

この記事でやること

  1. コンテナを2つ立てて、localhost で繋がらないことを確かめる
  2. 既定の bridge で、IPなら繋がるが名前では繋がらないことを確かめる
  3. ユーザー定義ネットワークを作り、名前で繋がるようにする
  4. -p の中身を ss と iptables で見て、何が起きているかを確認する
  5. 127.0.0.1 にだけ公開して、外から届かないことを確かめる
  6. ホスト側のサービスへコンテナから繋ぐ
  7. Compose で同じことを書き、自動で作られるネットワークを見る

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
bridge ネットワークDocker が作る仮想的なスイッチ。既定ではここに全部繋がる
ユーザー定義ネットワークdocker network create で自分が作るネットワーク。名前解決が効く
埋め込みDNSDocker が用意する名前解決の仕組み。コンテナ名でIPを引ける
ポート公開(publish)ホストの特定ポートへの通信を、コンテナへ転送する設定。-p
DNAT宛先アドレスを書き換える仕組み。-p の実体
host ネットワーク隔離をやめて、ホストのネットワークをそのまま使う方式

① localhost で繋がらないことを確かめる

練習用のフォルダを作ります。

bash
$ mkdir -p ~/netlab && cd ~/netlab

nginx を2つ立てます。ポートは公開しません。

bash
$ docker run -d --name web1 nginx:alpine
$ docker run -d --name web2 nginx:alpine

web2 の中から localhost に繋いでみます。

bash
$ docker exec web2 wget -qO- --timeout=3 http://localhost/ | head -2
<!DOCTYPE html>
<html>

繋がります。 ただしこれは web2 自身の nginx です。web1 ではありません。

確かめます。web1 のトップページだけ書き換えます。

bash
$ docker exec web1 sh -c 'echo "<h1>web1です</h1>" > /usr/share/nginx/html/index.html'
$ docker exec web2 sh -c 'echo "<h1>web2です</h1>" > /usr/share/nginx/html/index.html'
$ docker exec web2 wget -qO- http://localhost/
<h1>web2です</h1>

web2 から localhost を叩くと、必ず web2 に返ります。

では、名前で繋げるか

bash
$ docker exec web2 wget -qO- --timeout=3 http://web1/
wget: bad address 'web1'

名前が引けません。

これが既定の bridge の性質です。 全部のコンテナが同じスイッチに繋がっているのに、名前解決だけが無い。

IPなら繋がる

web1 のIPを調べます。

bash
$ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' web1
172.17.0.2

そのIPに繋ぎます。

bash
$ docker exec web2 wget -qO- http://172.17.0.2/
<h1>web1です</h1>

繋がりました。 ネットワークとしては通っています。足りないのは名前解決だけです。

ただしIPを直書きしてはいけません。 コンテナを作り直すと番号が変わります。実際にやってみます。

bash
$ docker rm -f web1
$ docker run -d --name web1 nginx:alpine
$ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' web1
172.17.0.4

変わりました。 だから名前で繋ぐ必要があります。

スクリーンショットを撮ってください: 01_名前が引けない.png bad address 'web1' が出ている画面と、IPなら繋がっている画面を続けて撮ってください。


② ユーザー定義ネットワークを作る

自分でネットワークを作って、そこに入れます。

bash
$ docker network create labnet
$ docker network ls
NETWORK ID     NAME      DRIVER    SCOPE
xxxxxxxxxxxx   bridge    bridge    local
xxxxxxxxxxxx   host      host      local
xxxxxxxxxxxx   labnet    bridge    local
xxxxxxxxxxxx   none      null      local

2つを作り直して、labnet に入れます。

bash
$ docker rm -f web1 web2
$ docker run -d --name web1 --network labnet nginx:alpine
$ docker run -d --name web2 --network labnet nginx:alpine
$ docker exec web1 sh -c 'echo "<h1>web1です</h1>" > /usr/share/nginx/html/index.html'

名前で繋ぎます。

bash
$ docker exec web2 wget -qO- http://web1/
<h1>web1です</h1>

名前で繋がりました。

なぜ繋がるようになったのか

コンテナの中で、名前解決の設定を見ます。

bash
$ docker exec web2 cat /etc/resolv.conf
nameserver 127.0.0.11
options ndots:0

127.0.0.11 は Docker の埋め込みDNS です。ユーザー定義ネットワークに入っているコンテナは、ここに問い合わせてコンテナ名からIPを引けます。

既定の bridge では、この埋め込みDNSがコンテナ名を知りません。 昔は --link というオプションがありましたが非推奨です。ユーザー定義ネットワークを作るのが現在の答えです。

別名を付けられる

bash
$ docker rm -f web1
$ docker run -d --name web1 --network labnet --network-alias backend nginx:alpine
$ docker exec web2 wget -qO- --timeout=3 http://backend/ | head -1

backend という名前でも引けます。 コンテナ名を変えずに、呼び名だけ増やせます。

ネットワークを分けると、届かなくなる

これが隔離の使いどころです。

bash
$ docker network create dbnet
$ docker run -d --name db1 --network dbnet -e MYSQL_ROOT_PASSWORD=labpass mysql:8.0
$ docker exec web2 wget -qO- --timeout=3 http://db1:3306/ 2>&1 | head -2
wget: bad address 'db1'

web2 は labnet に、db1 は dbnet にいるので、名前すら引けません。

繋ぎたいときは、コンテナを両方のネットワークに入れます。

bash
$ docker network connect dbnet web2
$ docker exec web2 getent hosts db1
172.19.0.2       db1

引けるようになりました。

これは設計の道具です。 「Webからはアプリに届くが、Webからデータベースには届かない」という構成を、ネットワークを分けるだけで作れます。


③ -p は何をしているのか

ここまで、ホストからは1つも繋げていません。-p を付けます。

bash
$ docker rm -f web1
$ docker run -d --name web1 --network labnet -p 8080:80 nginx:alpine
$ docker exec web1 sh -c 'echo "<h1>web1です</h1>" > /usr/share/nginx/html/index.html'
$ curl http://localhost:8080/
<h1>web1です</h1>

ホストから繋がりました。 何が起きているか見ます。

bash
$ ss -tlnp | grep 8080
LISTEN 0  4096  0.0.0.0:8080  0.0.0.0:*  users:(("docker-proxy",pid=...,fd=4))

ホスト側で 0.0.0.0:8080 が開いています。

0.0.0.0 は「どこからでも受ける」という意味です。 VMのIPアドレスに対しても開いています。ホストのPCから確認できます。

PowerShell
PS> Test-NetConnection -ComputerName <VMのIPアドレス> -Port 8080

TcpTestSucceeded : True が返れば、VMの外から届いています。

転送のルールも見えます。

bash
$ sudo iptables -t nat -S DOCKER | grep 8080
-A DOCKER ! -i docker0 -p tcp -m tcp --dport 8080 -j DNAT --to-destination 172.18.0.2:80

宛先を書き換えて、コンテナへ送っています。 これが -p の実体です。

-p の書き方は4通りある

書き方ホスト側で開く場所誰から届くか
-p 8080:800.0.0.0:8080世界中から(ファイアウォール次第)
-p 127.0.0.1:8080:80127.0.0.1:8080そのマシンの中だけ
-p 8080ランダムなポート世界中から
--network hostホストのポートそのまま世界中から

データベースや管理画面には、必ず 127.0.0.1: を付けます。

試します。

bash
$ docker rm -f web1
$ docker run -d --name web1 --network labnet -p 127.0.0.1:8080:80 nginx:alpine
$ ss -tlnp | grep 8080
LISTEN 0  4096  127.0.0.1:8080  0.0.0.0:*  users:(("docker-proxy",...))

127.0.0.1 だけになりました。 VMの中からは繋がります。

bash
$ curl -s http://localhost:8080/ | head -1

ホストのPCからは届きません。

PowerShell
PS> Test-NetConnection -ComputerName <VMのIPアドレス> -Port 8080

TcpTestSucceeded : False になります。

スクリーンショットを撮ってください: 02_公開範囲の違い.png ss -tlnp の出力が 0.0.0.0:8080 の場合と 127.0.0.1:8080 の場合を、並べて撮ってください。


④ Docker が ufw を素通りする件

本線のDockerの導入で触れ、OSI参照モデルの回で理由まで見た話です。ここでは確認方法だけおさらいします。

0.0.0.0 で公開し直して、ufw で塞いでみます。

bash
$ docker rm -f web1
$ docker run -d --name web1 --network labnet -p 8080:80 nginx:alpine
$ sudo ufw deny 8080
$ sudo ufw status | grep 8080
8080                       DENY        Anywhere

拒否と出ています。 ホストのPCから叩きます。

PowerShell
PS> Test-NetConnection -ComputerName <VMのIPアドレス> -Port 8080
TcpTestSucceeded : True

届いてしまいます。

理由はOSI参照モデルの回のとおりで、Docker のルールが ufw のルールより先に評価される場所(PREROUTING の DNAT)に入っているからです。ここでは繰り返しません。

対処は1つで十分です。

外に出す必要がないものは、-p 127.0.0.1:... で公開する。 そうすれば、そもそもホストの外向きに口が開きません。ufw に頼らずに閉じられます。

ルールを戻します。

bash
$ sudo ufw delete deny 8080

この素通りは、インターネットに直接つながる VPS で同じ構成を動かすと、そのまま外からの到達経路になります。シンVPSのような小さな VPS(2026 年 9 月 1 日の料金改定後の税込月額で、大容量メモリプランの 1GB・1 コア・30GB が 1 ヶ月契約 750 円、36 ヶ月契約なら 451 円)を 1 台用意して、-p で開けたポートが ufw を抜けることを ss と iptables で確かめておくと、本番での事故を減らしやすくなります。無料のお試し期間は無く、最低利用期間は 3 ヶ月です。

⑤ ホスト側のサービスへ、コンテナから繋ぐ

逆方向です。VMのホスト側で動いているもの(たとえば本線で作った MySQL)に、コンテナから繋ぎたいことがあります。

コンテナの中の localhost は自分自身なので、これでは届きません。3つの方法があります。

方法書き方注意
① host.docker.internal--add-host=host.docker.internal:host-gatewayLinux ではこの指定が要る(Mac/Windowsでは既定で使える)
② ゲートウェイのIPip route で docker0 のIPを調べる環境で変わる
③ --network host隔離をやめる最後の手段

①を試します。

bash
$ docker run --rm --add-host=host.docker.internal:host-gateway alpine getent hosts host.docker.internal
172.17.0.1       host.docker.internal

ホスト側のアドレスが引けました。

ホスト側のサービスが 127.0.0.1 にしか待ち受けていないと、これでも届きません。 ホスト側で ss -tlnp を見て、0.0.0.0 か 172.17.0.1(既定のブリッジ docker0 のアドレス。環境によって違います)で待っている必要があります。そこを緩めるのは、外部に開くのと同じ意味なので、慎重に判断してください。

--network host を安易に使わない

bash
$ docker run --rm --network host alpine ss -tln 2>/dev/null | head -5

ホストと同じネットワークが見えます。 楽ですが、

  • ポートがホストと衝突する(同じポートを2つ起動できない)
  • 隔離が消える。コンテナから 127.0.0.1 経由でホストの全サービスに届く
  • -p が効かなくなる(無視される)

性能が要る特殊な場合を除いて、使いません。


⑥ Compose では何が起きているか

同じことを Compose で書きます。

bash
$ cd ~/netlab

compose.yaml を作ります。

services:
  web:
    image: nginx:alpine
    ports:
      - "127.0.0.1:8081:80"
  api:
    image: nginx:alpine

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: labpass
    networks:
      - backend

networks:
  backend:

起動します。

bash
$ docker compose up -d
$ docker network ls | grep netlab
xxxxxxxxxxxx   netlab_default   bridge    local
xxxxxxxxxxxx   netlab_backend   bridge    local

ネットワークが自動で作られています。 名前は <フォルダ名>_<ネットワーク名> です。

サービス名で繋がることを確認します。

bash
$ docker compose exec web wget -qO- --timeout=3 http://api/ | head -1
<!DOCTYPE html>

api という名前で引けました。 Compose は既定で default ネットワークを作り、全サービスをそこに入れます。 だから何も書かなくてもサービス名で繋がります。本線で「なぜか繋がった」のはこれが理由です。

db はどうでしょうか。

bash
$ docker compose exec web getent hosts db
(何も出ない)

引けません。 db だけ networks: [backend] と書いたので、default から外れたからです。

networks: を1つでも書くと、そのサービスは default に入りません。 両方に入れたければ、両方書きます。

  db:
    networks:
      - default
      - backend

つまずいたところ

docker exec web2 wget http://web1/ が bad address で、DNSの設定を疑って1時間溶かした。 原因は既定の bridge にいたことでした。ネットワークを作ったかどうかを最初に確認する(docker inspect -f '{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}' web2)のを型にしました。

docker network create したのに繋がらない。 既存のコンテナは、作り直さないと新しいネットワークに入りません。 docker network connect で後から足すか、docker rm して --network 付きで起動し直します。

-p 8080:80 の左右をよく間違える。 左がホスト、右がコンテナです。逆に書くと「ホストの80番を、コンテナの8080番へ」という意味になり、コンテナ側で何も待っていないので Connection refused になります。ss -tlnp でホスト側に何番が開いたかを見ると一発で分かります。

curl localhost:8080 は通るのに、ホストのPCから届かない。 -p 127.0.0.1:8080:80 にしていました。これは意図どおりです。ただし気づくのに時間がかかったので、ss -tlnp の出力を必ず見るようにしました。

ufw で塞いだのに届いて、ufw が壊れたと思った。 OSI参照モデルの回で仕組みを見ていたのに、実際に踏むとまず ufw を疑ってしまいました。知っているのと、症状から結び付けられるのは別でした。

--network host で全部解決しようとした。 2つ目のコンテナが同じポートで起動できず、そこで気づきました。隔離を捨てると、隔離が理由で防げていた事故も戻ってきます。


後片づけ

bash
$ cd ~/netlab && docker compose down
$ docker rm -f web1 web2 db1 2>/dev/null
$ docker network rm labnet dbnet 2>/dev/null
$ docker network ls

ufw の設定が戻っているか確認します。

bash
$ sudo ufw status | grep 8080

何も出なければ戻っています。

bash
$ docker volume prune -f
$ cd ~ && rm -rf ~/netlab
$ docker rmi nginx:alpine mysql:8.0 alpine 2>/dev/null
$ docker system df

まとめ — 理解できたこと

  • コンテナの中の localhost は、そのコンテナ自身。隣のコンテナには届かない
  • 既定の bridge は、繋がるが名前が引けない。IPなら届くが、IPは作り直すたびに変わる
  • ユーザー定義ネットワークを作ると、埋め込みDNS(127.0.0.11)でコンテナ名が引ける
  • --link は非推奨。ネットワークを作るのが現在の答え
  • ネットワークを分けると、名前すら引けなくなる。これが隔離の設計道具になる
  • -p 8080:80 の実体は DNAT。ss と iptables -t nat -S DOCKER で目に見える
  • -p 8080:80 は世界に開く。-p 127.0.0.1:8080:80 はそのマシンの中だけ
  • Docker は ufw を素通りする。対処は ufw ではなくそもそも 127.0.0.1 で公開すること
  • ホスト側へは --add-host=host.docker.internal:host-gateway。Linux では明示が要る
  • --network host は隔離を捨てる。ポート衝突と引き換えなので、最後の手段
  • Compose は default ネットワークを自動で作る。だからサービス名で繋がる
  • networks: を1つでも書くと、そのサービスは default から外れる

参考リンク


次に読む

この記事は 【深掘り】Docker の 6 / 11 本目です。

記事
← 前の記事ボリュームでデータを残す — コンテナを消すとデータも消える
→ 次の記事docker runのオプションを5つに分ける — 長い1行が読めない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Docker — Networking
  • bridge とユーザー定義ネットワーク / 埋め込みDNS
  • ポート公開(-p)の実体と公開範囲

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次