Skip to main content
Railway 是一个基础设施平台，您可以在这里配置基础设施，在本地使用该基础设施进行开发，然后部署到云端。它支持从 GitHub 通过零配置实现即时部署，自动 SSL 以及内置数据库配置。 本指南演示如何部署带有 PostgreSQL 数据库（可选）的 Bun 应用，这正是下面模板所提供的内容。 您可以按照本指南逐步操作，也可以只需一键部署预配置好的模板： Deploy on Railway
先决条件：
  • 准备好的 Bun 应用
  • 一个 Railway 账号
  • Railway CLI（用于 CLI 部署方法）
  • 一个 GitHub 账号（用于仪表盘部署方法）

​
方法一：通过 CLI 部署

1

步骤 1

确保已安装 Railway CLI。
terminal
bun install -g @railway/cli
2

步骤 2

登录您的 Railway 账号。
terminal
railway login
3

步骤 3

认证成功后，初始化一个新项目。
terminal
railway init
4

步骤 4

初始化项目后，添加新的数据库和服务。
如果您的应用不使用数据库，跳过步骤 4，直接进行步骤 5。
terminal
# 添加 PostgreSQL 数据库。请确保先添加此项！
railway add --database postgres

# 添加您的应用服务
railway add --service bun-react-db --variables DATABASE_URL=\${{Postgres.DATABASE_URL}}
5

步骤 5

服务创建并连接完成后，将应用部署到 Railway。默认情况下，服务仅在 Railway 的私有网络内可访问。若要让您的应用公开访问，需要生成公共域名。
terminal
# 部署您的应用
railway up

# 生成公共域名
railway domain
您的应用现已上线！Railway 会在每次 GitHub 推送时自动部署。

​
方法二：通过仪表盘部署

1

步骤 1

创建新项目
  1. 打开 Railway 仪表盘
  2. 点击 ”+ 新建” → “GitHub 仓库”
  3. 选择您的代码仓库
2

步骤 2

添加 PostgreSQL 数据库，并将该数据库连接到服务
如果应用不使用数据库，此步骤可跳过，直接进行步骤 3。
  1. 点击 ”+ 新建” → “数据库” → “添加 PostgreSQL”
  2. 数据库创建完成后，选择您的服务（不是数据库）
  3. 转到 “变量” 标签页
  4. 点击 ”+ 创建新变量” → “添加引用”
  5. 从 postgres 中选择 DATABASE_URL
3

步骤 3

生成公共域名
  1. 选择您的服务
  2. 转到 “设置” 标签页
  3. 在 “网络” 区块，点击 “生成域名”
您的应用现已上线！Railway 会在每次 GitHub 推送时自动部署。

​
配置（可选）

默认情况下，Railway 使用 Nixpacks 自动检测并零配置构建您的 Bun 应用。 但使用 Railpack 应用构建器能提供更好的 Bun 支持，并始终支持最新版本的 Bun。预配置模板默认使用 Railpack。 要在自定义项目中启用 Railpack，请在您的 railway.json 文件中添加以下内容：
railway.json
{
  "$schema": "https://railway.com/railway.schema.json",
  "build": {
    "builder": "RAILPACK"
  }
}
更多构建配置细节，请参考 Railway 文档。