在 Railway 上部署 Kaeso
点击 Deploy on Railway,即可在 Railway 上运行,主密钥会自动生成;也可以用 Railway CLI,应用基础设施文件。五个服务、一个公开边缘,加上 Railway Postgres、Redis。
- 发布日期
- 阅读时间
- 4 分钟
- 作者
- Kaeso Team

在平台上试用 Kaeso,Railway 是最快的方式:Deploy on Railway 按钮会创建整个项目,生成主密钥,并填好公开地址。您只需填写邮箱地址和一个 SMTP 服务器,然后等待五个服务上线。
对于把基础设施写成代码的团队,仓库中还有 .railway/railway.ts,即以 Railway 的 TypeScript 格式描述的同一个项目,供 Railway CLI 使用。
您会得到什么01
kaeso-edge- 镜像
- 控制台镜像,运行
kaeso-edge - 谁能访问
- 所有人,通过它的 Railway 域名或您自己的域名
kaeso-gateway- 镜像
- 网关镜像
- 谁能访问
- 边缘服务,通过 Railway 的私有网络
kaeso-console- 镜像
- 控制台镜像
- 谁能访问
- 边缘服务,通过 Railway 的私有网络
kaeso-postgres- 镜像
- Railway Postgres
- 谁能访问
- 网关
kaeso-valkey- 镜像
- Railway Redis
- 谁能访问
- 网关
| 服务 | 镜像 | 谁能访问 |
|---|---|---|
kaeso-edge | 控制台镜像,运行 kaeso-edge | 所有人,通过它的 Railway 域名或您自己的域名 |
kaeso-gateway | 网关镜像 | 边缘服务,通过 Railway 的私有网络 |
kaeso-console | 控制台镜像 | 边缘服务,通过 Railway 的私有网络 |
kaeso-postgres | Railway Postgres | 网关 |
kaeso-valkey | Railway Redis | 网关 |
Railway 的私有网络只支持 IPv6,因此网关在 [::]:8080 上监听,并信任来自唯一本地地址范围的边缘服务。每个服务都把 PORT 设为自己监听的端口,Railway 的健康检查会调用它。自动镜像更新已关闭,所以各服务会停留在部署时的版本上。
用按钮部署02
- 01
打开 Deploy on Railway(在新标签页中打开) 并登录。
- 02
在
kaeso-gateway下填写这些变量:变量 填写内容 KAESO_SETUP_EMAIL您的邮箱地址;网关把设置链接发送到这里 KAESO_SMTP_HOST、KAESO_SMTP_FROM您的 SMTP 服务器,以及 Kaeso 邮件的发件人 KAESO_SMTP_USER、KAESO_SMTP_PASSWORD服务器的用户名和密码,如果需要的话 KAESO_SMTP_PORT587,除非您的服务器使用其他端口KAESO_CLICKHOUSE_URL用于请求日志的、带用户名和密码的 ClickHouse HTTP URL,或留空 其余的由模板填写:
KAESO_MASTER_KEYS是 Railway 的secret()函数生成的 32 个随机字节,KAESO_PUBLIC_URL是边缘服务的 Railway 域名。 - 03
部署,等待五个服务上线。
- 04
打开网关发给您的一次性设置链接,创建第一个用户。
- 05
把
kaeso-gateway变量中的KAESO_MASTER_KEYS复制到密码管理器。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。
没有 SMTP 服务器,网关不会启动;它的镜像也没有 shell,所以 railway ssh 无法打印设置链接。如果没有收到邮件,网关的日志会写明 SMTP 错误。改正变量后重新部署网关:在没有用户之前,它每次启动都会发送一个新链接。
用 CLI 部署03
先生成主密钥,并保存在密码管理器中:
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate然后创建一个空项目:
railway loginrailway init在项目的 Settings 中,于 Shared Variables 下添加 KAESO_PUBLIC_URL(暂时填一个占位值)、KAESO_MASTER_KEYS、KAESO_SETUP_EMAIL、您 SMTP 服务器的各项 KAESO_SMTP_* 值,以及用于请求日志的 KAESO_CLICKHOUSE_URL。
把该版本的 .railway/railway.ts(在新标签页中打开) 放进您自己的一个文件夹,安装 Railway 的 TypeScript 包并应用它:
npm install railwayrailway config apply在 kaeso-edge 的 Settings 中,为端口 8080 添加一个域名。把 KAESO_PUBLIC_URL 设为 https:// 加该域名,然后重新部署 kaeso-gateway;设置链接会通过邮件送达。
Railway 把基础设施即代码标为实验性功能,所以它的 API 仍可能变化。Railway 较早的 railway.json 和 railway.toml 将于 2026 年 12 月 1 日停止工作,因此仓库中两者都没有。
使用自己的域名04
在 kaeso-edge 的 Settings 中添加域名,把 kaeso-gateway 的 KAESO_PUBLIC_URL 设为 https:// 加该域名,然后重新部署网关。
更新和回滚05
对于用按钮创建的项目,在每个服务的 Settings 中,把 kaeso-gateway、kaeso-console 和 kaeso-edge 的镜像标签改为新版本,先改网关。对于用文件创建的项目,应用新版本的 railway.ts,Railway 会重新部署有变化的部分。网关在启动时迁移数据库,只向前进行。要回滚,从服务的 Deployments 列表中重新部署之前的一次部署。
已验证的内容06
2026 年 11 月 9 日,文件被应用到一个空的 Railway 项目,模板则部署到另一个项目,两者都使用第 8 个候选版本。在两个项目中,五个服务都已上线,边缘服务在 Railway 域名上提供控制台和 API,第一个用户已创建并登录。这次运行发现缺少 PORT,现在文件和模板都会设置它。邮件投递、流式回复和更新尚未在 Railway 上测试。
下一步07
- 文档中的 Railway(在新标签页中打开),包含每个变量。
- 备份和主密钥(在新标签页中打开):备份 Railway Postgres,并把主密钥保存在 Railway 之外。
- 在哪里运行 Kaeso:Railway 与其他平台的比较。
作者:Kaeso Team


