【Docker】Multi-Stage Build 減少Image大小

Tue, 21 Apr 2026 13:48:45 +0800

為了可以在CI build Docker Image時節省Image的大小，學了一下Multi-Stage build，這篇文章就來記錄一下。

Image Layer Link to heading

首先最重要的概念就是，Docker的每個Image都是由多個Layer組成的，當我們在Dockerfile裡每執行一個指令(e.g.FROM, RUN, COPY...)時，都會在原有的Layer之上再建立一個新的Layer，且該指令對檔案的任何操作或是Diff都只會記錄在這個Layer中(如果是改上一個Layer就有的檔案會複製一份再改，不影響上個Layer的完整性，Copy-on-Write)。

所以說當我們要build一個新的Image時，裡面可能就會包含很多不同的階段，像是安裝套件、編譯、打包可執行檔等等，每個步驟可能都會在對應的Layer裡產生很多最終執行檔不需要的東西，例如快取、編譯工具，導致整包Image很肥大。

FROM node:18

WORKDIR /app

# 複製 package.json 並安裝所有依賴 (包含 devDependencies)
COPY package*.json ./
RUN npm install

# 複製所有原始碼並進行編譯
COPY . .
RUN npm run build

# 啟動伺服器 (通常是 npm start)
CMD ["npm", "start"]

# 【結果】映像檔大小：可能高達 1GB+ (包含 node_modules 和原始碼)

Multi-Stage Build Link to heading

為了處理這個問題 Docker提供了多階段build的功能，我們只需要使用FROM AS就可以把每個不同階段拆開來，只傳遞該階段重要的結果(Artifact)，其他用不到的東西都可以直接丟掉。

Docker on WSLIN

【Docker】Multi-Stage Build 減少Image大小

Image Layer Link to heading

Multi-Stage Build Link to heading