在 Railway 上部署 Bun 應用程式

本分步指南涵蓋了 CLI 和儀表板方法、可選的 PostgreSQL 設定和自動 SSL 配置，在 Railway 上部署 Bun 應用程式。

在 GitHub 上編輯

Railway 是一個基礎設施平臺，您可以在其中預置基礎設施，在本地使用該基礎設施進行開發，然後部署到雲端。它支援從 GitHub 進行零配置即時部署、自動 SSL 和內建資料庫預置。

本指南將逐步介紹如何使用 PostgreSQL 資料庫部署 Bun 應用程式（可選），這正是以下模板所提供的。

您可以按照本指南逐步操作，也可以簡單地一鍵部署預配置的模板

先決條件:

準備部署的 Bun 應用程式
Railway 賬戶
Railway CLI（用於 CLI 部署方法）
GitHub 賬戶（用於儀表板部署方法）

方法 1：透過 CLI 部署

步驟 1

確保您已安裝 Railway CLI。

bun install -g @railway/cli

步驟 2

登入您的 Railway 賬戶。

railway login

步驟 3

成功認證後，初始化一個新專案。

# Initialize project
bun-react-postgres$ railway init

步驟 4

專案初始化後，新增新的資料庫和服務。

注意：步驟 4 僅在您的應用程式使用資料庫時才需要。如果您不需要 PostgreSQL，請跳到步驟 5。

# Add PostgreSQL database. Make sure to add this first!
bun-react-postgres$ railway add --database postgres

# Add your application service.
bun-react-postgres$ railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

步驟 5

服務建立並連線後，將應用程式部署到 Railway。預設情況下，服務只能在 Railway 的私有網路中訪問。要使您的應用程式可以公開訪問，您需要生成一個公共域。

# Deploy your application
bun-nextjs-starter$ railway up

# Generate public domain
bun-nextjs-starter$ railway domain

方法 2：透過儀表板部署

步驟 1

建立一個新專案

前往 Railway 儀表板
點選 "+ 新建" → "GitHub 倉庫"
選擇您的倉庫

步驟 2

新增 PostgreSQL 資料庫，並將此資料庫連線到服務

注意：步驟 2 僅在您的應用程式使用資料庫時才需要。如果您不需要 PostgreSQL，請跳到步驟 3。

點選 "+ 新建" → "資料庫" → "新增 PostgreSQL"
資料庫建立後，選擇您的服務（不是資料庫）
轉到 "變數" 選項卡
點選 "+ 新建變數" → "新增引用"
從 postgres 中選擇 DATABASE_URL

步驟 3

生成公共域

選擇您的服務
轉到 "設定" 選項卡
在 "網路" 下，點選 "生成域"

您的應用程式現在已上線！Railway 會在每次 GitHub 推送時自動部署。

配置（可選）

預設情況下，Railway 使用 Nixpacks 自動檢測並構建您的 Bun 應用程式，無需任何配置。

然而，使用 Railpack 應用程式構建器提供了更好的 Bun 支援，並且將始終支援最新版本的 Bun。預配置的模板預設使用 Railpack。

要在自定義專案中啟用 Railpack，請將以下內容新增到您的 railway.json 中

{
  "$schema": "https://railway.com/railway.schema.json",
  "build": {
    "builder": "RAILPACK"
  }
}

有關更多構建配置設定，請檢視 Railway 文件。