通过 Tailscale 连接 Railway 私有数据库中的 Drizzle Kit [已过时]

创建 Railway 项目

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

创建 PostgreSQL 数据库

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

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

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

检查 MagicDNS 和 HTTPS 证书

在 Tailscale 管理控制台中打开 DNS 页面。必须同时启用 MagicDNS 和 HTTPS Certificates。每个区域显示的都是相反操作，因此如果按钮显示 Disable MagicDNS...，就表示 MagicDNS 已启用。

MagicDNS 会为转发器提供稳定的机器名称，数据库连接需要用到该名称。数据库连接本身不需要 HTTPS 证书，但通过转发器打开数据库 UI 时需要证书。两个设置都位于此页面。

创建可重复使用的 auth key

在设置菜单中打开 Keys 页面，然后点击 Generate auth key。填写说明并启用 Reusable，其他设置保持不变。可重复使用的 key 可让转发器在没有现有状态时重新启动并注册自身。

点击 Generate key。现在就复制此 key，因为管理控制台只会显示一次。

部署 Tailscale 转发器

Tailscale 转发器是一个小型 TCP 代理。它会作为一台机器加入你的 tailnet，并将该机器上的端口转发到 Railway 私有网络中的服务。Railway 提供了此模板，模板运行 brody192/tailscale-forwarder 镜像。

打开 Deploy to 下拉菜单并选择数据库所在的项目。两项服务必须位于同一个项目中，否则转发器将无法通过私有网络访问数据库，因为它们会被放置在不同的私有网络中。

将 auth key 粘贴到 TS_AUTHKEY 中，然后将数据库映射设置到 CONNECTION_MAPPING_01。格式为 [https:]<source port>:<target host>:<target port>。

5432:${{Postgres.RAILWAY_PRIVATE_DOMAIN}}:${{Postgres.PGPORT}}

此设置会将转发器上的 5432 端口转发到数据库。

部署并检查日志

点击 Deploy。模板会挂载一个卷并设置 TS_EPHEMERAL=false，这样机器在重新部署时会保留相同身份，而不会重复注册。

打开 Deployments 选项卡并查看部署日志。以下三行可以确认转发器已正确启动：

• tsnet starting with hostname "..." 会显示机器在 tailnet 中的名称，后续步骤会用到。
• Starting tailscale_fwdr 会列出已解析的设置，包括 ts-ephemeral: false 以及每条映射的源端口、目标地址和目标端口。
• listening for connections 表示转发器正在相应源端口上接收流量。

复制转发器域名

TS_HOSTNAME 默认由项目名称、环境名称和服务名称以连字符连接组成，例如 my-project-production-tailscale-forwarder。部署日志会在 tsnet starting with hostname 行中显示此值。

在 Tailscale 管理控制台中打开机器页面。转发器使用有效 auth key 启动后，会自动显示在此页面。

点击机器名称打开详情页。在 Machine Details 下复制 Full domain 的值。你的机器会使用该主机名进行连接。

设置连接字符串

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

将主机名 ***.railway.internal 替换为 Tailscale 转发器域名，并保留连接字符串的其余部分。Railway 外部的机器无法解析 railway.internal，因此需要通过 Tailscale 转发器连接。将结果写入 .env 文件。

DATABASE_URL=postgresql://postgres:password@<full-domain>:5432/railway

设置 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 中打开数据库：

npx drizzle-kit studio

它会在你的机器上运行并读取同一个 DATABASE_URL，因此可以通过转发器访问数据库。此时即可看到新建的数据表。