不用寫 Dockerfile
平台從 package.json 認出 Astro，自動決定建置與啟動指令，並列出程式讀的環境變數。
Astro 部署教學 · Agent Lab 部署
Astro 部署，
說一句就上線。
Astro 專案原樣上傳，不用寫 Dockerfile，或直接跟 Claude Code、Codex、Cursor 說「部署上去」。Agent Lab 把它建成web service，全站靜態時則是放在 CDN 的網頁，每一版都有預覽網址、可以回退，上傳時先檢查外洩的金鑰；App 與資料庫跑在 Google Cloud 台灣。
> 把這個 Astro 專案部署上去
sites_createmy-astro
sites_deploy偵測到 Astro
sites_deploy_status建置完成 · 金鑰檢查通過
已上線：my-astro--acme.hosting.agentlab.run
為什麼把 Astro 放在 Agent Lab
不用自己顧主機，Astro 就能上線
JavaScript／TypeScript 專案，直接從原始碼建置、不用 Dockerfile，部署成web service，全站靜態時則是放在 CDN 的網頁。
預覽、上線、回退
每次上傳都是新的一版，有自己的網址。先看過再上線，出問題一鍵切回任何一版。
外洩金鑰先擋下
上線前先檢查 API 金鑰與憑證；機密放在主控台，不放在程式碼裡。
一鍵加 PostgreSQL
建好資料庫接上去，連線自動寫進 App 的環境變數，密碼不會顯示。
怎麼選
Astro 放 Agent Lab，還是自己租 VPS
表格可以左右滑動。
| 你在意的事 | Agent Lab 部署 | 自己租 VPS |
|---|---|---|
| 設定方式 | 上傳或說一句話，不用 Dockerfile | SSH、裝執行環境、程序管理、反向代理 |
| HTTPS 與網域 | 自動；付費方案可接自訂網域 | 自己弄 Certbot 與 DNS |
| 預覽與回退 | 每一版都有自己的網址，一鍵回退 | 自己寫腳本 |
| 上線前檢查 | 上傳時檢查外洩的金鑰 | 自己沒設就沒有 |
| 資料庫 | 一鍵建 PostgreSQL，連線自動寫進 App | 自己安裝、自己備份 |
| 起步費用 | Free 方案 NT$0，1 個 S 應用程式（閒置休眠） | VPS 每月約 NT$200–600，加上你的時間 |
步驟
四步把 Astro 部署上線
準備專案
package.json 放在專案最上層，lockfile 要一起提交；不要帶 node_modules、.git、dist、.env。
上傳或說一句
把資料夾拖進專案的部署分頁、從 GitHub 推送，或透過 Agent Lab MCP 叫 AI 工具做。
建置與檢查
平台建置這一版並檢查外洩金鑰；它列出的機密到設定頁填。
預覽並上線
第一版建好就上線；之後每一版先有預覽網址，確認後再上線。
設定
Agent Lab 怎麼跑 Astro
大多數 Astro 網站（部落格、文件、行銷頁）是純靜態，部署成放在 CDN 的網頁，不用跑伺服器。 需要 SSR 或 API endpoint 時裝 @astrojs/node 並設 mode: "standalone"，就會部署成 web service。
建置與啟動
# Agent Lab 偵測到 Astro 後執行
# What Agent Lab runs once it detects Astro
npm ci
npm run build # astro build
# 預設輸出靜態網頁 → 放 CDN
# 用 @astrojs/node（standalone）做 SSR → 變成 web service，監聽 $PORTPUBLIC_*會送到瀏覽器，不能放金鑰。PORT平台給的埠號（預設 8080），伺服器要監聽它。
或叫 AI 工具做
讀 https://app.agentlab.cresclab.com/agent/deploy.md，把這個 Astro 專案部署到 Agent Lab。先給我建置計畫和需要的環境變數，機密告訴我去主控台哪裡填，上線前等我確認。常見問題
Astro 部署常見問題
部署 Astro 需要 Dockerfile 嗎？
不用。Astro 專案帶著 package.json 上傳，Agent Lab 會自動偵測、建置與啟動；如果最上層有 Dockerfile，就改用你的 Dockerfile。 看文件 →
Astro 網站要付費方案嗎？
純靜態的 Astro 網站在 Free 方案就能放（Free 含 3 個靜態網頁）。要 SSR 的 web service，Free 方案可以跑 1 個 S 應用程式（閒置 15 分鐘休眠），要常駐或自訂網域再升級 Pro。
API 金鑰這類機密要放哪？
放在專案設定的 Secrets，程式用環境變數讀。session secret 這類隨機值可以在主控台直接產生，沒有人看得到。上傳裡如果被找到金鑰，會在上線前擋下來。
可以用 Claude Code 或 Codex 部署 Astro 嗎？
可以。先接上 Agent Lab MCP（一行指令、瀏覽器登入、不用 API 金鑰），然後說「把這個 Astro 專案部署上去」。工具會建專案、上傳、等建置完成，上線前先問你。 接上 MCP →
Astro 可以免費部署嗎？
Free 方案 NT$0：1 個 S 應用程式（閒置 15 分鐘休眠）、1 個 S 資料庫、3 個靜態網頁、每月 100 分鐘建構、5 GB 流量，到上限就暫停、不會收費。要常駐、接自訂網域，Pro 每月 NT$990（未稅）。 看定價 →