---
title: 從 GitHub 部署
description: 把 GitHub repository 連到 App。每次 push 都會建置；push 到正式分支會上線，其他分支會有自己的預覽網址。
url: https://agentlab.cresclab.com/docs/zh-tw/deploy/github
language: zh-Hant-TW
updated: 2026-10-08
---

# 從 GitHub 部署

把 GitHub repository 連到 App。每次 push 都會建置；push 到正式分支會上線，其他分支會有自己的預覽網址。

## 運作方式

Agent Lab 的 GitHub App **Crescendo Agent Lab**（由漸強實驗室提供）會讀取你允許的 repository，並在每次 push 時收到通知。

- push 到**正式分支**（預設是 repository 的預設分支，可以修改）：建置後在 App 的網址上線。
- push 到**其他分支**：建置一個有自己預覽網址的版本，不會上線。如果工作區裡有同名的 Agent Lab 分支（例如 `staging`），就會在那個分支上線。
- GitHub 上的 commit 會顯示結果：建置中顯示等待中，完成後顯示成功（附預覽網址）或失敗（附建置記錄連結）。

建置方式跟上傳完全一樣，平台會自動偵測框架。見[從原始碼部署](https://agentlab.cresclab.com/docs/zh-tw/deploy/source-build.md)。

> [!NOTE] 跟「整合」裡的 GitHub 不同
> **整合**頁的 GitHub 是讓 AI 助理在對話中使用 GitHub 的工具。部署用的是另一條連線，在這裡設定。

## 1. 連結 GitHub

1. 到 **設定 › 部署設定**，選 **連結 GitHub**。
2. GitHub 會問要把 **Crescendo Agent Lab** 安裝到哪裡：你的帳號或你的某個組織。可以允許所有 repository，或只選 App 需要的幾個。
3. 回到 Agent Lab 後就會看到這個帳號。如果組織需要擁有者核准安裝，在核准前會顯示為已申請。

只有能管理 App 的人可以連結 GitHub。要停止部署，在這裡移除連結；如果不想讓它再讀取任何東西，也到 GitHub 解除安裝 App。

## 2. 匯入 repository

1. 在 App 頁選 **新增 App**，再選 **從 GitHub 匯入**。
2. 選帳號、搜尋並選擇 repository。
3. 確認名稱、網址標籤和正式分支。monorepo 請填 **App 路徑**，例如 `apps/web`。
4. 貼上專案需要的變數，或之後再填。
5. 選 **部署**。正式分支最新的 commit 會建置並上線。

已經存在的 App，到 **設定 › Git** 連結。

## 分支

git 分支會自動在名稱完全相同的 Agent Lab 分支上線：push 到 `staging`，就會在你的 `staging` 分支上線，不需要另外設定對應。請先建立 Agent Lab 分支；建立之前，push 到這個 git 分支只會有預覽網址。正式分支一律在 App 的主要網址上線。在 **設定 › Git** 可以修改正式分支。**部署最新提交** 不用 push 就能再建置一次正式分支。

## 限制

- repository 的限制和上傳原始碼相同：2 萬個檔案、512 MB，不含 `node_modules`、`.git`，以及 `.env.local`、`.env.*.local`。提交進 repo 的 `.env`、`.env.<mode>` 會保留，這是 Vite、Next.js 的預期。
- 不會抓取 git submodule 和 Git LFS 檔案。
- 每次 push 和其他建置一樣使用建置分鐘數。