在 Railway 上使用 Node.js 和 PostgreSQL 搭配 Drizzle

创建 Railway 项目

登录你的 Railway 仪表盘，然后点击 New Project 按钮。

创建 PostgreSQL 数据库

在项目画布上，点击右上角的 New 按钮，然后选择 Database → PostgreSQL。你也可以使用命令面板（Cmd/Ctrl + K）并搜索 PostgreSQL。Railway 会为你创建一个新的 PostgreSQL 实例。

获取连接字符串

点击项目中的 PostgreSQL 服务，进入 Variables 选项卡，找到 DATABASE_PUBLIC_URL 变量。复制该值——它应该类似于这样：

postgresql://postgres:password@region.railway.app:port/railway

设置连接字符串变量

在项目根目录创建一个 .env 文件，并添加 DATABASE_URL 环境变量。使用 Railway 提供的公共连接字符串：

DATABASE_URL=postgresql://postgres:password@region.railway.app:port/railway

将 Drizzle ORM 连接到数据库

创建一个 db.ts 文件并设置数据库配置：

import { drizzle } from "drizzle-orm/node-postgres";

export const db = drizzle(process.env.DATABASE_URL!);

创建表

创建一个 schema.ts 文件并声明你的表：

import * as p from "drizzle-orm/pg-core";

export const usersTable = p.pgTable("users", {
  id: p.serial().primaryKey(),
  name: p.text().notNull(),
  age: p.integer().notNull(),
  email: p.text().notNull().unique(),
});

export const postsTable = p.pgTable("posts", {
  id: p.serial().primaryKey(),
  title: p.text().notNull(),
  content: p.text().notNull(),
  userId: p
    .integer()
    .notNull()
    .references(() => usersTable.id, { onDelete: "cascade" }),
  createdAt: p.timestamp().notNull().defaultNow(),
  updatedAt: p
    .timestamp()
    .notNull()
    .$onUpdate(() => new Date()),
});

export type InsertUser = typeof usersTable.$inferInsert;
export type SelectUser = typeof usersTable.$inferSelect;

export type InsertPost = typeof postsTable.$inferInsert;
export type SelectPost = typeof postsTable.$inferSelect;

设置 Drizzle 配置文件

Drizzle config - 一个配置文件，由 Drizzle Kit 使用，包含关于你的数据库连接、迁移文件夹和 schema 文件的所有信息。

在项目根目录创建一个 drizzle.config.ts 文件，并添加以下内容：

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/schema.ts",
  out: "./migrations",
  dialect: "postgresql",
  dbCredentials: {
    url: process.env.DATABASE_URL!,
  },
});

将更改应用到数据库

你可以使用 drizzle-kit generate 命令生成迁移，然后使用 drizzle-kit migrate 命令运行它们。

生成迁移：

npx drizzle-kit generate

generate 命令只会根据你的 schema 创建迁移 SQL 文件——它不会对数据库应用任何更改。这些迁移会按照 drizzle.config.ts 中的配置存储在 migrations 目录下。这个目录将包含更新数据库 schema 所需的 SQL 文件，以及一个用于存储不同迁移阶段 schema 快照的 meta 文件夹。

生成的迁移示例：

CREATE TABLE "posts" (
	"id" serial PRIMARY KEY NOT NULL,
	"title" text NOT NULL,
	"content" text NOT NULL,
	"userId" integer NOT NULL,
	"createdAt" timestamp DEFAULT now() NOT NULL,
	"updatedAt" timestamp NOT NULL
);
--> 语句分隔点
CREATE TABLE "users" (
	"id" serial PRIMARY KEY NOT NULL,
	"name" text NOT NULL,
	"age" integer NOT NULL,
	"email" text NOT NULL,
	"CONSTRAINT" "users_email_unique" UNIQUE("email")
);
--> 语句分隔点
ALTER TABLE "posts" ADD CONSTRAINT "posts_userId_users_id_fk" FOREIGN KEY ("userId") REFERENCES "public"."users"("id") ON DELETE cascade ON UPDATE no action;

将生成的迁移应用到数据库：

npx drizzle-kit migrate

或者，你也可以使用 Drizzle kit push command 直接将更改推送到数据库：

npx drizzle-kit push

为部署准备项目

一旦你生成了迁移，就将 migrations 目录提交到你的仓库中——这些文件会在应用启动时自动应用。

创建一个 index.ts 文件作为应用入口点。这个示例会在启动时运行迁移，然后使用 Node.js 启动一个简单的 HTTP 服务器：

import { createServer } from "node:http";
import { drizzle } from "drizzle-orm/node-postgres";
import { migrate } from "drizzle-orm/node-postgres/migrator";
import { usersTable } from "./schema";

const db = drizzle(process.env.DATABASE_URL!);

await migrate(db, { migrationsFolder: "./migrations" });

const server = createServer(async (req, res) => {
  const url = new URL(req.url!, `http://${req.headers.host}`);

  if (url.pathname === "/users") {
    const users = await db.select().from(usersTable);
    res.writeHead(200, { "Content-Type": "application/json" });
    res.end(JSON.stringify(users));
    return;
  }

  res.writeHead(200);
  res.end("OK");
});

const port = process.env.PORT || 3000;
server.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

migrate() 函数会读取你 migrations 目录中的 SQL 文件，并将所有尚未应用的迁移应用到数据库。它可以安全地在每次启动时运行——已经应用过的迁移会被跳过。

确保你的 package.json 包含模块类型和一个 start 脚本：

{
  "type": "module",
  "scripts": {
    "start": "tsx src/index.ts"
  }
}

将项目推送到 GitHub

Railway 从 GitHub 仓库部署。初始化一个 git 仓库并推送你的代码：

git init
git add .
git commit -m "initial commit"

在 GitHub 上创建一个新仓库并将你的代码推送到其中。

将 GitHub 仓库连接到 Railway

在你的 Railway 项目中，点击画布右上角的 New 按钮，然后选择 GitHub Repo。如果提示，请连接你的 GitHub 账户，然后选择你刚刚推送的仓库。

配置环境变量

在已部署服务的设置中，进入 Variables 选项卡。通过引用 PostgreSQL 服务变量添加 DATABASE_URL 变量：

点击 Add Variable，将名称设置为 DATABASE_URL，并使用 Railway 变量引用 ${{Postgres.DATABASE_URL}} 作为值。

部署

当你将代码推送到已连接的分支时，Railway 会自动部署你的应用。你可以在 Deployments 选项卡中监控部署过程。

验证你的设置

部署完成后，前往 Railway 项目的 Architecture 选项卡。你应该能看到你的应用服务已连接到 PostgreSQL 数据库。

npx drizzle-kit migrate

从模板添加新服务

在你的 Railway 项目中，点击画布右上角的 New 按钮，并选择 Template。

选择 Drizzle Studio 模板

搜索 drizzle studio，并选择由 Drizzle 提供的 Drizzle Studio 模板。

配置环境变量并部署

该模板预先配置了两个环境变量：

• PASSCODE - 用于安全访问你的 Studio 实例的密码。默认值为 ${{secret()}}，它会生成一个随机密钥。
• DATABASE_URL - 数据库连接字符串。将其设置为 ${{Postgres.DATABASE_URL}}，以引用你现有的 PostgreSQL 服务。

点击 Deploy Template 进行部署。

找到你的 Drizzle Studio URL

部署完成后，点击项目中的 Drizzle Studio 服务，进入 Settings 选项卡，然后向下滚动到 Networking 部分。你会在 Public Networking 下找到你的公共域名。

使用 Drizzle Studio 浏览你的数据库

在浏览器中打开 Drizzle Studio 的 URL。你应该能看到数据库表，并可以直接浏览、筛选和编辑数据。

验证你的设置

进入 Railway 项目的 Architecture 选项卡。此时你应该能看到三个服务：你的应用、PostgreSQL 数据库以及 Drizzle Studio。