Haproxy Docker Compose（開發者使用指南）

HAProxy Docker 的特性

使用 Docker 安裝和運行 HAProxy 是一個相當簡單的過程。 以下是逐一採取的步驟。

Docker 安裝

請確保您的系統已安裝 Docker。 若要驗證安裝是否成功，您可以執行以下命令：

docker --version

docker --version

如果系統上沒有安裝 Docker，請訪問此處的Docker 鏈接，從官方網站下載並安裝它。

拉取 HAProxy Docker 映像

從 Docker Hub 拉取官方 HAProxy 映像。 以下命令將下載最新的穩定版本：

docker pull haproxy:latest

docker pull haproxy:latest

建立 HAProxy 設定文件

HAProxy 需要一個設定檔來定義其行為。 建立一個名為haproxy.cfg的文件，內容如下：

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    timeout connect 5s
    timeout client  50s
    timeout server  50s
frontend http_front
    bind *:80
    default_backend http_back
backend http_back
    server app1 host.docker.internal:32769 check

此 HAProxy 配置定義了：

-前端：監聽埠 80 並將流量路由到後端。 -後端：指向託管在host.docker.internal:32769 app1 。

運行 HAProxy Docker 容器

運行 HAProxy Docker 容器，掛載設定檔並暴露必要的連接埠：

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

-d ：以分離模式運作容器。

• --name haproxy-container : 為容器命名。 -p 80:80 ：將主機上的連接埠 80 對應到容器中的連接埠 80。 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro : 將本機設定檔掛載到容器中。

訪問 HAProxy

開啟網頁瀏覽器，造訪http://localhost:80或伺服器的 IP 位址，測試流量路由。

安裝並執行 IronSecureDoc

在命令提示字元或開啟的終端機視窗中使用以下命令拉取 IronSecureDoc 的 Docker 映像：

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

運行 IronSecureDoc 容器：

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

此指令啟動 IronSecureDoc 的容器實例。 您現在可以存取連接埠http://localhost:8080/swagger/index.html上的 IronSecureDoc。

將 IronSecureDoc 與 HAProxy 集成

準備一個haproxy.cfg檔案來定義前端和後端設定。 以下是一個簡單的設定範例：

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    option  httplog
    timeout connect 5000ms
    timeout client  50000ms
    timeout server  50000ms
frontend http_front
    bind *:4500
    acl body_has_data req.hdr_val(Content-Length) gt 0
    http-request set-method POST if METH_GET body_has_data
    use_backend ironsecuredoc if { path /ironsecuredoc } || { path_beg /ironsecuredoc/ }
    use_backend ironsecuredoc_ping if { path /ping } || { path_beg /ping/ }
    use_backend ironsecuredoc_encrypt if { path /encrypt } || { path_beg /encrypt/ }
backend ironsecuredoc
    balance roundrobin
    http-request set-path /swagger/index.html
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_encrypt
    balance roundrobin
    http-request set-path /v1/document-services/pdfs/encrypt
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_ping
    balance roundrobin
    http-request set-path /v1/document-services/ping
    server ironsecuredoc_server host.docker.internal:8080 check

此 HAProxy 配置處理多個 IronSecureDoc 服務的 HTTP 流量。 它定義了全域原始日誌輸出，並設定了具有詳細日誌記錄的預設 HTTP 模式。 前端監聽 4500 端口，並根據路徑路由請求。 acl body_has_data檢查是否存在數據，並在需要時將 GET 請求轉換為 POST 請求。 後端採用輪詢演算法進行負載平衡，透過健康檢查確保請求得到適當轉發，從而保證伺服器可用性。

使用 cURL 發送簡單的加密請求：

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

此向IronSecureDoc API發出的請求會對 PDF 文件套用使用者密碼加密，輸出檔案將會安全地傳送和下載。