🚀 部署指南

Docker、Kubernetes、IIS 部署範例

🐳 Docker 部署

使用 Docker 快速部署 Aspose MCP Server。

範例配置檔案

專案提供完整的部署範例檔案，可直接下載使用或作為參考：

快速啟動

# 下載範例配置
curl -O https://raw.githubusercontent.com/xjustloveux/aspose-mcp-server/master/deploy/docker-compose.yml

# 啟動
docker-compose up -d

# 查看日誌
docker-compose logs -f

# 停止
docker-compose down

字型擴展（CJK 中日韓支援）

Docker 映像已內建基本 CJK 字型（文泉驛正黑）。如需更完整的字型支援，可透過以下方式擴展：

Volume Mount 方式： 

volumes:
  - ./my-fonts:/usr/share/fonts/custom

自建 Image 方式： 

FROM ghcr.io/xjustloveux/aspose-mcp-server:latest
USER root
RUN apt-get update && \
    apt-get install -y --no-install-recommends fonts-noto-cjk && \
    fc-cache -f -v && \
    apt-get clean && rm -rf /var/lib/apt/lists/*
USER aspose
💡 常見語言字型套件
  • fonts-wqy-zenhei - 中日韓基本（~17MB，已內建）
  • fonts-noto-cjk - 中日韓完整（~300MB）
  • fonts-noto-core - 阿拉伯文等（~50MB）
  • fonts-thai-tlwg - 泰文（~3MB）

☸️ Kubernetes 部署

使用 Kubernetes 部署 Aspose MCP Server。

範例配置檔案

專案提供完整的 Kubernetes 部署範例，可直接下載使用或作為參考：

常用命令

# 下載範例配置
curl -O https://raw.githubusercontent.com/xjustloveux/aspose-mcp-server/master/deploy/deployment.yaml

# 建立 License Secret
kubectl create secret generic aspose-license \
  --from-file=Aspose.Total.lic=/path/to/license

# 部署
kubectl apply -f deployment.yaml

# 暴露服務
kubectl expose deployment aspose-mcp-server --port=80 --target-port=3000

# 查看狀態
kubectl get pods -l app=aspose-mcp

🖥️ IIS 部署

在 Windows Server 的 IIS 上部署 Aspose MCP Server。

前置需求

範例配置檔案

部署步驟

  1. 從 Release 下載 aspose-mcp-server-iis.zip
  2. 解壓縮到 IIS 站台目錄（例如：C:\inetpub\AsposeMcpServer）
  3. 在 IIS 建立新站台，指向該目錄
  4. 設定 Application Pool 為「No Managed Code」
  5. 參考 web.config 範例修改配置
  6. 放置 License 檔案並修改 web.config 中的路徑
注意： IIS 部署時，建議啟用 HTTPS 並設定適當的安全標頭。

⚙️ 環境變數

所有部署方式都支援環境變數和命令行參數進行配置。命令行參數優先於環境變數。

📖 完整配置參考

完整的環境變數和命令行參數說明請參考 配置參考 頁面，包含以下模組：

常用配置

環境變數 命令行參數 說明 預設值
ASPOSE_TRANSPORT --stdio/--http/--ws 傳輸模式 stdio
ASPOSE_PORT --port N HTTP/WebSocket 監聽埠號 3000
ASPOSE_TOOLS --word/--excel/--all 啟用的工具類型 all
ASPOSE_LICENSE_PATH --license path License 檔案路徑 -
ASPOSE_SESSION_ENABLED --session-enabled 啟用 Session 管理 false