如何建立及部署 Next.js 應用程式

建構 Next.js 網頁應用程式,只是將構想化為線上服務的第一步。如要讓應用程式快速、回應靈敏且讓使用者輕鬆找到,就必須選擇合適的部署設定。

無論是使用自然語言提示詞建構 AI 網頁原型,還是部署從 Claude Code 或 Replit 等工具匯出的全端程式碼集,現代雲端平台都能提供流暢的託管途徑。本指南將說明 Next.js 的運作方式、重要的算繪架構考量,並逐步引導您使用免付費的入門級選項,將應用程式部署至代管基礎架構。

在 Cloud Run 執行 Next.js 應用程式

什麼是 Next.js?

Next.js 是開放原始碼 React 框架,旨在協助開發人員建構全端網頁應用程式。標準 React 應用程式通常在網路瀏覽器的用戶端執行,而 Next.js 則結合了用戶端互動性和伺服器端算繪。

Next.js 會自動處理頁面轉送、伺服器元件和資產最佳化,讓開發人員和直覺式程式開發人員只需進行最少設定,就能將創意概念轉化為可用於正式環境的網頁應用程式。

傳統 React 與 Next.js

選擇標準 React 或 Next.js 取決於您的轉譯需求、搜尋引擎能見度和後端需求:

功能

React (預設)

Next.js

算繪架構

用戶端算繪 (CSR)

伺服器端算繪 (SSR)、靜態網站生成 (SSG) 和 React 伺服器元件

搜尋引擎最佳化 (SEO)

可能需要額外的預先算繪設定

透過伺服器端算繪的 HTML,開箱即享易用的搜尋引擎

初次載入網頁

由於用戶端 JavaScript 組合較大,在低功率裝置上速度較慢

使用輕量級伺服器端算繪 HTML,加快初始顯示速度

轉送機制

需要第三方轉送程式庫 (例如 React Router)

透過 App Router 內建檔案系統式轉送

全端功能

僅限前端;需要獨立的後端服務

內建 API 路由處理常式和伺服器動作

傳統應用程式託管與無伺服器容器的比較

準備推出 Next.js 應用程式時,選擇合適的運算環境會直接影響維護負擔、資源調度速度和營運成本。

功能

虛擬機器 (VPS/IaaS)


PaaS/buildpack 平台


無伺服器容器 (Cloud Run)


基礎建設管理

高;手動進行作業系統更新及伺服器修補工作

全代管平台層,採用供應商專屬慣例

全代管基礎架構,不需維護作業系統

自動調整資源配置行為

需要幾分鐘才能佈建及啟動新的虛擬機器

快速自動調度資源,通常與分層工作站方案或並行上限相關

根據要求即時自動調度資源,包括在閒置時將資源調度率降至零

封裝格式

原始建構檔案或 PM2 程序管理工具

Git 存放區與專屬建構系統整合

標準開放容器倡議 (OCI) 和 Docker 容器映像檔

閒置成本

無論是否有傳入流量,都會全天候計費

基本月費或免費方案的嚴格執行限制

提供免付費的入門級配額,或在要求執行期間嚴格按秒計費

供應商可攜性

高,但設定可能難以複製

低;設定取決於供應商專屬的託管規則

高;標準容器映像檔可在任何雲端或本機環境中執行

建立 Next.js 應用程式時的重要考量

如要建構可部署於正式環境的 Next.js 應用程式,必須解決核心架構模式,確保效能快速且運作時間穩定:

用戶端和伺服器邊界

Next.js 預設使用 React 伺服器元件。伺服器元件會直接擷取資料,不會將大量 JavaScript 傳送至瀏覽器,而互動式 UI 元素則會使用「use client」指令。讓用戶端元件專注於互動式 UI 工作,保持精簡快速的用戶端組合。

用戶端環境變數

為避免將非公開 API 金鑰或資料庫憑證洩漏給公開瀏覽器,Next.js 會限制瀏覽器存取前置字元為 NEXT_PUBLIC_ 的變數。請一律不要為私人伺服器密鑰加上前置字元,並在環境設定中安全地管理這些密鑰。

無狀態的無伺服器執行環境

現代無伺服器平台會根據傳入流量,啟動和關閉容器執行個體。直接儲存至本機容器磁碟的檔案,會在執行個體縮減或重新部署時消失。將永久性應用程式資料儲存在 Cloud Firestore 或 PostgreSQL 適用的 Cloud SQL 等代管雲端資料庫中,並將使用者上傳的內容儲存在 Cloud Storage。

獨立輸出追蹤

在自訂容器部署作業,於 Next.js 設定中啟用輸出 'standalone'。這項功能會自動追蹤依附元件,並只將必要檔案封裝至精簡的建構資料夾,縮減容器映像檔大小,並加快容器啟動速度。

如何建立及部署 Next.js 應用程式

您可以透過兩種主要工作流程,建立及啟動 Next.js 應用程式:快速 AI 原型設計 (不需設定本機 CLI) 或標準容器部署 (適用於自訂程式碼集)。

途徑 A:使用 AI Studio 建構模式和入門級,快速設計原型

如要快速建立原型及進行直覺式程式開發工作流程,開發人員可使用 Google AI Studio 的建構模式,以自然語言描述全端 Next.js 應用程式,並直接發布至 Cloud Run,不必管理指令列工具或設定帳單帳戶。

步驟 1:在建構模式中初始化應用程式

  1. 前往 Google AI Studio,切換至「建構模式」。
  2. 輸入應用程式提示詞,說明使用者介面、樣式和商業邏輯 (例如「使用 Next.js 建構協作專案追蹤工具,並提供互動式工作面板和使用者登入功能」)。
  3. 整合式 AI 代理會生成 Next.js 元件檔案、設定 App Router 版面配置、安裝 npm 依附元件,並直接在瀏覽器中顯示即時互動式預覽畫面。

步驟 2:新增整合式資料庫儲存空間和使用者登入功能

  • 永久資料:如果您的提示詞要求資料儲存空間,請啟用 Cloud Firestore 或 PostgreSQL 適用的 Cloud SQL (開發人員版本)。代理會自動草擬資料模型、用戶端連線檔案和安全性規則。
  • 使用者驗證:切換 Firebase 驗證,即可啟用 Google 登入流程,不必編寫自訂 OAuth 重新導向處理常式。

步驟 3:發布至 Cloud Run

  1. 在上方介面中,依序點選「發布」>「開始使用」>「發布應用程式」。
  2. 提供自訂網址 <my-nextjs-app>.ai.studio,並確認部署區域。
  3. 這個平台會封裝容器、佈建基礎運算資源,並在幾秒內提供有效的 *.run.app HTTPS 正式環境網址。

途徑 B:將自訂 Next.js 程式碼集部署至 Cloud Run

如果是現有程式碼集,或從 Claude Code、Replit 等工具或本機開發環境匯出的專案,請將應用程式容器化,並使用 Google Cloud CLI 部署。

步驟 1:設定獨立輸出

更新 next.config.js (或 next.config.mjs) 檔案,產生獨立建構作業:

  • JavaScript
載入中…

步驟 2:建立多級式 Dockerfile

在根資料夾中建立 .dockerignore 檔案,其中包含 node_modules 和 .env,這樣本機開發檔案就不會封裝到容器中。

在專案根目錄中建立 Dockerfile:

  • Dockerfile
載入中…

步驟 3:部署至 Cloud Run

使用 Google Cloud CLI 直接從專案資料夾部署,並指派易於記憶和分享的自訂網址,格式為 <my-cool-app>.cloud.run:

  • Bash
載入中…

免費方案和入門級的定價機制

瞭解免付費配額的運作方式,可確保您能以可預測的方式,建立 Next.js 應用程式的原型並擴充:

選項

運算和資源配額

需求條件和限制

• Cloud Run:最多 2 個運作中的網頁應用程式

• Cloud Firestore:1 GiB 儲存空間、每天 5 萬次讀取、每天 4 萬次寫入

• Cloud SQL:PostgreSQL 開發人員版本 (可將資源調度率降至零)

• Firebase 驗證:包含 Google 登入

• 有效的 Google 帳戶

• 無需信用卡或帳單帳戶

• 資源固定在單一區域

• Cloud Run:每月 200 萬次要求、每月 180,000 vCPU-秒、每月 360,000 GiB-秒、每月 1 GB 北美網路輸出

• 前 90 天可使用價值 $300 美元的迎新抵免額

• 連結的 Cloud Billing 帳戶

• 完整平台 API 存取權,適用於所有區域

在無伺服器環境中執行 Next.js 的最佳做法

  • 使用獨立輸出:一律啟用 Next.js 獨立模式,避免將未使用的開發依附元件封裝至正式環境容器。
  • 為付費專案設定執行個體數量上限:從原型設計沙箱環境轉換至正式環境時,請設定 --max-instances (例如 --max-instances 5),確保流量意外激增時不會超出預算。
  • 運用 React 伺服器元件:將密集資料擷取作業轉移至伺服器元件,讓瀏覽器組合保持輕量,並改善 Core Web Vitals。
  • 確保已內建用戶端環境變數:請記住,NEXT_PUBLIC_ 環境變數會在建構期間嵌入用戶端組合。請務必先定義這些變數,再執行建構階段。

透過 Google Cloud 解決業務難題

新客戶可以獲得價值 $300 美元的免費抵免額,盡情試用各項 Google Cloud 功能。

展開下一步行動

運用價值 $300 美元的免費抵免額和超過 20 項一律免費的產品,開始在 Google Cloud 中建構產品與服務。