容器之間怎麼連線?Docker Network 與 Port 對應實作

容器之間怎麼連線:放進同一個自訂 Docker Network,用容器名稱當位址;外面要連進來,再用 -p 做 Port 對應。

前幾篇的容器都是「一個人在跑」。真實的網站至少有兩個角色:一個負責網頁的程式,一個負責存資料的資料庫。它們各自住在自己的容器裡,就會遇到一個新問題:網頁程式要怎麼找到資料庫?

這篇用一個「部門留言板」(Python Flask+MySQL 8)實際做一次。你會親眼看到:用 localhost 連不到、用 IP 連得到但不該用、建一個自訂網路之後用名字就連上了。最後再開第二個網頁容器,用不同的 Port 對外,兩邊看到同一份資料。

這是「容器系列」的第 6 篇,全部在免費的 Cloud Shell 實際跑過,輸出都是真實結果(2026 年 10 月實測,Docker 29.8.1、MySQL 8.0.46)。還沒用過 Cloud Shell 的話,先看第 1 篇:Docker 入門教學。

localhost 是「我自己」,每個容器都有自己的家;自訂 Docker Network 像公司內線電話簿,喊名字就轉接到對的容器

為什麼你需要知道

  • 網站加資料庫是最基本的架構:只要你的程式要存資料,就一定會有「程式容器連資料庫容器」這件事,連不上整個網站就是 500 錯誤
  • 新手最常卡在這裡:照著網路教學把兩個容器開起來,程式裡寫 localhost,怎麼試都連不上,因為容器的 localhost 跟你想的不一樣
  • Port 開錯會有資安風險:Docker 的 -p 預設是對外全開,資料庫的 Port 不小心開出去,等於把資料庫放在網路上給人試密碼
  • 面試和 Kubernetes 的基礎:「容器之間怎麼通訊」「為什麼要用服務名稱不用 IP」是 Docker 面試常見題,到了 Kubernetes 就變成 Service 和叢集 DNS

先搞懂兩件事:Port 和 IP

Port 是什麼?

Port(連接埠)是同一台電腦上,用來分辨「這個連線要交給哪個程式」的號碼。

比喻:IP 位址像一棟大樓的地址,Port 像大樓裡的分機號碼。信送到大樓(IP),還要看分機號碼(Port)才知道要轉給哪個部門。

來龍去脈:一台電腦常常同時跑好幾個需要網路的程式,例如網站和資料庫。網路封包抵達時,作業系統要知道該交給誰,所以網路協定設計了 0 到 65535 這 65,536 個號碼(2 的 16 次方)。有些號碼大家約定俗成,例如網站 80、加密網站 443、MySQL 3306。

為什麼要學:容器裡的程式也在某個 Port 上等連線,但容器預設外面連不到。要讓瀏覽器連進來,就得用 -p 把外面的 Port 接到容器裡的 Port,這叫 Port 對應(Port Mapping),第 1 篇的 -p 8080:80 就是它。

IP 位址是什麼?

IP 位址是網路上每台機器(或每個容器)的門牌號碼,像 172.17.0.2 這樣四組數字。Docker 會自動發一個 IP 給每個容器,這個 IP 只在 Docker 內部的網路有效,外面的網路看不到。

Port 對應的寫法

寫法意思誰連得到
-p 8080:80主機的 8080 接到容器的 80主機的所有網路介面(官方文件說預設綁 0.0.0.0 和 [::])
-p 127.0.0.1:8080:80只綁在主機的 127.0.0.1只有主機自己
不寫 -p不對外開放只有同一個 Docker 網路裡的容器

記法:冒號左邊是外面(主機),右邊是容器裡面。

Docker 官方文件(2026 年 11 月查)講得很直白:發布 Port 預設是不安全的,因為它不只對主機開放,也可能對外面的網路開放。在自己的電腦或伺服器上,只想自己用的服務,記得加 127.0.0.1:。Cloud Shell 本身不會讓外人連進來,所以這篇照一般寫法。


容器的 localhost,不是你以為的 localhost

localhost 的意思不是「這台電腦」,而是「我自己」。

在你的筆電上,localhost 就是筆電本身。但每個容器都有自己獨立的網路空間(Linux 的 Network Namespace,可以想成每個容器有自己的一套網路卡和門牌),所以在容器裡說 localhost,指的是這個容器自己。

比喻:你在自己家裡喊「廚房」,指的是你家的廚房,不會喊到鄰居家的廚房。網頁容器在自己家喊 localhost,當然找不到住在隔壁的資料庫容器。

那用 IP 呢?每個容器確實有 IP,也連得到,但不該寫進程式,原因有三個:

問題說明
會變容器刪掉重建,IP 可能就換了,程式設定跟著失效
事先不知道寫程式的時候,你不知道資料庫啟動後會拿到哪個 IP
沒有意義172.17.0.2 看不出是誰,三個月後連你自己都忘了

比喻:跟朋友約「在紅色屋頂那間房子見」,結果房東上週把屋頂漆成藍色了。


Docker Network 是什麼?

白話是什麼

Docker Network 是 Docker 幫容器建立的虛擬網路,同一個網路裡的容器可以互相連線,不同網路的容器彼此看不到。你可以自己建網路、把容器放進去。

來龍去脈:為什麼要自己建網路

Docker 一安裝好就有三個網路:

名稱驅動(Driver)用途
bridgebridge預設網路,沒指定 --network 的容器都放這裡
hosthost容器直接用主機的網路,沒有隔離
nonenull完全沒有網路

「驅動(Driver)」可以想成網路的種類,最常用的是 bridge(橋接):Docker 在主機上做一座虛擬的橋,把容器接在橋上互通。

關鍵在這裡:Docker 官方文件(2026 年 11 月查)寫明,預設的 bridge 網路裡,容器之間只能用 IP 互連;你自己建立的 bridge 網路(user-defined bridge),容器可以直接用名字找到彼此。官方也建議正式環境不要用預設 bridge,改用自己建的網路。

為什麼用名字就找得到?官方文件說明,接在自訂網路上的容器,會使用 Docker 內建的 DNS 伺服器(位址是 127.0.0.11),文章後面的加碼實驗會親眼看到。DNS 的工作就是「把名字翻成 IP」,你在瀏覽器打網址,背後也是 DNS 在翻譯。

比喻:自訂網路像公司的內線電話簿。你不用記「分機 2847」,只要跟總機說「找財務部的陳小姐」,總機就幫你轉過去;陳小姐換了座位、換了分機,你照樣找得到她。

為什麼要學

只要有兩個以上的容器要合作(網站+資料庫、網站+快取),就一定要用自訂網路。這也是為什麼 docker run 一定要加 --name:容器的名字,就是它在網路上的身分。

老教學裡的 --link 還能用嗎? 以前預設 bridge 不能用名字互連,所以有 --link 這個參數。官方文件(2026 年 11 月查)已經把它列為棄用:Docker Engine 29.6 起使用會出現警告,預計在 30.0 移除。看到教學還在用 --link,就知道它過時了,改用自訂網路。

預設 bridge 和自訂 bridge 網路的比較:只能用 IP 對照可以用容器名稱、內建 DNS 127.0.0.11、官方建議

動手做:Flask 留言板連 MySQL

在 test27 的 Cloud Shell(不用建專案、不用綁信用卡)實作,大約 25 分鐘,不花錢。截圖裡的提示字元有縮短,你的畫面會是「你的帳號@cloudshell:~/docker-course$」。

我們要做的東西長這樣:

留言板架構:瀏覽器透過 -p 8080:8080 連到 msgapp 容器,msgapp 在 msgboard-net 網路裡用名字 msgdb 連 MySQL,資料存在 msgdb-data Volume

先建一個練習用的資料夾:

mkdir -p ~/docker-course && cd ~/docker-course

步驟 1:先故意犯錯,MySQL 沒給密碼會怎樣

直接開一個 MySQL 8.0 容器,什麼設定都不給,等 6 秒再看狀態:

docker run -d --name testdb mysql:8.0
sleep 6; docker ps -a
Unable to find image 'mysql:8.0' locally
8.0: Pulling from library/mysql
96d30d9fbee8: Pull complete
297d04cfe470: Pull complete
(中間省略)
Digest: sha256:7dcddc01f13bab2f15cde676d44d01f61fc9f99fe7785e86196dfc07d358ae2b
Status: Downloaded newer image for mysql:8.0
88f199c40c3b45e35501ae6035a29ac552461fff466de17c6c7e56a7d55f7cc4
CONTAINER ID   IMAGE       COMMAND                  CREATED          STATUS                      PORTS     NAMES
88f199c40c3b   mysql:8.0   "docker-entrypoint.s…"   48 seconds ago   Exited (1) 44 seconds ago             testdb
docker run 沒給密碼的 MySQL 容器,docker ps -a 顯示 Exited (1),容器一啟動就結束

Exited (1):容器啟動 4 秒就結束了。第 2 篇講過,結束代碼 0 是正常結束,不是 0 就是出事了。容器出事的第一個動作,永遠是看日誌:

docker logs testdb
2026-10-06 08:02:32+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.46-1.el9 started.
2026-10-06 08:02:32+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql'
2026-10-06 08:02:32+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.46-1.el9 started.
2026-10-06 08:02:32+00:00 [ERROR] [Entrypoint]: Database is uninitialized and password option is not specified
    You need to specify one of the following as an environment variable:
    - MYSQL_ROOT_PASSWORD
    - MYSQL_ALLOW_EMPTY_PASSWORD
    - MYSQL_RANDOM_ROOT_PASSWORD
docker logs testdb 顯示 MySQL 錯誤:Database is uninitialized and password option is not specified,要求設定 MYSQL_ROOT_PASSWORD

MySQL 拒絕啟動,因為沒給管理員密碼。這是 MySQL 官方映像檔刻意的安全設計。記住這個排錯順序:docker ps -a 看狀態 → docker logs 看它說什麼。

把失敗的容器刪掉:

docker rm testdb
testdb

步驟 2:用環境變數正確啟動 MySQL

環境變數(Environment Variable)是在程式啟動時,從外面塞給它的設定值,用 -e 名字=值 傳進容器。程式不用改,換個值就換個設定。

docker run -d \
  --name msgdb \
  -e MYSQL_ROOT_PASSWORD=RootPass123 \
  -e MYSQL_DATABASE=msgboard \
  -e MYSQL_USER=appuser \
  -e MYSQL_PASSWORD=AppPass123 \
  -v msgdb-data:/var/lib/mysql \
  mysql:8.0
972d694ce419784703f8d668079e3b766b2124ac4bf9dddcfa725f1a9b5b116a
用四個 -e 環境變數和 -v msgdb-data:/var/lib/mysql 啟動 msgdb 容器

每一行的意思(行尾的 \ 代表「指令還沒完,下一行接著」):

參數作用
--name msgdb容器名字,等一下它就是網路位址
-e MYSQL_ROOT_PASSWORD管理員(root)密碼,MySQL 官方映像檔規定必填
-e MYSQL_DATABASE啟動時自動建立 msgboard 資料庫
-e MYSQL_USER/MYSQL_PASSWORD自動建立程式專用帳號 appuser,對 msgboard 有完整權限
-v msgdb-data:/var/lib/mysql資料存進 Volume,刪掉容器資料還在(第 5 篇的觀念)

為什麼另外建 appuser,不直接用 root? 這叫最小權限原則:程式只拿到它需要的權限。root 可以刪掉整台資料庫伺服器,appuser 只能動 msgboard 這一個資料庫。萬一程式被入侵,損害範圍差很多。

密碼寫在指令裡只適合練習。指令會留在終端機的歷史紀錄,用 history 就撈得出來。第 7 篇會改用 .env 檔管理密碼。

看一下狀態:

docker ps
CONTAINER ID   IMAGE       COMMAND                  CREATED         STATUS         PORTS                 NAMES
972d694ce419   mysql:8.0   "docker-entrypoint.s…"   6 seconds ago   Up 6 seconds   3306/tcp, 33060/tcp   msgdb
docker ps 顯示 msgdb 在執行中,PORTS 欄是 3306/tcp, 33060/tcp,沒有對外開放

注意 PORTS 欄只寫 3306/tcp, 33060/tcp,前面沒有 0.0.0.0:。這代表 MySQL 在容器裡的 3306 等連線,但沒有對外開放,外面連不進來。資料庫本來就不該讓外面直接連,這正是我們要的。

步驟 3:等 MySQL 準備好

MySQL 第一次啟動要初始化資料庫、建帳號,比網頁伺服器慢很多。用 -f 即時看日誌:

docker logs -f msgdb

一長串訊息跑完後,看到 port: 3306 那行的 ready for connections,就代表準備好了,按 Ctrl + C 離開:

(中間省略)
2026-10-06T08:03:52.296810Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.46'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  MySQL Community Server - GPL.
MySQL 日誌出現 ready for connections,port 3306,代表資料庫可以連線了

實測日誌裡其實出現兩次 ready for connections:08:03:45 那次後面寫 port: 0,是初始化用的臨時伺服器;接著 08:03:49 建資料庫 msgboard、建帳號 appuser,到 08:03:52 才是正式的 port: 3306。光是這段就隔了 7 秒,「資料庫要一段時間才準備好」等一下會變成一個重要的觀念。

步驟 4:進資料庫建一張留言表

用第 2 篇學的 docker exec 進到容器裡,執行 MySQL 的指令工具:

docker exec -it msgdb mysql -u appuser -pAppPass123 msgboard

(-p 和密碼中間沒有空格,這是 MySQL 的規則。會先印一行 [Warning] Using a password on the command line interface can be insecure.,是提醒不是錯誤。)

出現 mysql> 之後,貼上這兩段 SQL(建表格、新增一筆資料):

CREATE TABLE messages (
  id INT AUTO_INCREMENT PRIMARY KEY,
  author VARCHAR(50) NOT NULL,
  content TEXT NOT NULL,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
INSERT INTO messages (author, content) VALUES ('system', 'message board is live');
EXIT;
Query OK, 0 rows affected (0.03 sec)

Query OK, 1 row affected (0.01 sec)

Bye
在 MySQL 裡建立 messages 資料表,再 INSERT 一筆 system 的測試留言,兩個都回 Query OK

測試資料刻意用英文:容器裡的 mysql 指令工具在 Cloud Shell 會吞掉中文輸入,等一下從網頁送出的中文留言則完全正常(實測)。

步驟 5:用 localhost 連,失敗

現在假裝自己是網頁程式,開一個臨時的 MySQL 容器(--rm:用完自動刪掉),試著用 localhost 連資料庫:

docker run --rm -it mysql:8.0 mysql -h localhost -u appuser -pAppPass123 msgboard
mysql: [Warning] Using a password on the command line interface can be insecure.
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
在臨時容器裡用 localhost 連 MySQL,出現 ERROR 2002 Can't connect to local MySQL server

連不上。臨時容器說的 localhost 是它自己,而它自己裡面根本沒有在跑 MySQL 伺服器。這就是「在自己家喊廚房」。

步驟 6:查容器的 IP

docker inspect msgdb | grep '"IPAddress"'
                    "IPAddress": "172.17.0.2",
docker inspect msgdb 查到容器 IP 是 172.17.0.2

docker inspect 會印出容器的所有設定,grep 是只挑出包含某段文字的那幾行。msgdb 拿到 172.17.0.2,這是預設 bridge 網路發的 IP。用 IP 連是會通的,但前面說過三個理由,不要寫進程式。

步驟 7:看看現有的網路

docker network ls
NETWORK ID     NAME      DRIVER    SCOPE
1a6c5b63677e   bridge    bridge    local
ba1854d013ba   host      host      local
f23db9e117dc   none      null      local
docker network ls 列出 Docker 預設的三個網路:bridge、host、none

就是前面表格的三個預設網路。msgdb 目前就住在 bridge 裡,而預設 bridge 不支援用名字互連。

步驟 8:建立自訂網路

docker network create msgboard-net
docker network ls
d45a220f8d28401a54aabe6d96162e91abc4692eb2fc8ff8deff6241e9d2e5d1
NETWORK ID     NAME           DRIVER    SCOPE
1a6c5b63677e   bridge         bridge    local
ba1854d013ba   host           host      local
d45a220f8d28   msgboard-net   bridge    local
f23db9e117dc   none           null      local
docker network create msgboard-net 建立自訂網路,docker network ls 多了 msgboard-net,驅動是 bridge

多了 msgboard-net,驅動一樣是 bridge,但它是自己建的,所以有內建 DNS、可以用名字互連。

步驟 9:把資料庫接上新網路

msgdb 已經在跑了,不用重開,直接把它「接」上新網路:

docker network connect msgboard-net msgdb
docker network inspect msgboard-net | grep -A 3 Containers
        "Containers": {
            "972d694ce419784703f8d668079e3b766b2124ac4bf9dddcfa725f1a9b5b116a": {
                "Name": "msgdb",
                "EndpointID": "0789dc136552639dd777a2dcde60608d8a413a5f9a18af6b55c2f75a2aef2551",
docker network connect 把 msgdb 接上 msgboard-net,inspect 確認 Containers 裡有 msgdb

grep -A 3 是「找到那行之後,再多印 3 行」。msgboard-net 的成員名單(Containers)裡出現了 msgdb。一個容器可以同時接好幾個網路。

更乾淨的做法是開容器時直接加 --network msgboard-net,步驟 15 重建資料庫時就會這樣寫。這裡分兩步,是讓你看到網路可以事後再接。

步驟 10:用名字連資料庫,成功

一樣開臨時容器,但這次放進同一個網路,主機位址直接寫容器名稱 msgdb:

docker run --rm -it \
  --network msgboard-net \
  mysql:8.0 \
  mysql -h msgdb -u appuser -pAppPass123 msgboard
mysql: [Warning] Using a password on the command line interface can be insecure.
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 9
Server version: 8.0.46 MySQL Community Server - GPL
(中間省略)
mysql>
臨時容器加上 --network msgboard-net,用 -h msgdb 容器名稱連線成功,出現 mysql> 提示字元

通了。查一下剛剛那筆資料:

SELECT * FROM messages;
+----+--------+-----------------------+---------------------+
| id | author | content               | created_at          |
+----+--------+-----------------------+---------------------+
|  1 | system | message board is live | 2026-10-06 08:05:04 |
+----+--------+-----------------------+---------------------+
1 row in set (0.00 sec)
用容器名稱連進 MySQL 後 SELECT,看到 system 那筆 message board is live

輸入 EXIT; 離開,臨時容器因為有 --rm 會自動消失。

整篇最重要的一件事就在這兩步:同樣是臨時容器,差別只在有沒有 --network msgboard-net,以及位址從 localhost 換成 msgdb。

步驟 11:寫留言板程式

建一個專案資料夾,用 cat > 檔名 <<'EOF' 把檔案內容整段貼上(從 cat 那行貼到最後的 EOF,按 Enter 就建好檔案,不用學編輯器):

mkdir -p ~/docker-course/msgboard && cd ~/docker-course/msgboard

app.py(留言板程式,很長,整段複製貼上就好):

cat > app.py <<'EOF'
from flask import Flask, request, redirect
from datetime import datetime
import os
import socket
import time
import pymysql

app = Flask(__name__)

# 從環境變數讀取資料庫連線設定(絕不寫死在程式裡)
DB_HOST = os.environ.get("DB_HOST", "localhost")
DB_USER = os.environ.get("DB_USER", "appuser")
DB_PASSWORD = os.environ.get("DB_PASSWORD", "")
DB_NAME = os.environ.get("DB_NAME", "msgboard")


def get_connection():
    """建立資料庫連線"""
    return pymysql.connect(
        host=DB_HOST,
        user=DB_USER,
        password=DB_PASSWORD,
        database=DB_NAME,
        charset="utf8mb4",
        cursorclass=pymysql.cursors.DictCursor,
    )


def wait_for_db(max_retry=30):
    """等待資料庫就緒,最多重試 30 次"""
    for i in range(max_retry):
        try:
            conn = get_connection()
            conn.close()
            print("資料庫連線成功", flush=True)
            return True
        except Exception as e:
            print(f"等待資料庫中... ({i+1}/{max_retry}) {e}", flush=True)
            time.sleep(2)
    return False


def init_table():
    """建立資料表(如果不存在)"""
    conn = get_connection()
    with conn.cursor() as cur:
        cur.execute("""
            CREATE TABLE IF NOT EXISTS messages (
                id INT AUTO_INCREMENT PRIMARY KEY,
                author VARCHAR(50) NOT NULL,
                content TEXT NOT NULL,
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
            )
        """)
    conn.commit()
    conn.close()
    print("資料表已就緒", flush=True)


@app.route("/", methods=["GET"])
def home():
    conn = get_connection()
    with conn.cursor() as cur:
        cur.execute(
            "SELECT author, content, created_at FROM messages "
            "ORDER BY id DESC LIMIT 20"
        )
        rows = cur.fetchall()
    conn.close()

    hostname = socket.gethostname()

    items = ""
    for r in rows:
        items += f"""
        <div class="msg">
          <div class="meta">{r['author']} ・ {r['created_at']}</div>
          <div class="text">{r['content']}</div>
        </div>
        """

    if not items:
        items = '<div class="empty">還沒有留言,來寫第一則吧</div>'

    return f"""
    <!DOCTYPE html>
    <html lang="zh-Hant">
    <head>
      <meta charset="UTF-8">
      <title>部門留言板</title>
      <style>
        body {{
          font-family: "Helvetica Neue", Arial, sans-serif;
          background: #f4f6f8; margin: 0; padding: 40px 20px;
        }}
        .wrap {{ max-width: 640px; margin: 0 auto; }}
        h1 {{ color: #2c3e50; margin-bottom: 4px; }}
        .host {{ color: #95a5a6; font-size: 13px; margin-bottom: 24px; }}
        .box {{
          background: #fff; padding: 20px; border-radius: 10px;
          box-shadow: 0 2px 8px rgba(0,0,0,0.08); margin-bottom: 20px;
        }}
        input, textarea {{
          width: 100%; padding: 10px; margin-bottom: 10px;
          border: 1px solid #dfe4e8; border-radius: 6px;
          font-size: 15px; box-sizing: border-box;
          font-family: inherit;
        }}
        button {{
          background: #2d8cf0; color: #fff; border: none;
          padding: 10px 24px; border-radius: 6px;
          font-size: 15px; cursor: pointer;
        }}
        .msg {{
          background: #fff; padding: 16px 20px; border-radius: 10px;
          margin-bottom: 10px; box-shadow: 0 1px 4px rgba(0,0,0,0.06);
        }}
        .meta {{ color: #95a5a6; font-size: 13px; margin-bottom: 6px; }}
        .text {{ color: #2c3e50; font-size: 16px; }}
        .empty {{ color: #95a5a6; text-align: center; padding: 30px; }}
      </style>
    </head>
    <body>
      <div class="wrap">
        <h1>部門留言板</h1>
        <div class="host">服務容器:{hostname}</div>
        <div class="box">
          <form method="POST" action="/post">
            <input name="author" placeholder="你的名字" required>
            <textarea name="content" rows="3" placeholder="想說什麼?" required></textarea>
            <button type="submit">送出留言</button>
          </form>
        </div>
        {items}
      </div>
    </body>
    </html>
    """


@app.route("/post", methods=["POST"])
def post():
    author = request.form.get("author", "").strip()
    content = request.form.get("content", "").strip()

    if author and content:
        conn = get_connection()
        with conn.cursor() as cur:
            cur.execute(
                "INSERT INTO messages (author, content) VALUES (%s, %s)",
                (author, content),
            )
        conn.commit()
        conn.close()

    return redirect("/")


@app.route("/health")
def health():
    try:
        conn = get_connection()
        conn.close()
        return {"status": "ok", "db": "connected"}
    except Exception:
        return {"status": "error", "db": "disconnected"}, 500


if __name__ == "__main__":
    if wait_for_db():
        init_table()
    app.run(host="0.0.0.0", port=8080)
EOF

requirements.txt、Dockerfile、.dockerignore(三個檔案一次貼):

cat > requirements.txt <<'EOF'
flask==3.0.3
pymysql==1.1.1
cryptography==43.0.3
EOF
cat > Dockerfile <<'EOF'
FROM python:3.12-slim

WORKDIR /app

# 先複製套件清單並安裝(變動頻率低,放前面)
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 最後才複製程式碼(變動頻率高,放後面)
COPY app.py .

EXPOSE 8080

CMD ["python", "app.py"]
EOF
cat > .dockerignore <<'EOF'
__pycache__/
*.pyc
.git/
.env
*.key
venv/
EOF

程式裡跟這篇主題有關的設計有三個:

設計程式碼為什麼
連線設定從環境變數來DB_HOST = os.environ.get("DB_HOST", ...)同一個映像檔,開發時連 msgdb、上雲端連 Cloud SQL,程式不用改
等資料庫準備好wait_for_db() 每 2 秒試一次,最多 30 次步驟 3 看到 MySQL 要好幾秒才 ready,程式比它先起來就會連不上
健康檢查網址/health 回傳資料庫有沒有連上讓人和機器都能快速判斷服務正不正常

wait_for_db() 最多等 30 次 × 2 秒=60 秒。步驟 3 實測 MySQL 從臨時伺服器到正式可連就隔了 7 秒,60 秒的緩衝很夠;如果等太短(例如 2 次 × 2 秒=4 秒),程式就會在資料庫還沒好時放棄。

requirements.txt 為什麼有 cryptography? MySQL 8 預設用一種加密的登入方式(caching_sha2_password)。PyMySQL 官方說明寫,要用這種登入方式,需要另外安裝 PyMySQL[rsa] 這組相依套件;我們實測直接加錯誤訊息點名要的 cryptography 也能解決。少了它,資料庫重建之後程式會出現 RuntimeError: 'cryptography' package is required for sha256_password or caching_sha2_password auth methods(實測踩過,見「實測時的意外」)。

另外 cursor.execute(... VALUES (%s, %s)", (author, content)) 這種寫法叫參數化查詢,可以防止別人在留言欄位塞 SQL 指令搞破壞(SQL Injection)。跟 Docker 無關,但寫資料庫程式一定要這樣寫。

步驟 12:建置映像檔

docker build -t msgboard:v1 .
[+] Building 10.4s (10/10) FINISHED                                    docker:default
 => [internal] load build definition from Dockerfile                             0.0s
 => => transferring dockerfile: 332B                                             0.0s
 => [internal] load metadata for docker.io/library/python:3.12-slim              0.2s
 => [internal] load .dockerignore                                                0.0s
 => => transferring context: 83B                                                 0.0s
 => [1/5] FROM docker.io/library/python:3.12-slim@sha256:ddb0207ae1f0356c2b724d740769b0c5f5f51cc54a0525178f721825f78fe74c
(中間省略)
 => [3/5] COPY requirements.txt .                                                0.0s
 => [4/5] RUN pip install --no-cache-dir -r requirements.txt                     7.3s
 => [5/5] COPY app.py .                                                          0.1s
 => exporting to image                                                           2.5s
(中間省略)
 => => naming to docker.io/library/msgboard:v1                                   0.0s
 => => unpacking to docker.io/library/msgboard:v1                                0.6s
docker build -t msgboard:v1 建置留言板映像檔,10.4 秒完成,pip install 花 7.3 秒

Dockerfile 怎麼寫、為什麼 requirements.txt 要先複製,第 4 篇有完整說明。這裡 10.4 秒建好,其中 7.3 秒花在 pip install 安裝套件。

步驟 13:啟動網頁容器,放進同一個網路

這是整篇的重點指令:

docker run -d \
  --name msgapp \
  --network msgboard-net \
  -p 8080:8080 \
  -e DB_HOST=msgdb \
  -e DB_USER=appuser \
  -e DB_PASSWORD=AppPass123 \
  -e DB_NAME=msgboard \
  msgboard:v1
0ca613f0e81d7f39cdeaf7d4f92aed707aff92507fedd309520076c501e9d3d8
啟動 msgapp 容器:--network msgboard-net、-p 8080:8080、-e DB_HOST=msgdb

三個關鍵參數各管一件事:

參數管什麼方向
--network msgboard-net跟資料庫住在同一個網路容器 ↔ 容器
-e DB_HOST=msgdb資料庫的位址就是它的容器名字容器 ↔ 容器
-p 8080:8080讓瀏覽器連得進來外面 → 容器

Port 對應管「外面進來」,Docker Network 管「容器之間」,兩件事分開想就不會亂。

看看程式的日誌:

docker logs msgapp
資料庫連線成功
資料表已就緒
 * Serving Flask app 'app'
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:8080
 * Running on http://172.18.0.3:8080
Press CTRL+C to quit
docker logs msgapp 顯示資料庫連線成功、資料表已就緒,Flask 在 172.18.0.3:8080 執行

「資料庫連線成功」:程式用 msgdb 這個名字找到了資料庫。紅字 WARNING 是 Flask 提醒「這是開發用伺服器」,不是錯誤。

注意最後一行 172.18.0.3:msgapp 的 IP 是 172.18 開頭,跟步驟 6 預設 bridge 的 172.17.0.2 不同,因為 msgboard-net 是另一個網段。也因為 IP 每個網路都不一樣,程式更不該寫死 IP。

步驟 14:用瀏覽器打開留言板

點 Cloud Shell 右上角的「網頁預覽」→「透過以下通訊埠預覽:8080」(第 1 篇有圖解)。留兩則言試試:

部門留言板網頁,服務容器 0ca613f0e81d,有三則留言:阿德、小東和 system 那筆 message board is live

你會看到步驟 4 用 SQL 塞的那筆 message board is live,加上剛剛從網頁送出的中文留言。頁面上的「服務容器:0ca613f0e81d」是容器 ID 的前 12 碼,等一下用來分辨是哪個容器回應的。

步驟 15:刪掉資料庫,換一個新的,名字照樣找得到

先記下現在有幾則留言:

curl -s localhost:8080 | grep -c 'class="msg"'
3

把資料庫容器整個刪掉:

docker stop msgdb
docker rm msgdb
docker ps -a
msgdb
msgdb
CONTAINER ID   IMAGE         COMMAND           CREATED              STATUS              PORTS                    NAMES
0ca613f0e81d   msgboard:v1   "python app.py"   About a minute ago   Up About a minute   0.0.0.0:8080->8080/tcp   msgapp
docker stop、docker rm 刪掉 msgdb,docker ps -a 只剩 msgapp,PORTS 是 0.0.0.0:8080->8080/tcp

順便對照 PORTS 欄:msgapp 是 0.0.0.0:8080->8080/tcp,代表主機所有介面的 8080 都接進來;步驟 2 的 MySQL 只有 3306/tcp,沒有對外。

資料庫不在了,健康檢查馬上反映出來:

curl -s localhost:8080/health
{"db":"disconnected","status":"error"}
資料庫刪掉後,curl /health 回傳 db disconnected、status error

用全新的容器、同一個名字、同一個 Volume 重建資料庫,這次開的時候直接加 --network,一步到位:

docker run -d \
  --name msgdb \
  --network msgboard-net \
  -e MYSQL_ROOT_PASSWORD=RootPass123 \
  -e MYSQL_DATABASE=msgboard \
  -e MYSQL_USER=appuser \
  -e MYSQL_PASSWORD=AppPass123 \
  -v msgdb-data:/var/lib/mysql \
  mysql:8.0
1d054a7161a27a478e451582ecffcfcb3d515867c533a392ff902e0e03bb6a64
用 --network msgboard-net 一步到位重建 msgdb,掛同一個 msgdb-data Volume

等 docker logs -f msgdb 出現 ready for connections 之後,再數一次留言:

curl -s localhost:8080 | grep -c 'class="msg"'
3
重建資料庫後 curl 數留言,還是 3 則,資料都在

還是 3 則,而且 msgapp 完全沒重開。資料留下來是 Volume 的功勞;msgapp 找得到新的資料庫,是因為它找的是名字 msgdb,不是舊容器的 IP。新容器可能拿到不同的 IP,但內建 DNS 會把 msgdb 翻成新的位址。這就是「名字就是位址」的實際好處。

步驟 16:再開一個網頁容器,換一個 Port

資料庫回來之後,用同一個映像檔再開一個 msgapp2。容器裡一樣是 8080,但主機的 8080 已經被 msgapp 用掉了,一個主機 Port 只能接一個容器,所以外面改用 8081:

docker run -d \
  --name msgapp2 \
  --network msgboard-net \
  -p 8081:8080 \
  -e DB_HOST=msgdb \
  -e DB_USER=appuser \
  -e DB_PASSWORD=AppPass123 \
  -e DB_NAME=msgboard \
  msgboard:v1
9c7d9ee82f186038ebf255e9ae4953ea9e5617d9a5ebe917be2c07ea77141262
啟動第二個網頁容器 msgapp2,-p 8081:8080,主機 8081 接到容器 8080

用 curl 分別問兩個 Port,各自是誰回應、看到幾則留言:

curl -s localhost:8080 | grep 服務容器; curl -s localhost:8081 | grep 服務容器
curl -s localhost:8081 | grep -c 'class="msg"'
        <div class="host">服務容器:0ca613f0e81d</div>
        <div class="host">服務容器:9c7d9ee82f18</div>
3
curl 8080 和 8081 分別由 0ca613f0e81d 和 9c7d9ee82f18 兩個容器回應,8081 也看到 3 則留言

算一次 Port 對應:

容器容器裡的 Port主機的 Port回應的容器 ID
msgapp808080800ca613f0e81d
msgapp2808080819c7d9ee82f18

兩個容器裡面都是 8080,互不衝突,因為每個容器有自己的網路空間;衝突只會發生在主機那一側。grep -c 是「數有幾行符合」,8081 也是 3 則,因為兩個網頁容器連的是同一個 msgdb。網頁容器不存資料,要開幾個都行,這叫無狀態(stateless),之後 Cloud Run、Kubernetes 自動擴展靠的就是這個特性。

加碼實驗:用名字找容器,預設網路和自訂網路各試一次

前面是用 MySQL 臨時容器測,這裡換一個更單純的方式,親眼看官方文件說的「預設 bridge 不能用名字」。用到兩個映像檔:nginx(網頁伺服器,當被找的對象)和 busybox(只有幾 MB、塞滿 ping、cat 這類小工具的映像檔,很適合拿來測試)。ping 是「對某個位址喊一聲,看它有沒有回應」的工具。(這段是 2026 年 11 月補拍。)

先在預設 bridge 開一個 web1,再用 busybox 叫它的名字:

docker run -d --name web1 nginx
docker run --rm busybox ping -c 1 web1
c2dced0b8ec23c02a85b684ed14c7c86e2eee6f7021f7dc7e81e54ce251f84c2
ping: bad address 'web1'
在預設 bridge 網路用名字 ping web1,出現 ping: bad address 'web1',名字找不到

bad address:名字找不到。兩個容器都在預設 bridge,彼此只能用 IP。

換成自訂網路再試一次:

docker network create demo-net
docker run -d --name web2 --network demo-net nginx
docker run --rm --network demo-net busybox ping -c 1 web2
4a4a4de66519fee1a8fef831b46356124998fbf6a6c6688845586abf619b524e
ed691b971e34ccad5121bb3496ade4c69f1a1083650d2784bcf32c8221c534a7
PING web2 (172.18.0.2): 56 data bytes
64 bytes from 172.18.0.2: seq=0 ttl=64 time=0.078 ms

--- web2 ping statistics ---
1 packets transmitted, 1 packets received, 0% packet loss
round-trip min/avg/max = 0.078/0.078/0.078 ms
在自訂網路 demo-net 用名字 ping web2,自動解析成 172.18.0.2,1 個封包送出 1 個收到

名字 web2 自動被翻成 172.18.0.2,送出 1 個封包、收到 1 個,0% 遺失,來回只要 0.078 毫秒。同樣的指令,差別只在 --network demo-net。

是誰幫忙翻譯名字的?看自訂網路裡容器的 DNS 設定:

docker network create demo-net >/dev/null && docker run --rm --network demo-net busybox grep nameserver /etc/resolv.conf; docker network rm demo-net
nameserver 127.0.0.11
demo-net
自訂網路裡的容器,/etc/resolv.conf 的 nameserver 是 127.0.0.11,也就是 Docker 內建的 DNS

/etc/resolv.conf 是 Linux 記錄「要問哪台 DNS 伺服器」的檔案,grep nameserver 只挑出寫著 DNS 位址的那一行;最後的 demo-net 是刪除網路時的回應。這裡寫的 127.0.0.11 就是官方文件說的 Docker 內建 DNS,容器要找 web2,就是去問它。

最後順便看 Port 對應只開給本機的寫法:

docker run -d --name web3 -p 127.0.0.1:8090:80 nginx
docker ps --format "table {{.Names}}\t{{.Ports}}"
d9da2569ed9cc425a6e13f17b1f983fe76d1f6952ebfb22521785bfdcd853b39
NAMES     PORTS
web3      127.0.0.1:8090->80/tcp
web2      80/tcp
web1      80/tcp
用 -p 127.0.0.1:8090:80 啟動 web3,docker ps 的 PORTS 顯示 127.0.0.1:8090->80/tcp,只綁在本機

對照步驟 15 的 msgapp 是 0.0.0.0:8080->8080/tcp(所有介面),web3 是 127.0.0.1:8090->80/tcp(只有主機自己連得到);web1、web2 沒寫 -p,只有 80/tcp,外面完全連不進來。--format 是「只挑我要的欄位印出來」,表格才不會太寬。

清掉這段的東西:

docker rm -f web1 web2 web3
docker network rm demo-net
web1
web2
web3
demo-net
docker rm -f 刪掉 web1、web2、web3,docker network rm 刪掉 demo-net

實測時的意外

1. 少了 cryptography,第一次能連,重建資料庫後網頁 500

一開始 requirements.txt 只有 flask 和 pymysql。第一次啟動完全正常,但做到步驟 15「刪掉資料庫、重建」之後,網頁一直回 500,/health 回 {"db":"disconnected"},日誌裡是:

RuntimeError: 'cryptography' package is required for sha256_password or caching_sha2_password auth methods

原因是 MySQL 8 的登入方式在「伺服器還沒記住這個帳號的密碼」時(例如資料庫容器剛重建),需要走完整的加密交換,這時 PyMySQL 需要 cryptography 套件。資料其實都還在,只是程式連不上。requirements.txt 加一行 cryptography==43.0.3 就解決了,這篇的檔案已經加好。

2. 失敗的 testdb 留下了一個沒名字的 Volume

最後清理時 docker volume ls 多了一個一長串亂碼名字的 Volume(見下一節)。那是步驟 1 失敗的 testdb 留下來的:MySQL 映像檔本身宣告了 /var/lib/mysql 要放在 Volume,沒用 -v 指定的話,Docker 會自動建一個匿名 Volume,而 docker rm 預設不會刪它。第 5 篇講過,匿名 Volume 可以用 docker volume prune 清掉。

3. 容器裡的 mysql 工具吞中文

在 docker exec 進去的 mysql> 裡輸入中文,INSERT 會變成空字串。所以步驟 4 的測試資料用英文;從網頁表單送出的中文則完全正常(步驟 14 的截圖)。


用完記得刪

先把三個容器停掉、刪掉,再看看 Volume 和網路:

docker stop msgapp msgapp2 msgdb && docker rm msgapp msgapp2 msgdb
docker volume ls
docker network ls
msgapp
msgapp2
msgdb
msgapp
msgapp2
msgdb
DRIVER    VOLUME NAME
local     f1cbcedab6a41a27e388f4ef2e9d984b8f2fdbed0beb9a13a05c053f01706479
local     msgdb-data
NETWORK ID     NAME           DRIVER    SCOPE
1a6c5b63677e   bridge         bridge    local
ba1854d013ba   host           host      local
d45a220f8d28   msgboard-net   bridge    local
f23db9e117dc   none           null      local
刪掉三個容器後,docker volume ls 還有 msgdb-data 和一個匿名 Volume,docker network ls 還有 msgboard-net

&& 的意思是「前一個指令成功,才執行下一個」。容器名字各印兩次:一次是 stop 的回應,一次是 rm 的回應。

msgdb-data 這個 Volume、msgboard-net 網路、~/docker-course/msgboard 資料夾先留著,第 7 篇會用 Docker Compose 把這篇二十幾行的指令收成一個檔案,接著用同一份資料。匿名 Volume 可以用第 5 篇教的 docker volume prune 清掉。

Cloud Shell 本身免費,不清也不會被收費;但 Cloud Shell 的硬碟只有 5 GB(家目錄),映像檔太多會塞滿。


到了 GCP 上叫什麼

這篇的觀念Cloud RunGKE(Kubernetes)
-p Port 對應不用寫 -p:程式聽 PORT 環境變數指定的 Port(預設 8080),Cloud Run 自動給一個 HTTPS 網址(容器規範)用 Service 對外,類型有 ClusterIP、NodePort、LoadBalancer
自訂網路+用名字互連服務之間用各自的網址呼叫,沒有共用的 Docker 網路叢集內建 DNS,Service 名稱就是位址,跟這篇的 DB_HOST=msgdb 一模一樣的概念
MySQL 容器通常改用代管的 Cloud SQL,程式的 DB_HOST 換成 Cloud SQL 的連線方式可以用 StatefulSet 跑,也常改用 Cloud SQL
開兩個網頁容器自動依流量增減執行個體,沒流量可以縮到 0Deployment 設定副本數,HPA 自動擴展

最值得帶走的是「連線設定從環境變數來」:同一個 msgboard:v1 映像檔,在這篇連 msgdb,搬到雲端只要把 DB_HOST 換成雲端資料庫的位址,程式一個字都不用改。

K8s 的 Service 怎麼選,會在「第 13 篇:K8s Service 怎麼選?ClusterIP、NodePort、LoadBalancer 差在哪」實作。


面試/證照會怎麼問

面試常見題

題目回答重點
兩個容器要怎麼互相連線?放進同一個自訂 bridge 網路,用容器名稱當主機位址;Docker 內建 DNS 會把名字翻成 IP
為什麼容器裡連 localhost 連不到另一個容器?每個容器有自己的網路空間,localhost 指的是容器自己
預設 bridge 和自訂 bridge 差在哪?預設 bridge 只能用 IP 互連;自訂 bridge 可以用名字,官方建議正式環境用自訂網路
-p 8080:80 是什麼意思?有什麼風險?主機 8080 接到容器 80;預設綁主機所有介面,只想本機用要寫 -p 127.0.0.1:8080:80
資料庫容器要不要 -p?不用。同網路的程式容器直接連就好,開出去反而增加被攻擊的機會
為什麼不把容器 IP 寫進程式?會變、事先不知道、沒有意義;用名字或環境變數
--link 還能用嗎?已棄用,Docker Engine 29.6 起會警告、預計 30.0 移除,改用自訂網路

Kubernetes 證照(CKAD、CKA)

CKAD(應用程式開發者)和 CKA(管理者)都是上機實作考,不是選擇題:在真的叢集裡用指令完成任務。依 Linux Foundation 官方頁(2026 年 11 月查),兩張都是 2 小時、費用 445 美元、含 1 次補考、效期 2 年,考的是 Kubernetes v1.37。

這篇的「名字就是位址」「Port 對應」到了 K8s 會變成 Service、Service 的 port 和 targetPort、叢集 DNS 名稱(例如 msgdb.default.svc.cluster.local),是兩張證照網路題的基礎。

看到這些字,就想到這個

題目出現的字想到
「容器用名稱互相連線」「service discovery」自訂 bridge 網路+內建 DNS
「只能用 IP 連」「名字解析失敗」容器在預設 bridge 上
「只允許本機存取」-p 127.0.0.1:主機Port:容器Port
「Port 已被使用(address already in use)」主機那一側的 Port 撞到了,換一個主機 Port
「資料庫還沒準備好,程式啟動就失敗」重試機制(retry)、健康檢查

常見問答

Docker 容器之間要怎麼互相連線?

建一個自訂網路(docker network create 名字),把要互連的容器都加上 –network 名字,程式裡的主機位址直接寫對方的容器名稱。自訂網路有 Docker 內建的 DNS(127.0.0.11),會把容器名稱翻成當下的 IP,容器重建換了 IP 也照樣找得到。

為什麼容器裡連 localhost 連不到別的容器?

因為每個容器有自己獨立的網路空間,localhost 指的是「這個容器自己」,不是主機,也不是其他容器。網頁容器裡用 localhost 連 MySQL,只會找自己裡面有沒有 MySQL,當然連不上。要連另一個容器,請用它的容器名稱。

預設 bridge 網路和自己建的網路差在哪?

Docker 官方文件說明,預設 bridge 網路裡的容器只能用 IP 互連;自己建立的 bridge 網路,容器可以用名字或別名互相找到。沒指定 –network 的容器全部會放進預設 bridge,彼此沒有隔離,所以官方建議正式環境改用自訂網路。

docker run -p 8080:80 的兩個數字是什麼意思?

冒號左邊是主機的 Port,右邊是容器裡的 Port。-p 8080:80 代表連到主機 8080 的流量,會轉進容器的 80。兩個容器裡面可以都用同一個 Port,但主機那一側不能重複,所以第二個容器要改成 -p 8081:80 這樣。

資料庫容器需要用 -p 開 Port 嗎?

如果只有同一個網路裡的程式容器要連,不需要。不寫 -p,資料庫只在 Docker 網路裡可見,外面連不進來,比較安全。真的要從主機用工具連進去,建議寫成 -p 127.0.0.1:3306:3306,只開給主機自己。

–link 還能用嗎?

不建議。Docker 官方文件已將它列為棄用:Docker Engine 29.6 起使用會出現警告,預計 30.0 移除。它是預設 bridge 不能用名字互連的年代留下來的做法,現在請改用自訂網路,效果更好也更好維護。

容器的 IP 可以寫死在程式裡嗎?

不要。容器刪掉重建,IP 可能就換了;寫程式的時候也無法事先知道它會拿到哪個 IP。這篇實測同一台 Cloud Shell 上,預設網路的容器是 172.17.0.2,自訂網路的容器是 172.18.0.3,網段都不一樣。用容器名稱或環境變數傳位址才可靠。


重點整理

  • localhost 在容器裡是「我自己」,連不到別的容器;容器 IP 會變,也不該寫進程式
  • 自訂 bridge 網路 + 容器名稱 = 位址:docker network create、--network,Docker 內建 DNS(127.0.0.11)幫你把名字翻成 IP;預設 bridge 不支援用名字
  • Port 對應管「外面進來」:-p 主機:容器,預設對所有介面開放,只給本機用寫 127.0.0.1:;主機那一側的 Port 不能重複
  • 資料庫不用 -p,只讓同網路的程式容器連;連線設定用環境變數傳,程式才能一份到處用
  • 實測要點:MySQL 沒給 MYSQL_ROOT_PASSWORD 會 Exited (1);PyMySQL 連 MySQL 8 要裝 cryptography;程式要有等資料庫的重試機制

延伸閱讀

本系列

站上相關文章


容器之間連得上,網站才算真正動起來。如果你想有系統地從容器一路學到在 Google Cloud 上部署服務,可以看看東東的 GCP 課程,或加 LINE 聊聊你現在的狀況,一起找出最適合你的學習順序。

Table of Contents
返回頂端