docker-compose.yml

# ==============================================================================
# docker-compose.yml
#
# 定義所有 container 的服務編排：
#   - server:   Go 寫的 HTTP/HTTPS 請求記錄器
#   - proxy:    mitmproxy，攔截並記錄完整的 protocol 層級資訊
#   - 各 client containers（後續逐一加入）
#
# 網路拓撲：
#   Client ──→ proxy:8888  ──→ server:8080  (HTTP via proxy)
#   Client ──→ proxy:8889  ──→ server:8443  (HTTPS via proxy)
#   Client ──→ server:8080                  (HTTP 直連)
#   Client ──→ server:8443                  (HTTPS 直連)
#   Client ──→ server:8081                  (HTTP Raw 直連)
#   Client ──→ server:8444                  (HTTPS Raw 直連)
# ==============================================================================

services:

  # --------------------------------------------------------------------------
  # Viewer：Vue.js Log Viewer（前端）
  #
  # Vite dev server 提供 HMR（Hot Module Replacement），
  # 修改 .vue 檔案時瀏覽器會即時更新。
  # /api 開頭的請求會透過 Vite proxy 轉發到 Go server。
  # --------------------------------------------------------------------------
  viewer:
    build:
      context: ./viewer
    container_name: lab-viewer
    ports:
      - "5173:5173"   # Vite dev server
    volumes:
      # 掛載原始碼，讓 HMR 可以偵測檔案變更
      - ./viewer/src:/app/src
      - ./viewer/index.html:/app/index.html
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

  # --------------------------------------------------------------------------
  # Server：Go 原始電文記錄器
  # --------------------------------------------------------------------------
  server:
    build:
      context: ./server          # Dockerfile 所在的目錄
    container_name: lab-server
    env_file:
      - .env                     # 載入環境變數（server 本身不需要，但保持一致性）
    ports:
      # 將 container 的 port 映射到 host，方便從 host 直接測試
      - "8080:8080"   # Parsed HTTP
      - "8443:8443"   # Parsed HTTPS
      - "8081:8081"   # Raw HTTP
      - "8444:8444"   # Raw HTTPS
    volumes:
      # 將 log 目錄掛載到 host，這樣可以直接在 host 檢視 log 檔案
      - ./logs:/app/logs
      # 將憑證目錄掛載進 container（唯讀），server 需要讀取 TLS 憑證
      - ./certs:/app/certs:ro
    healthcheck:
      # 定期檢查 server 是否正常運作
      # wget 比 curl 更適合 alpine（預設已安裝，不需要額外裝 curl）
      test: ["CMD", "wget", "--spider", "-q", "http://localhost:8080/health"]
      interval: 5s       # 每 5 秒檢查一次
      timeout: 3s        # 單次檢查最多等 3 秒
      retries: 3         # 連續失敗 3 次才判定為不健康
      start_period: 10s  # 啟動後給 10 秒的緩衝期（不計入失敗次數）
    networks:
      - lab-network

  # --------------------------------------------------------------------------
  # Proxy：mitmproxy（中間人代理）
  #
  # mitmproxy 可以攔截、記錄、甚至修改經過它的 HTTP/HTTPS 流量。
  # 在這個專案中，我們只用它來「記錄」，觀察完整的 protocol 層級細節。
  #
  # mitmproxy 的 Web UI 可以在瀏覽器中查看攔截的請求：
  #   http://localhost:8190
  # --------------------------------------------------------------------------
  proxy:
    image: mitmproxy/mitmproxy:10.1.1
    container_name: lab-proxy
    command:
      - mitmweb
      # --web-host 0.0.0.0   : 讓 Web UI 可以從 container 外部存取
      # --web-port 8190      : Web UI 的 port
      # --set confdir=/home/mitmproxy/.mitmproxy : mitmproxy 設定和 CA 憑證的目錄
      # --mode regular       : 正向代理模式（client 主動設定 proxy）
      - --web-host
      - "0.0.0.0"
      - --web-port
      - "8190"
      - --set
      - "confdir=/home/mitmproxy/.mitmproxy"
    ports:
      - "8888:8080"   # HTTP  proxy port（mitmproxy 預設監聽 8080）
      - "8190:8190"   # mitmproxy Web UI
    volumes:
      # 掛載 mitmproxy 的 CA 憑證目錄，方便 client 信任 mitmproxy 的 CA
      - mitmproxy-data:/home/mitmproxy/.mitmproxy
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy  # 等 server 健康後才啟動 proxy

  # --------------------------------------------------------------------------
  # Client：Python
  #
  # 依序測試 urllib、requests、httpx、urllib3、aiohttp 五個 library。
  # 測試完成後 container 會自動結束。
  # --------------------------------------------------------------------------
  client-python:
    build:
      context: ./clients/python
    container_name: lab-client-python
    env_file:
      - .env                     # 載入 server 位址等環境變數
    volumes:
      - ./certs:/app/certs:ro    # CA 憑證（唯讀），供 HTTPS 驗證使用
      - ./test-data.json:/app/test-data.json:ro  # 測試資料（唯讀）
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy  # 等 server 就緒才開始測試

  # --------------------------------------------------------------------------
  # Client：C#
  #
  # 測試兩種 HTTP client：
  #   1. HttpClient（.NET 內建）
  #   2. RestSharp（第三方，C# 版的 requests）
  # --------------------------------------------------------------------------
  client-csharp:
    build:
      context: ./clients/csharp
    container_name: lab-client-csharp
    env_file:
      - .env
    volumes:
      - ./certs:/app/certs:ro
      - ./test-data.json:/app/test-data.json:ro
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

  # --------------------------------------------------------------------------
  # Client：Node.js
  #
  # 測試五種 HTTP client：
  #   1. http（內建）
  #   2. axios
  #   3. node-fetch
  #   4. got
  #   5. undici（Node.js 官方）
  # --------------------------------------------------------------------------
  client-nodejs:
    build:
      context: ./clients/nodejs
    container_name: lab-client-nodejs
    env_file:
      - .env
    volumes:
      - ./certs:/app/certs:ro
      - ./test-data.json:/app/test-data.json:ro
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

  # --------------------------------------------------------------------------
  # Client：Go
  #
  # 測試兩種 HTTP client：
  #   1. net/http（標準庫內建）
  #   2. Resty（第三方，Go 版的 requests）
  # --------------------------------------------------------------------------
  client-go:
    build:
      context: ./clients/go
    container_name: lab-client-go
    env_file:
      - .env
    volumes:
      - ./certs:/app/certs:ro
      - ./test-data.json:/app/test-data.json:ro
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

  # --------------------------------------------------------------------------
  # Client：Java（純 Maven，不含 Spring）
  #
  # 測試四種 HTTP client：
  #   1. HttpURLConnection（JDK 內建，最古老）
  #   2. java.net.http.HttpClient（Java 11+ 內建）
  #   3. Apache HttpClient 5.x（chunked encoding 的元凶）
  #   4. OkHttp（Android 生態系標準）
  # --------------------------------------------------------------------------
  client-java:
    build:
      context: ./clients/java
    container_name: lab-client-java
    env_file:
      - .env
    volumes:
      - ./certs:/app/certs:ro
      - ./test-data.json:/app/test-data.json:ro
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

  # --------------------------------------------------------------------------
  # Client：Spring Boot（Java）
  #
  # 測試三種 HTTP client：
  #   1. RestTemplate + JDK HttpURLConnection（預設）
  #   2. RestTemplate + Apache HttpClient 5.x（chunked encoding）
  #   3. WebClient + Reactor Netty（reactive）
  # --------------------------------------------------------------------------
  client-spring:
    build:
      context: ./clients/spring
    container_name: lab-client-spring
    env_file:
      - .env
    volumes:
      - ./certs:/app/certs:ro
      - ./test-data.json:/app/test-data.json:ro
    networks:
      - lab-network
    depends_on:
      server:
        condition: service_healthy

# ==============================================================================
# 網路定義
#
# 使用自訂的 bridge 網路，讓所有 container 可以透過 service 名稱互相溝通。
# 例如 client 可以用 "http://server:8080" 來連線到 server container。
# ==============================================================================
networks:
  lab-network:
    driver: bridge

# ==============================================================================
# Volume 定義
#
# Docker named volume，資料會保存在 Docker 管理的目錄中，
# 不會因為 container 刪除而消失（除非手動 docker volume rm）。
# ==============================================================================
volumes:
  mitmproxy-data: