跳到正文

在 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 使用。

您会得到什么

  • kaeso-edge
    镜像
    控制台镜像,运行 kaeso-edge
    谁能访问
    所有人,通过它的 Railway 域名或您自己的域名
  • kaeso-gateway
    镜像
    网关镜像
    谁能访问
    边缘服务,通过 Railway 的私有网络
  • kaeso-console
    镜像
    控制台镜像
    谁能访问
    边缘服务,通过 Railway 的私有网络
  • kaeso-postgres
    镜像
    Railway Postgres
    谁能访问
    网关
  • kaeso-valkey
    镜像
    Railway Redis
    谁能访问
    网关

Railway 的私有网络只支持 IPv6,因此网关在 [::]:8080 上监听,并信任来自唯一本地地址范围的边缘服务。每个服务都把 PORT 设为自己监听的端口,Railway 的健康检查会调用它。自动镜像更新已关闭,所以各服务会停留在部署时的版本上。

用按钮部署

  1. 在 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 域名。

  2. 部署,等待五个服务上线。

  3. 打开网关发给您的一次性设置链接,创建第一个用户。

  4. 把 kaeso-gateway 变量中的 KAESO_MASTER_KEYS 复制到密码管理器。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。

没有 SMTP 服务器,网关不会启动;它的镜像也没有 shell,所以 railway ssh 无法打印设置链接。如果没有收到邮件,网关的日志会写明 SMTP 错误。改正变量后重新部署网关:在没有用户之前,它每次启动都会发送一个新链接。

用 CLI 部署

先生成主密钥,并保存在密码管理器中:

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 日停止工作,因此仓库中两者都没有。

使用自己的域名

在 kaeso-edge 的 Settings 中添加域名,把 kaeso-gateway 的 KAESO_PUBLIC_URL 设为 https:// 加该域名,然后重新部署网关。

更新和回滚

对于用按钮创建的项目,在每个服务的 Settings 中,把 kaeso-gateway、kaeso-console 和 kaeso-edge 的镜像标签改为新版本,先改网关。对于用文件创建的项目,应用新版本的 railway.ts,Railway 会重新部署有变化的部分。网关在启动时迁移数据库,只向前进行。要回滚,从服务的 Deployments 列表中重新部署之前的一次部署。

已验证的内容

2026 年 11 月 9 日,文件被应用到一个空的 Railway 项目,模板则部署到另一个项目,两者都使用第 8 个候选版本。在两个项目中,五个服务都已上线,边缘服务在 Railway 域名上提供控制台和 API,第一个用户已创建并登录。这次运行发现缺少 PORT,现在文件和模板都会设置它。邮件投递、流式回复和更新尚未在 Railway 上测试。

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

curl -fsSLhttps://kaeso.app/install.sh | sh