框架指南

這些指南演示如何從 Git 儲存庫部署各類典型應用。每篇都給出一個最小應用、Zenavo 識別出的內容、需要的設定，以及我們最常見到的錯誤。

指南	涵蓋
Next.js	使用 App Router 或 Pages Router 的 Next.js，next start 或 output: 'standalone'
Node.js 與 Express	Express、Fastify、Koa 以及任何 Node.js 伺服器
Python	FastAPI、Django 和 Flask
Go	net/http、Gin、Echo、Fiber 以及任何 Go 伺服器
Laravel	基於 PHP-FPM 和 nginx 的 Laravel，包括資料庫遷移和 Vite
Spring Boot	使用 Maven 或 Gradle 的 Spring Boot
靜態網站	純 HTML 和建置產物：Vite、React、Vue、Astro、Hugo 的輸出

所有指南都假設你已經有一台伺服器和一個專案：見快速開始。

共同要點

• 沒有 Dockerfile 時，由 zbpack 建置應用。 部署前在 建置計劃預覽 中檢查它識別出的內容。如果根目錄中有 Dockerfile，則直接使用它。
• 監聽 0.0.0.0 和 $PORT。 Zenavo 把 PORT 設為服務的連接埠，zbpack 建置時是 8080。只監聽 localhost 或 127.0.0.1 的伺服器無法被存取，部署永遠不會變為健康。
• 設定來自變數。 在服務的 變數 分頁中設定；資料庫的連線資訊以 <NAME>_CONNECTION_STRING 等變數提供（資料庫）。變數在下次部署時生效。
• 檔案系統不會保留，部署和重啟後都會重置。上傳檔案和其他需要保留的檔案請放在儲存卷中，或者放在資料庫或物件儲存中。
• Monorepo 把服務的 根目錄 設為應用所在的資料夾，並設定監聽路徑，只在它有改動時建置。