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

成功驗證後，初始化一個新項目。

railway init

步驟 4

初始化項目後，添加一個新的數據庫和服務。

NOTE

步驟 4 僅在你的應用程序使用數據庫時才需要。如果不需要 PostgreSQL，請跳至步驟 5。

# 添加 PostgreSQL 數據庫。確保先添加這個！
railway add --database postgres

# 添加你的應用程序服務。
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}

步驟 5

創建並連接服務後，將應用程序部署到 Railway。默認情況下，服務僅在 Railway 的私有網絡內可訪問。要使你的應用程序公開訪問，你需要生成一個公共域名。

# 部署你的應用程序
railway up

# 生成公共域名
railway domain

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

---

方法 2：通過儀表板部署

步驟 1

創建一個新項目

1. 前往 Railway 儀表板
2. 點擊 "+ New" → "GitHub repo"
3. 選擇你的倉庫

步驟 2

添加 PostgreSQL 數據庫，並將此數據庫連接到服務

NOTE

步驟 2 僅在你的應用程序使用數據庫時才需要。如果不需要 PostgreSQL，請跳至步驟 3。

1. 點擊 "+ New" → "Database" → "Add PostgreSQL"
2. 數據庫創建後，選擇你的服務（不是數據庫）
3. 前往 "Variables" 選項卡
4. 點擊 "+ New Variable" → "Add Reference"
5. 從 postgres 中選擇 DATABASE_URL

步驟 3

生成公共域名

1. 選擇你的服務
2. 前往 "Settings" 選項卡
3. 在 "Networking" 下，點擊 "Generate Domain"

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

---

配置（可選）

默認情況下，Railway 使用 Nixpacks 自動檢測並使用零配置構建你的 Bun 應用程序。

但是，使用 Railpack 應用程序構建器提供更好的 Bun 支持，並將始終支持最新版本的 Bun。預配置的模板默認使用 Railpack。

要在自定義項目中啟用 Railpack，請將以下內容添加到你的 railway.json：

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

有關更多構建配置設置，請查閱 Railway 文檔。