通过 Tailscale 使用 Drizzle Kit 连接 Railway 私有数据库

创建 Railway 项目

登录 Railway 控制面板，然后点击 New Project 按钮。

创建 PostgreSQL 数据库

在项目画布中，点击右上角的 New 按钮，然后选择 Database → PostgreSQL。你也可以使用命令面板（ ⌘K CtrlK ）并搜索 PostgreSQL。

将数据库保留在私有网络中

点击 PostgreSQL 服务，打开 Settings 选项卡并找到 Networking 区域。确认公共访问已关闭。在 Private Networking 下方可以看到服务的私有域名，例如 postgres.railway.internal。

打开模板

点击下方按钮打开 Tailscale for Drizzle 模板。

**请先不要部署。**先设置变量。

打开 Deploy to 下拉菜单并选择数据库所在的项目。

设置变量

某些变量（例如 TS_HOSTNAME）位于卡片中折叠的 Pre-Configured Environment Variables 区域。展开后即可查看或修改。

部署模板

在服务卡片上点击 Save Config，然后点击 Review and deploy。Railway 会在侧边栏中打开包含该模板的项目。在侧边栏中点击 Deploy Template。

通过部署日志登录

打开 Tailscale 服务，进入其 Deployments 选项卡并查看部署日志。日志末尾会显示登录链接：

This service is not on your tailnet yet. Open this link and sign in
with the account that owns your tailnet:
  https://login.tailscale.com/a/xxxxxxxxxxxx

打开链接并登录。最先打开链接的人会将这台机器加入其 tailnet，因此不要转发链接。只有 Railway 项目成员可以查看该日志。

如果你的 tailnet 要求审批设备，日志会显示相关提示；在机器页面批准设备后，机器才会继续运行。

检查转发规则

登录几秒后，同一日志中会显示：

joined tailnet: example.com
5432: ready

确认 tailnet 名称属于你。如果不是，说明其他人先打开了登录链接，他们的 tailnet 现在可以访问此服务。要重新取得服务控制权：

1. 在项目画布上点击 Tailscale 服务下方的卷，打开其 Settings 选项卡并点击 Wipe volume。
2. 输入确认文本并点击 Wipe。Railway 会删除机器密钥并重新部署服务。
3. 自行打开新部署日志中的登录链接。
4. 更改数据库用户的密码。

查找机器名称

打开机器页面。新机器的名称就是你在 TS_HOSTNAME 中设置的值。如果 tailnet 中已有同名机器，新名称会以 -1、-2 等后缀结尾。请使用机器页面显示的名称。

设置连接字符串

在 Railway 中打开 PostgreSQL 服务，进入 Variables 选项卡并复制 DATABASE_URL。

将主机名 ***.railway.internal 替换为机器名称，并保留连接字符串的其余部分。将结果写入 .env 文件：

DATABASE_URL=postgresql://postgres:PASSWORD@MACHINE_NAME:5432/railway

替换以下内容：

• PASSWORD：你复制的 DATABASE_URL 中的密码
• MACHINE_NAME：机器页面中显示的机器名称，例如 railway-postgres

设置 Drizzle 配置文件

在项目根目录创建 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!,
  },
});

应用 Schema

生成并应用迁移：

npx drizzle-kit generate

npx drizzle-kit migrate

快速原型开发时，可以使用 drizzle-kit push 直接推送 Schema。生产环境部署时，建议使用 generate 和 migrate 工作流，以保留 Schema 变更的版本历史。详情请参阅 Drizzle 迁移基础。

在 Drizzle Studio 中检查数据表

在 Drizzle Studio 中打开数据库：

npx drizzle-kit studio

它会在你的设备上运行并读取同一个 DATABASE_URL，因此可以通过 Tailscale 服务访问数据库。此时即可看到新建的数据表。