容器之間怎麼連線:放進同一個自訂 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 入門教學。

為什麼你需要知道
- 網站加資料庫是最基本的架構:只要你的程式要存資料,就一定會有「程式容器連資料庫容器」這件事,連不上整個網站就是 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) | 用途 |
|---|---|---|
bridge | bridge | 預設網路,沒指定 --network 的容器都放這裡 |
host | host | 容器直接用主機的網路,沒有隔離 |
none | null | 完全沒有網路 |
「驅動(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,就知道它過時了,改用自訂網路。

動手做:Flask 留言板連 MySQL
在 test27 的 Cloud Shell(不用建專案、不用綁信用卡)實作,大約 25 分鐘,不花錢。截圖裡的提示字元有縮短,你的畫面會是「你的帳號@cloudshell:~/docker-course$」。
我們要做的東西長這樣:

先建一個練習用的資料夾:
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

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

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

每一行的意思(行尾的 \ 代表「指令還沒完,下一行接著」):
| 參數 | 作用 |
|---|---|
--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

注意 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.

實測日誌裡其實出現兩次 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指令工具在 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 伺服器。這就是「在自己家喊廚房」。
步驟 6:查容器的 IP
docker inspect msgdb | grep '"IPAddress"'
"IPAddress": "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

就是前面表格的三個預設網路。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

多了 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",

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>

通了。查一下剛剛那筆資料:
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)

輸入 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

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

三個關鍵參數各管一件事:
| 參數 | 管什麼 | 方向 |
|---|---|---|
--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

「資料庫連線成功」:程式用 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 篇有圖解)。留兩則言試試:

你會看到步驟 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

順便對照 PORTS 欄:msgapp 是 0.0.0.0:8080->8080/tcp,代表主機所有介面的 8080 都接進來;步驟 2 的 MySQL 只有 3306/tcp,沒有對外。
資料庫不在了,健康檢查馬上反映出來:
curl -s localhost:8080/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

等 docker logs -f msgdb 出現 ready for connections 之後,再數一次留言:
curl -s localhost:8080 | grep -c 'class="msg"'
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

用 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

算一次 Port 對應:
| 容器 | 容器裡的 Port | 主機的 Port | 回應的容器 ID |
|---|---|---|---|
| msgapp | 8080 | 8080 | 0ca613f0e81d |
| msgapp2 | 8080 | 8081 | 9c7d9ee82f18 |
兩個容器裡面都是 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'

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

名字 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 是 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

對照步驟 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

實測時的意外
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

&& 的意思是「前一個指令成功,才執行下一個」。容器名字各印兩次:一次是 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 Run | GKE(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 |
| 開兩個網頁容器 | 自動依流量增減執行個體,沒流量可以縮到 0 | Deployment 設定副本數,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;程式要有等資料庫的重試機制
延伸閱讀
本系列
- 第 1 篇:Docker 入門教學:不用安裝,用 Cloud Shell 跑出第一個容器
- 第 2 篇:Docker 常用指令一次看懂:run、ps、logs、exec、stop、rm
- 第 3 篇:Docker 映像檔和容器差在哪?Image、Layer、Tag 白話解釋
- 第 4 篇:Dockerfile 怎麼寫?從零打包你的第一個網頁映像檔
- 上一篇:第 5 篇:Docker 資料會消失?Volume 和 Bind Mount 怎麼選
- 下一篇:第 7 篇:Docker Compose 教學:一個 YAML 開起網站+資料庫
站上相關文章
- 容器 (Container) 技術是什麼?從零開始看懂 Docker 與容器化應用
- DNS 是什麼?
- GCP 防火牆規則怎麼設定
- Cloud Run 簡介與手把手教學
- 轉職 IT 新手必學知識完整指南:從零基礎到雲端技術入門
容器之間連得上,網站才算真正動起來。如果你想有系統地從容器一路學到在 Google Cloud 上部署服務,可以看看東東的 GCP 課程,或加 LINE 聊聊你現在的狀況,一起找出最適合你的學習順序。