引言 

在使用 Docker Compose 部署前后端分離項(xiàng)目時(shí)，前端容器需要根據(jù)不同的環(huán)境（開發(fā)、測(cè)試、生產(chǎn)）動(dòng)態(tài)請(qǐng)求后端服務(wù)的地址。常見的需求矛盾在于：

• 開發(fā)環(huán)境：前端可能需要直接訪問宿主機(jī)的后端服務(wù)（如 localhost:8080）。
• 生產(chǎn)環(huán)境：前端需要訪問 Docker 內(nèi)部網(wǎng)絡(luò)中的后端服務(wù)（如 backend:8080）。

本文將對(duì)比三種主流實(shí)現(xiàn)方案，分析其優(yōu)缺點(diǎn)及適用場(chǎng)景。

方案一：構(gòu)建時(shí)注入 URL（硬編碼方式） 

核心思想：在構(gòu)建鏡像時(shí)，通過 Dockerfile 的 ARG 參數(shù)將后端地址固化到鏡像中。

實(shí)現(xiàn)步驟

• 修改 Dockerfile

FROM node:20 AS build
ARG API_BASE_URL              # 聲明構(gòu)建參數(shù)
ENV VUE_APP_API_BASE=$API_BASE_URL  # 傳遞到 Vue 環(huán)境變量
COPY . .
RUN npm run build
 
FROM nginx
COPY --from=build /app/dist /usr/share/nginx/html

• 配置 docker-compose.yml

services:
  frontend:
    build:
      context: .
      args:
        API_BASE_URL: "http://backend:8080"  # 直接寫死地址

• 前端代碼使用

// 直接讀取環(huán)境變量
axios.get(`${process.env.VUE_APP_API_BASE}/api/data`);

優(yōu)點(diǎn)

• 簡(jiǎn)單直接：一次構(gòu)建，永久生效，無需額外配置。
• 安全性高：配置內(nèi)置于鏡像，外部無法篡改。

缺點(diǎn)

• 靈活性差：每次修改地址需重新構(gòu)建鏡像。
• 環(huán)境隔離弱：無法用同一個(gè)鏡像適應(yīng)不同環(huán)境。

適用場(chǎng)景

• 后端地址固定不變（如純內(nèi)網(wǎng)環(huán)境）。
• 對(duì)鏡像版本控制有嚴(yán)格要求。

方案二：運(yùn)行時(shí)動(dòng)態(tài)配置 URL（環(huán)境變量或腳本生成） 

核心思想：構(gòu)建通用的前端鏡像，在容器啟動(dòng)時(shí)通過環(huán)境變量或動(dòng)態(tài)腳本生成配置文件。

實(shí)現(xiàn)步驟

1. 修改 Dockerfile

FROM nginx:alpine
COPY entrypoint.sh /entrypoint.sh    # 入口腳本
COPY nginx.conf /etc/nginx/conf.d/default.conf
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]       # 啟動(dòng)時(shí)執(zhí)行腳本

• 入口腳本 (entrypoint.sh)

#!/bin/sh
# 動(dòng)態(tài)生成配置文件
echo "window.APP_CONFIG = { API_BASE_URL: '${API_BASE_URL}' };" > /usr/share/nginx/html/config.js
exec nginx -g "daemon off;"

• 配置 docker-compose.yml

services:
  frontend:
    image: my-frontend-image  # 使用預(yù)構(gòu)建的通用鏡像
    environment:
      API_BASE_URL: "http://backend:8080"  # 運(yùn)行時(shí)注入

• 前端代碼動(dòng)態(tài)加載配置

// 初始化時(shí)加載配置
fetch('/config.js')
  .then(res => res.text())
  .then(script => {
    new Function(script)();  // 執(zhí)行 JS 代碼注入全局變量
    axios.defaults.baseURL = window.APP_CONFIG.API_BASE_URL;
  });

優(yōu)點(diǎn)

• 高度靈活：同一鏡像適配不同環(huán)境，僅需修改環(huán)境變量。
• 快速迭代：無需重新構(gòu)建鏡像即可調(diào)整配置。

缺點(diǎn)

• 復(fù)雜度高：需處理 Nginx 配置和動(dòng)態(tài)腳本。
• 安全性注意：需防范配置信息泄露風(fēng)險(xiǎn)。

適用場(chǎng)景

• 多環(huán)境部署（開發(fā)、測(cè)試、生產(chǎn)）。
• 需要頻繁修改后端地址的場(chǎng)景。

方案三：掛載外部配置文件（文件替換方式）

核心思想：將配置文件存儲(chǔ)在宿主機(jī)，通過 Docker 卷掛載到容器中，實(shí)現(xiàn)動(dòng)態(tài)配置。

實(shí)現(xiàn)步驟

1. 創(chuàng)建外部配置文件

// 宿主機(jī)文件：./config/prod.js
window.APP_CONFIG = {
  API_BASE_URL: "http://backend:8080"
};

• 配置 docker-compose.yml

services:
  frontend:
    image: my-frontend-image
    volumes:
      - ./config/prod.js:/usr/share/nginx/html/config.js  # 掛載配置文件

• 前端代碼直接引用

// 直接訪問全局變量
axios.defaults.baseURL = window.APP_CONFIG.API_BASE_URL;

• Nginx 配置（需允許訪問配置文件）

server {
    location /config.js {
        add_header Cache-Control "no-cache";  # 禁用緩存
    }
}

優(yōu)點(diǎn)

• 直觀透明：配置文件可見且易維護(hù)。
• 靈活修改：直接編輯宿主機(jī)文件即可生效，無需重啟容器。

缺點(diǎn)

• 依賴宿主機(jī)文件：需確保文件路徑正確，且權(quán)限可控。
• 環(huán)境耦合：配置需與宿主機(jī)目錄綁定，遷移時(shí)需同步文件。

適用場(chǎng)景

• 配置項(xiàng)較多且需頻繁調(diào)整。
• 需要直接編輯配置文件的場(chǎng)景（如運(yùn)維人員手動(dòng)干預(yù)）。

方案對(duì)比總結(jié)

實(shí)戰(zhàn)建議

• 開發(fā)環(huán)境：推薦方案：運(yùn)行時(shí)動(dòng)態(tài)配置（API_BASE_URL=http://host.docker.internal:8080）。 理由：快速調(diào)整，無需重建鏡像。
• 生產(chǎn)環(huán)境：
  • 固定地址：構(gòu)建時(shí)注入（安全性優(yōu)先）。
  • 靈活需求：運(yùn)行時(shí)動(dòng)態(tài)配置 + CI/CD 環(huán)境變量注入。
• 復(fù)雜配置場(chǎng)景：推薦方案：掛載外部配置文件（如需要配置 API 密鑰、多服務(wù)地址等）。
• 混合方案：yaml

# docker-compose.yml
services:
  frontend:
    build:
      args:
        API_BASE_URL: "default_url"  # 默認(rèn)值
    environment:
      API_BASE_URL: "overridden_url"  # 運(yùn)行時(shí)覆蓋
    volumes:
      - ./config:/usr/share/nginx/html/config  # 掛載目錄

優(yōu)勢(shì)：默認(rèn)值 + 動(dòng)態(tài)覆蓋 + 文件掛載，三重保險(xiǎn)。

結(jié)語 三種方案各有千秋：

• 構(gòu)建時(shí)注入適合“一次構(gòu)建，處處運(yùn)行”的穩(wěn)定場(chǎng)景。
• 運(yùn)行時(shí)動(dòng)態(tài)配置是現(xiàn)代云原生應(yīng)用的標(biāo)配，平衡了靈活性與安全性。
• 掛載外部配置文件則在需要透明化管理或復(fù)雜配置時(shí)展現(xiàn)優(yōu)勢(shì)。

實(shí)際項(xiàng)目中，可根據(jù)團(tuán)隊(duì)技術(shù)棧、運(yùn)維習(xí)慣及安全要求靈活選擇，甚至組合使用！

以上就是在Docker中動(dòng)態(tài)配置前端請(qǐng)求地址的三種方式的詳細(xì)內(nèi)容，更多關(guān)于Docker動(dòng)態(tài)配置前端請(qǐng)求地址的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論