Docker 基礎知識¶
一、核心概念與架構¶
Docker 中最常見的幾個物件:
- 映像(Image):只讀、分層的應用交付模板,包含執行應用所需的檔案系統、執行階段和預設配置。一個映像可以建立多個容器。
- 容器(Container):映像的一個執行實例,擁有獨立的程序、網路和可寫層。容器本身應儘量無狀態、可隨時重建。
- 映像倉庫(Registry):儲存與分發映像的服務,例如 Docker Hub、企業 Harbor 或自建 Registry。
-
資料卷(Volume):由 Docker 管理的持久化資料;容器刪除後資料仍可保留。
-
映像分層與容器可寫層 :映像通常使用 OverlayFS 等聯合掛載機制實現分層複用:映像層只讀,容器啟動時在頂部新增一個可寫層(copy-on-write)。容器可寫層隨容器刪除而消失,因此資料庫、上傳檔案、日誌等需要持久化的資料應寫入 Volume、繫結掛載或外部儲存,而非容器檔案系統。
二、安裝 Docker¶
1. 選擇平臺¶
- Windows / macOS 本地開發:優先使用 Docker Desktop,並啟用 WSL 2(Windows)或預設虛擬化後端。
- Linux 伺服器:安裝 Docker Engine。
2. Ubuntu24 安裝 Docker 範例¶
# 1. 更新軟體包索引並安裝必要工具
sudo apt update
sudo apt install -y ca-certificates curl
# 2. 新增 Docker 官方 GPG 金鑰
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# 3. 新增 Docker 官方 apt 軟體源
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
# 4. 安裝 Docker Engine、CLI、containerd、Buildx 和 Compose 外掛
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io \
docker-buildx-plugin docker-compose-plugin
# 5. 檢視 Docker 服務狀態並執行測試容器
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world
三、常用命令¶
1. 檢視狀態與資源¶
# Docker 環境與服務端狀態
docker version # 檢視 Client / Server 版本;Server 不可達時會顯示連線錯誤
docker info # 檢視 Engine、容器數量、儲存驅動、網路、執行階段等總體資訊
# Docker 物件列表
docker ps # 僅列出正在執行的容器
docker ps -a # 列出全部容器,包括已退出和已建立但未啟動的容器
docker image ls # 列出本地映像(docker images 的現代同義寫法)
docker volume ls # 列出 Docker 管理的資料卷
docker network ls # 列出 Docker 網路
# 單個容器的執行狀態與排障資訊;將 web 替換為容器名或容器 ID
docker stats # 實時顯示所有執行中容器的 CPU、記憶體、網路和塊 I/O;Ctrl+C 退出
docker stats --no-stream web # 只採集一次指定容器的資源使用情況,便於指令碼或快速檢查
docker top web # 檢視指定容器內正在執行的程序
docker inspect web # 檢視容器配置、狀態、掛載、網路等完整 JSON 資訊
docker logs --tail 100 web # 檢視容器最近 100 行標準輸出和標準錯誤日誌
docker port web # 檢視容器埠到主機埠的對映
# Docker 磁碟佔用
docker system df # 彙總映像、容器、資料卷和構建快取的磁碟佔用
docker system df -v # 显示每个对象的详细磁盘占用,输出可能较长
2. 映像¶
# 獲取與列出映像
docker pull nginx:1.28 # 從映像倉庫拉取明確版本,避免生產環境依賴會變化的 latest
docker image ls # 列出本地映像、標籤、映像 ID、建立時間和佔用空間
# 檢視映像詳情;將 nginx:1.28 替換為映像名:標籤、摘要或映像 ID
docker image inspect nginx:1.28 # 以 JSON 檢視入口命令、環境變數、架構、層等完整後設資料
# 標記與刪除映像
docker image rm nginx:1.28 # 刪除未被容器引用的映像;正在使用時會拒絕刪除
docker image prune # 删除悬空镜像,执行前会要求确认
3. 建立、執行與停止容器¶
# 建立並立即啟動一個後臺容器
# -d 後臺執行;--name 指定容器名;--restart 設定 Docker 重啟後的恢復策略
# -p 的順序是“主機地址:主機埠:容器埠”,127.0.0.1 表示限制只允許本機訪問
docker run -d --name web --restart unless-stopped \
-p 127.0.0.1:8080:80 \
nginx:1.28
# 啟動一個臨時互動式容器;退出後自動刪除,適合測試和排障
docker run --rm -it alpine:3.22 sh
# 檢視日誌和進入執行中的容器
docker logs --tail 100 -f web # 先顯示最近 100 行並持續跟蹤;Ctrl+C 退出
docker exec -it web sh # 在執行中的容器內啟動 shell
# 停止、重啟
docker stop web # 停止容器
docker start web # 啟動容器
docker restart web # 重啟容器
# 刪除
docker rm web # 刪除已停止的容器;執行中的容器會拒絕刪除
docker rm -f web # 强制终止并删除运行中的容器,可能造成未完成写入
-
docker run相當於先docker create再docker start,每執行一次都會新建容器;已有容器應使用docker start或docker restart。 -
-p 和 -P 都用於把容器埠釋出到主機,但控制方式不同
-
-p:手動指定埠對映。完整的格式是:-p [主機IP:]主機埠:容器埠
- -P:隨機發布所有宣告埠
- 常開發和生產部署通常優先使用
-p;-P更適合臨時測試。
4. 複製、匯出與匯入¶
# 在主機與容器之間複製檔案
docker cp web:/usr/share/nginx/html/index.html ./index.html # 從容器複製單個檔案到主機的當前目錄
docker cp ./nginx.conf web:/tmp/nginx.conf # 從主機複製檔案到容器的 /tmp 目錄
docker cp web:/etc/nginx ./backup/ # 複製 nginx 整個目錄,保留 nginx 這一層
docker cp web:/etc/nginx/. ./backup/ # 只複製 nginx 目錄裡面的內容,不保留 nginx 這一層
# export 匯出容器根檔案系統的扁平快照,不包含資料卷內容、映像分層歷史和容器執行配置
docker container export --output web-rootfs.tar web
# import 從根檔案系統歸檔建立一個新映像;它不會恢復原映像的 CMD、ENTRYPOINT、ENV 等配置
docker image import web-rootfs.tar example/web-rootfs:backup
# 若目的是完整遷移映像,應使用 save/load:它們會保留映像層、標籤和映像配置
docker image save --output nginx_1.28.tar nginx:1.28
docker image load --input nginx_1.28.tar
| 命令組合 | 操作物件 | 保留內容 | 適用場景 |
|---|---|---|---|
docker cp |
單個檔案或目錄 | 檔案內容,許可權盡量保留 | 臨時取日誌、複製配置或排障檔案 |
docker export/import |
容器根檔案系統 | 扁平化後的檔案系統 | 製作臨時根檔案系統快照;不適合作為標準映像交付方式 |
docker save/load |
Docker 映像 | 映像層、標籤和映像配置 | 離線遷移或歸檔映像 |
四、資料持久化與掛載¶
容器的可寫層與容器生命週期繫結:停止、重啟容器時資料仍在,但刪除容器後可寫層也會被刪除。因此,資料庫檔案、使用者上傳內容等重要資料必須放在 Volume、繫結掛載或外部儲存中,而不能只寫入容器檔案系統。
1. 三種掛載方式如何選擇¶
| 型別 | 資料位置與管理者 | 適用場景 | 主要特點 |
|---|---|---|---|
| 命名 Volume | Docker 管理 | 資料庫、應用持久化資料 | 預設首選;不依賴固定主機路徑,便於複用、檢查和遷移。 |
| Bind mount | 指定的主機檔案或目錄 | 本地原始碼、配置檔案、已有資料目錄 | 內容對主機直接可見,但依賴主機路徑、許可權和安全策略。 |
| tmpfs | 主機記憶體 | 臨時快取、短期敏感檔案 | 不寫入磁碟,容器停止後內容消失;僅適用於 Linux 容器。 |
--mount 引數含義更明確,複雜掛載優先使用;-v/--volume 寫法更短,仍然受支援。容器內的目標路徑必須使用絕對路徑。
2. 使用命名 Volume 儲存資料庫資料¶
# 建立並檢視命名卷
docker volume create mysql-data
docker volume inspect mysql-data
# 將 MySQL 資料目錄掛載到命名卷
docker run -d --name mysql \
-e MYSQL_ROOT_PASSWORD='<replace-with-secret>' \
--mount type=volume,src=mysql-data,dst=/var/lib/mysql \
mysql:8.4
# 或者我們也可以使用 -v 的簡寫方式,但其實官方更推薦 --mount,因為語義更加明確
docker run -d --name mysql \
-e MYSQL_ROOT_PASSWORD='<replace-with-secret>' \
-v mysql-data:/var/lib/mysql \
mysql:8.4
# 確認容器實際使用的掛載
docker inspect mysql --format '{{json .Mounts}}'
刪除容器不會自動刪除這裡顯式建立的 mysql-data。只要重新掛載同一個卷,新容器就能繼續讀取原資料:
docker stop mysql
docker rm mysql
docker run -d --name mysql \
-e MYSQL_ROOT_PASSWORD='<replace-with-secret>' \
--mount type=volume,src=mysql-data,dst=/var/lib/mysql \
mysql:8.4
重新掛載已有 MySQL 資料卷時,MYSQL_ROOT_PASSWORD 不會重置資料庫中已經存在的 root 密碼;這類初始化變數通常只在資料目錄為空時生效。
Volume 的生命週期獨立於容器,但並非不會丟失。docker volume rm mysql-data、docker compose down -v 和帶 --volumes 的清理命令都可能刪除資料卷;執行前必須確認備份和目標範圍。不要直接修改 Docker 內部儲存目錄(通常位於 /var/lib/docker)。
3. 使用 Bind mount 掛載配置或原始碼¶
# 當前目錄必須已經存在 nginx.conf
docker run --rm \
--mount type=bind,src="/opt/nginx/nginx.conf",dst=/etc/nginx/nginx.conf \
nginx:1.28
使用 --mount type=bind 時,源路徑不存在會直接報錯,能避免把拼錯的檔案路徑意外建立成目錄。生產環境應儘量使用絕對路徑和只讀掛載。Bind mount 強依賴主機目錄結構,遷移到另一臺機器時需要同步複製對應檔案。
五、Dockerfile 與映像構建¶
1. 基本規則¶
Dockerfile 是映像的可復現構建清單。docker build 按順序解析指令,每條會形成可快取的構建結果;最終得到映像,而不是直接得到正在執行的容器。
docker build -f docker/Dockerfile . 中最後的 . 才是構建上下文。COPY 和 ADD 只能讀取上下文內、且未被 .dockerignore 排除的檔案。
2. 常用指令¶
| 指令 | 用途與要點 |
|---|---|
FROM |
開始一個構建階段並指定基礎映像;多階段構建可以出現多次。生產環境應固定明確版本,必要時固定 digest。 |
ARG |
宣告構建期變數,只在其作用域內參與構建;不是安全的金鑰傳遞方式。 |
WORKDIR |
設定後續 RUN、COPY、CMD 等指令的工作目錄;優先於反覆使用 cd。 |
COPY |
從構建上下文或其他構建階段複製檔案;可使用 --from、--chown 和 --chmod。普通複製優先使用它。 |
ADD |
額外支援本地 tar 自動解壓和遠端源等語義;只有明確需要這些能力時再使用,避免隱式行為。 |
RUN |
在構建期執行命令併產生映像層;可配合 RUN --mount=type=cache 或 type=secret 使用臨時掛載。 |
ENV |
設定映像和容器中的持久環境變數;適合非敏感預設值,不存放密碼或 Token。 |
USER |
設定後續構建步驟及容器啟動時使用的使用者和組。 |
EXPOSE |
記錄應用預期監聽的容器埠,僅是後設資料;不會像 docker run -p 一樣釋出埠。 |
CMD |
提供預設命令或預設引數;Dockerfile 中只有最後一條生效,可被 docker run IMAGE ... 覆蓋。 |
ENTRYPOINT |
定義容器入口程式;exec 形式與 CMD 組合時,CMD 通常提供可覆蓋的預設引數。 |
HEALTHCHECK |
宣告應用健康檢查,便於編排工具判斷服務狀態。 |
LABEL |
寫入版本、原始碼地址、許可證等 OCI 映像後設資料;MAINTAINER 已廢棄。 |
3. 簡單 Java 應用範例¶
假設已經有一個 Maven + Spring Boot 專案,並且在主機或 CI 中執行 mvn clean package 生成了 target/my-service.jar:
專案根目錄中的 Dockerfile:
# syntax=docker/dockerfile:1
FROM eclipse-temurin:21-jre
WORKDIR /app
COPY target/my-service.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/app.jar"]
這個 Dockerfile 只有一個構建階段:
FROM提供執行 Java 21 應用所需的 JRE。WORKDIR把容器內的工作目錄設定為/app。COPY把主機已經構建好的 JAR 複製進映像;JAR 檔名需要與實際構建結果一致。EXPOSE 8080記錄應用預期監聽的埠,但不會自動把埠釋出到主機。ENTRYPOINT讓容器啟動時執行java -jar /app/app.jar。
4. 構建、檢查與執行驗證¶
# 先在主機生成 target/my-service.jar
mvn clean package -DskipTests
# 再構建映像;最後的點表示當前目錄是構建上下文
docker build --pull -t example/my-service:1.0.0 .
# 檢視映像大小、入口程式、預設引數和執行使用者
docker image ls example/my-service:1.0.0
docker image inspect example/my-service:1.0.0 \
--format 'user={{.Config.User}} entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}'
# 前臺試執行;Ctrl+C 後容器會停止並自動刪除
docker run --rm -p 8080:8080 example/my-service:1.0.0
六、網路¶
1. 容器網路的基本模型¶
在 Linux 上,每個普通容器擁有獨立的網路名稱空間,包括自己的網絡卡、IP 地址、路由表、埠和 DNS 配置。使用 bridge 網路時,Docker 通常透過虛擬網絡卡把容器接入主機上的軟體網橋,並透過轉發/NAT 訪問外部網路。
同一 Docker 主機
外部客戶端
│ 訪問主機IP:8080
▼
主機埠 8080 ──埠釋出──> app:8080
│
自定義 bridge 網路
│ 使用服務名 db:3306
▼
db:3306
app ──NAT/路由──> 主機網絡卡 ──> 外部網路
需要牢記三個邊界:
-
容器內的
127.0.0.1或localhost指向當前容器自身,不是主機,也不是其他容器。 -
同一自定義網路中的容器直接使用“容器名或網路別名 + 容器埠”通訊,不需要把埠釋出到主機。
2. 常見網路模式¶
| 模式 | 說明 |
|---|---|
bridge |
單機 Docker 最常用的驅動。自定義 bridge 提供容器名 DNS、網路隔離和埠釋出。 |
host |
容器直接共享主機網路名稱空間,沒有獨立容器 IP;-p 會失去意義,並可能產生埠衝突。主要用於特定 Linux 場景。 |
none |
除迴環介面外不配置網路,適合不應進行網路通訊的離線任務。 |
container:<name-or-id> |
與指定容器共享同一個網路名稱空間和埠空間,適合少數緊耦合 sidecar 場景。 |
overlay |
連線多個 Docker daemon 的多主機網路,通常配合 Swarm;普通單機 bridge 不能直接跨主機。 |
macvlan / ipvlan |
讓容器更直接地接入物理網路或 VLAN;對交換機、網段和路由有額外要求,不作為普通應用預設選擇。 |
如果 docker run 沒有指定 --network,Linux 容器通常接入預設 bridge。實際應用應優先建立自定義 bridge 網路:它支援自動 DNS 解析,隔離範圍也比所有容器共用預設 bridge 更清晰。舊的 --link 方式已經不推薦。
3. 自定義 bridge 與容器 DNS¶
# 建立自定義 bridge 網路
docker network create app-net
# redis 自動獲得該網路中的 IP 和 DNS 名稱 redis
docker run -d --name redis --network app-net redis:7.4
# 臨時客戶端加入同一網路,透過名稱 redis 和容器埠 6379 訪問
docker run --rm --network app-net redis:7.4 redis-cli -h redis ping
# 返回 PONG;這裡的 redis 是容器名,同時也是 DNS 名稱
# 檢視網路的驅動、網段、閘道器和已連線容器
docker network inspect app-net
# 執行中的容器也可以動態加入或離開自定義網路
docker run -d --name toolbox alpine:3.22 sleep 1d
docker network connect app-net toolbox
docker network disconnect app-net toolbox
# 網路仍被容器佔用時無法刪除
docker rm -f redis toolbox
docker network rm app-net
Docker 內建 DNS 會把同一自定義網路中的容器名或網路別名解析成當前容器 IP。容器重建後 IP 可能改變,但名稱可以保持不變,因此應用配置應寫 redis:6379、db:3306,不要固定某個 172.x.x.x 地址。
4. 埠釋出:EXPOSE、-p 與 -P¶
EXPOSE 只是映像後設資料,用於說明應用預期監聽的容器埠;真正允許主機或外部客戶端進入容器,需要在執行階段使用 -p/--publish。
# 僅允許主機本地訪問:主機 8080 -> 容器 8080
docker run -d --name app-local \
-p 127.0.0.1:8080:8080 \
example/my-service:1.0.0
# 未指定主機 IP,通常會繫結所有主機地址,暴露範圍更大
docker run -d --name app-public \
-p 8081:8080 \
example/my-service:1.0.0
# 隨機發布映像中宣告的所有 EXPOSE 埠,再查詢實際對映
# Docker會讀取映像的Expose 8080,隨機選擇一個主機埠
docker run -d --name app-random -P example/my-service:1.0.0
docker port app-random
-p 的順序是:
埠釋出也不等於已經配置好防火牆、雲安全組、TLS 或身份認證。
5. 常見通訊路徑¶
| 訪問方向 | 推薦地址 | 是否需要 -p |
|---|---|---|
| 同一自定義網路:app 訪問 db | db:3306 |
不需要 |
| 主機訪問 app | 127.0.0.1:8080 或主機 IP + 已釋出埠 |
需要 |
| 外部客戶端訪問 app | 域名/主機 IP + 已釋出埠,通常再經過反向代理 | 需要 |
| 容器訪問網際網路 | 目標域名或 IP | 預設 bridge 通常可直接出站 |
| 不同 Docker 主機上的容器互訪 | 負載均衡入口、路由、Swarm overlay 或其他編排網路 | 單機 bridge 不適用 |
6. 網路隔離與生產邊界¶
一個容器可以同時連線多個網路。例如前端連線 frontend-net 和 backend-net,資料庫只連線 backend-net,從而減少不必要的網路可達範圍。還可以使用 --internal 建立預設不對外路由的內部網路:
docker network create frontend-net
docker network create --internal backend-net
docker run -d --name cache --network backend-net redis:7.4
docker run -d --name app --network frontend-net example/my-service:1.0.0
docker network connect backend-net app
# 清理本範例
docker rm -f app cache
docker network rm frontend-net backend-net
7. 常用排障命令¶
# 檢視網路和容器連線關係
docker network ls
docker network inspect app-net
docker inspect app --format '{{json .NetworkSettings.Networks}}'
# 檢視釋出到主機的埠
docker port app
七、Docker Compose(容器編排)¶
Docker Compose V1 的獨立命令 docker-compose 已是 Legacy。當前優先使用 Compose 外掛,命令為 docker compose(中間空格)。以下命令應在 compose.yaml 所在目錄執行;其中 app、db 是 Compose 檔案中的服務名:
# 檢視 Compose 外掛版本,確認使用的是 docker compose(V2)
docker compose version
# 拉取 db 服務引用的遠端映像;不會啟動容器
docker compose pull db
# 建立並啟動Compose檔案中的所有服務
docker compose up -d
# 檢視本專案全部容器,包括已經退出的容器
docker compose ps --all
# 先顯示 app 最近 100 行日誌,再持續跟蹤;Ctrl+C 只退出日誌檢視
docker compose logs --tail=100 --follow app
# 在正在執行的 app 容器內啟動 shell;精簡映像可能沒有 bash
docker compose exec app sh
# 重新使用Dockerfile構建app映像,並啟動 app
# --build:啟動前構建映像
docker compose up -d --build --no-deps app
# 僅重啟現有 app 容器,不會應用 Compose 配置或映像變更
docker compose restart app
# 停止服務但保留容器、專案網路和資料卷,之後可用 start 恢復
docker compose stop
docker compose start
# 停止並刪除本專案容器和非 external 網路;預設保留映像和命名卷
docker compose down
# 同時刪除 Compose 宣告的命名卷和容器匿名卷,資料庫資料可能永久丟失
# external 卷不會被刪除;執行前必須確認目標專案並完成可恢復備份
docker compose down --volumes
範例:一個 Java 服務連線 MySQL。Compose 會為同一專案建立預設網路,服務名可直接作為主機名使用;depends_on 只控制啟動順序。
name: my-service
services:
app:
build: .
image: example/my-service:1.0.0
ports:
- "127.0.0.1:8080:8080"
environment:
SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/app?useSSL=false&serverTimezone=UTC
SPRING_DATASOURCE_USERNAME: app
# 真實密碼放在 .env(不要提交)或 Compose secrets / 外部金鑰系統中
SPRING_DATASOURCE_PASSWORD: ${DB_PASSWORD:?set DB_PASSWORD in .env}
depends_on:
db:
condition: service_healthy
restart: unless-stopped
db:
image: mysql:8.4
environment:
MYSQL_DATABASE: app
MYSQL_USER: app
MYSQL_PASSWORD: ${DB_PASSWORD:?set DB_PASSWORD in .env}
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:?set MYSQL_ROOT_PASSWORD in .env}
volumes:
- mysql-data:/var/lib/mysql
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-p$${MYSQL_ROOT_PASSWORD}"]
interval: 10s
timeout: 5s
retries: 10
restart: unless-stopped
volumes:
mysql-data:
建議把 .env 寫入 .gitignore,並提交 .env.example(僅保留變數名、無真實密碼)。生產環境的秘密應交由部署平臺或專用金鑰系統管理。
八、離線環境交付¶
離線安裝 Docker Engine 時,應從目標發行版與 CPU 架構對應的官方 RPM/DEB 或官方靜態二進位制包準備完整且版本匹配的依賴。離線前應在同版本測試機上完成安裝演練、校驗雜湊並保留安裝包清單。
離線傳輸映像使用 docker image save/load,它會保留映像的標籤和歷史: