---
title: 部署靜態網站
description: 把建置好的網頁部署成一個有 HTTPS 網址的網站。
url: https://agentlab.cresclab.com/docs/zh-tw/deploy/static-site
language: zh-Hant-TW
updated: 2026-10-06
---

# 部署靜態網站

把建置好的網頁部署成一個有 HTTPS 網址的網站。

## 事前準備

- 建置好的檔案，例如執行 `npm run build` 之後產生的 `dist/`。
- 建立 App 的權限。只有管理員能建立 App。

要上傳 zip 的話，請在資料夾裡面壓縮，讓 `index.html` 位在 zip 的最上層：

```bash
cd dist
zip -r ../site.zip .
```

> [!WARNING] 常見錯誤
> 直接壓縮 `dist` 資料夾，`index.html` 會變成 `dist/index.html`。最上層沒有 `index.html`，這個版本就會被拒收。

## 1. 建立 App

1. **打開「部署 › App」** 按「建立 App」。
2. **填名稱和網址標籤** 標籤只能用小寫英文字母、數字和連字號，例如 `launch-page`。

> [!NOTE] 網址標籤不會再給別人
> App 刪除之後，這個網址也不會給別的組織使用。建立前請確認拼字。

## 2. 上傳

**主控台**
在 App 的「部署」分頁，把資料夾、`.zip` 或 `index.html` 拖進上傳區（也可以用按鈕選），再按「上傳並建置」。

平台會建置出新版本，並在上線前掃描檔案裡有沒有密鑰或個人資料。
**AI 工具**
在已連接 Agent Lab MCP 的 AI 工具裡輸入：

```prompt
把 dist/ 部署到 Agent Lab 的 launch-page。好了先給我預覽網址，我確認後再上線。
```

設定方式見[用 AI 工具部署](https://agentlab.cresclab.com/docs/zh-tw/deploy/ai-agent.md)。

## 3. 上線

App 的第一個版本建置成功後會自動上線，訪客打開對外網址就看得到：

```text
https://launch-page--acme.hosting.agentlab.run
```

之後的版本不會自動上線。先打開該版本的預覽網址檢查，再到「部署」分頁按「上線」。

## 下一步

- [版本、上線與回到先前版本](https://agentlab.cresclab.com/docs/zh-tw/deploy/versions.md)
- [網址與存取權](https://agentlab.cresclab.com/docs/zh-tw/deploy/addresses.md)：只想給特定的人看，可以把 App 設成私人並加上密碼。