Spacefast 部署 Astro 前：靜態、SSR、分享與資料匯出怎麼驗收？
本文目錄
把 Astro 專案交給 agent 發到 Spacefast 前，先決定要驗收哪一種成品。靜態網站可以發布 dist/；需要在請求時讀取資料或執行伺服器邏輯，就要走支援 SSR 的路徑。 在首頁看到成品，還不能判斷資料功能或分享權限是否正確。
選上傳 dist，還是用 Spacefast adapter？
依 Spacefast 的 Astro 指南，已產出的靜態 dist/ 可直接上傳。Astro 6 以上也有 @spacefast/astro 整合；需要伺服器渲染時，文件列出 @spacefast/astro/adapter。開始前用同一個 Git commit 記錄 Astro 版本、建置指令和部署方式：
- 靜態網站：在本機建置後，檢查
dist/是否有預期的頁面、CSS、圖片和字型。到測試 Space 直接開一個深層網址，再硬重新整理，確認返回的是該頁，而非首頁或 404。 - SSR 或有資料庫的網站：挑一個必須在請求時執行的路由，用無敏感資料的兩筆記錄驗證讀寫。寫入後重新開頁或換瀏覽器讀回，確認結果確實來自伺服器，並核對失敗回應與部署日誌。首頁能顯示不等於此路由已在執行。
分享網址用兩種身分驗收
Spacefast 官網說 Space 預設私人；分享文件另列出可用的授權方式。選好分享範圍後，先用未登入的獨立瀏覽器測首頁和直接網址，再用指定的測試收件者開啟。把分享網址和站點原始網址分別驗收；若打算綁自訂網域，再對新網址重跑一次。測試記錄保留版本、網址和預期的允許／拒絕結果，遇到設定錯誤時容易回查。Space 分享權限控制誰能開啟網站；若產品需要每位使用者各自登入並存取自己的資料，應另外驗收應用程式的身分驗證和授權。
版本回復與搬家要分開準備
Spacefast 的版本紀錄可回復部署。若 app 寫入資料，再依資料庫文件用 sf db export <space> --out <path> 匯出到安全位置，核對測試表筆數與樣本，並記錄欄位及關聯。Spacefast 的內建資料庫透過平台 runtime 介面存取；有匯出檔後，還要確認新平台如何匯入，以及應用程式有哪些呼叫要改寫。原始碼與 lockfile、資料庫匯出、上傳檔案、環境變數名稱和 DNS 設定也要各自有保存方式。
若你在比較 agent 內建託管，可另看 Cursor Apps 的分享驗收。本文於 2026-11-10 查閱 Spacefast 文件；未建立 Space、設定網域或驗證實際資料匯出。
參考資料：