跳转到内容
Hagicode Docs
網誌

Docker Compose 部署

编辑此页

本指南介紹如何使用 Docker Compose 部署 HagiCode。對於大多數用戶來說，這是跨開發、測試和生產環境的預設部署路徑。

影片教學

Section titled “影片教學”

如果您想先查看完整流程，請從影片教學開始：

在 Bilibili 上觀看影片教學

影片內容包括：

  • Docker Compose部署流程完整演示
  • 設定檔產生及修改說明
  • 服務啟動和驗證步驟
  • 常見問題及解決方案

影片長度：約15分鐘

:::注意[Docker Compose Builder] Docker Compose Builder 現在作為獨立工具提供： https://builder.hagicode.com/。使用該網站作為產生同類設定檔的主要來源。 :::

:::提示[使用設定產生器] 您可以使用 Docker Compose Builder（獨立站點） 產生 docker-compose.yml 直接。

生成器支援：

  • 自訂連接埠、容器名稱和其他基本設置
  • 內建或外部資料庫選擇
  • 自動 Windows/Linux 平台差異
  • 通用檔案權限處理
  • 根據您的網路環境選擇影像來源

打開發電機 → :::

:::提示[建議方法] 在大多數情況下，Docker Compose 是預設部署路徑，因為：

  • 環境隔離減少依賴衝突
  • 支援的HagiCode服務堆疊可以一起啟動
  • 配置、升級和維護更容易保持一致
  • 它非常適合本地試驗、測試和團隊部署 :::

先決條件

Section titled “先決條件”

在開始之前，請確保您的系統已安裝 Docker 和 Docker Compose。

安裝 Docker

Section titled “安裝 Docker”

窗戶

Section titled “窗戶”

下載並安裝 適用於 Windows 的 Docker 桌面

安裝後，請確保 Docker Desktop 正在運作。

macOS

Section titled “macOS”

下載並安裝 適用於 Mac 的 Docker 桌面

安裝後，請確保 Docker Desktop 正在運作。

Linux

Section titled “Linux”

使用套件管理器安裝 Docker：

Install Docker on Ubuntu/Debian
sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin

安裝完成後，啟動Docker服務：

Terminal window
sudo systemctl start docker
sudo systemctl enable docker

驗證安裝

Section titled “驗證安裝”

安裝完成後，執行以下命令以驗證 Docker 和 Docker Compose 是否已正確安裝：

Terminal window
docker --version
docker compose version

快速入門

Section titled “快速入門”

1.產生Docker Compose配置文件

Section titled “1.產生Docker Compose配置文件”

:::提示[使用設定產生器] 推薦使用 Docker Compose Builder（獨立站點） 產生您的設定檔。

生成器支援：

  • 多種API提供者選項（智普AI、Anthropic官方、自訂API）
  • 自動設定API URL和Token
  • 自訂連接埠、容器名稱和其他基本配置
  • 配置持久性資料和工作目錄路徑
  • 自動配置Windows/Linux平台差異
  • 智慧處理檔案權限問題
  • 圖片來源選擇：依照您的網路環境，選擇合適的圖片來源

🚀 立即使用發電機 → :::

  1. 打開 Docker Compose Builder（獨立站點）
  2. 依自己的需求填寫配置：
    • 選擇API提供者（智普AI、Anthropic官方或自訂API）
    • 配置連接埠、資料庫、工作目錄和其他選項
    • 選擇圖片來源：根據您的網路環境選擇合適的圖片來源
  3. 點擊生成按鈕即可獲得 docker-compose.yml 配置
  4. 將生成的配置儲存為 docker-compose.yml 文件
  5. 如果需要，創建一個 .env 配置敏感資訊的文件

影像來源選擇

Section titled “影像來源選擇”

生成器支援三種影像來源選項：

Docker 中心

  • 圖片地址： newbe36524/hagicode:{tag}
  • 適用場景：適合Docker Hub鏡像加速的用戶
  • 優點：官方鏡像來源，更新及時，訪問穩定
  • 注意：部分地區可能需要配置鏡像加速

Azure 容器註冊表 (ACR)

  • 圖片地址： hagicode.azurecr.io/hagicode:{tag}
  • 適用場景：適合本地無法存取Docker Hub的用戶
  • 優點：提供替代圖像來源，解決網路存取問題
  • 注意：映像與 Docker Hub 保持同步，但可能會有短暫的延遲

阿里雲容器鏡像倉庫(ACR)

  • 圖片地址： registry.cn-hangzhou.aliyuncs.com/hagicode/hagicode:{tag}
  • 適用場景：適合國內用戶，網路存取穩定快速
  • 優點：阿里雲國內節點，存取速度快，穩定性高
  • 註：阿里巴巴ACR鏡像與Docker Hub保持同步，通常在30分鐘內

:::注意[取得API令牌] 您需要設定 Claude API Token 才能使用 HagiCode：

智普AI（建議）： 取得 API 令牌 →

  • 國內接取穩定，反應更快
  • 性價比高，適合日常使用

人類官方： 取得 API 令牌 →

  • 直接使用Anthropic的服務

:::

2. 啟動服務

Section titled “2. 啟動服務”

在你的目錄下執行以下命令 docker-compose.yml 位於：

Terminal window
docker compose up -d

該命令將：

  • 下載並啟動由生成的模板定義的 HagiCode 容器
  • 建立並配置網絡
  • 初始化預設資料目錄和運行時依賴

3. 驗證服務狀態

Section titled “3. 驗證服務狀態”

檢查容器是否正在運作：

Terminal window
docker compose ps

您應該會看到產生的範本中定義的服務處於「正在執行」狀態。

查看服務日誌

Section titled “查看服務日誌”

查看所有服務日誌：

Terminal window
# View all service logs
docker compose logs


# View HagiCode service logs
docker compose logs hagicode


# Real-time log following
docker compose logs -f hagicode

配置說明

Section titled “配置說明”

如果需要修改配置（例如更改連接埠、切換API提供者等），您可以：

  1. 使用重新產生新配置 Docker Compose Builder（獨立站點）
  2. 手動編輯 docker-compose.yml 和 .env 文件
  3. 重啟服務使配置生效：
Terminal window
docker compose restart

接入申請

Section titled “接入申請”

網頁介面

Section titled “網頁介面”

服務啟動成功後，透過瀏覽器存取：

http://localhost:45000

資料持久化

Section titled “資料持久化”

預設情況下，受支援的 Docker Compose 路徑使用具有持久磁碟區的 SQLite 資料檔案。如果您需要檢查安裝點或排程備份，請檢查產生的磁碟區和資料目錄對應。 docker-compose.yml.

下一步

Section titled “下一步”

現在您已經成功部署 HagiCode。接下來，在Web介面中連接一個真實的項目，然後繼續 嚮導設定 或 建立提案會議.

如果您喜歡桌面應用程式部署方式，請參考 桌面安裝指南.