---
title: 在 Railway 上部署 Kaeso
description: 点击 Deploy on Railway，即可在 Railway 上运行，主密钥会自动生成；也可以用 Railway CLI，应用基础设施文件。五个服务、一个公开边缘，加上 Railway Postgres、Redis。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-railway
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-railway.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-railway.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-railway.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - railway
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-railway/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 Railway 上部署 Kaeso

点击 Deploy on Railway，即可在 Railway 上运行，主密钥会自动生成；也可以用 Railway CLI，应用基础设施文件。五个服务、一个公开边缘，加上 Railway Postgres、Redis。

> Kaeso 的所有页面、文章和文档页面都列在 https://kaeso.app/zh-CN/llms.txt 中。

- 发布日期：2026年11月11日
- 阅读时间：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. 打开 [Deploy on Railway](https://railway.com/deploy/cmVV60) 并登录。
2. 在 `kaeso-gateway` 下填写这些变量：

   | 变量 | 填写内容 |
   | --- | --- |
   | `KAESO_SETUP_EMAIL` | 您的邮箱地址；网关把设置链接发送到这里 |
   | `KAESO_SMTP_HOST`、`KAESO_SMTP_FROM` | 您的 SMTP 服务器，以及 Kaeso 邮件的发件人 |
   | `KAESO_SMTP_USER`、`KAESO_SMTP_PASSWORD` | 服务器的用户名和密码，如果需要的话 |
   | `KAESO_SMTP_PORT` | `587`，除非您的服务器使用其他端口 |
   | `KAESO_CLICKHOUSE_URL` | 用于请求日志的、带用户名和密码的 ClickHouse HTTP URL，或留空 |

   其余的由模板填写：`KAESO_MASTER_KEYS` 是 Railway 的 `secret()` 函数生成的 32 个随机字节，`KAESO_PUBLIC_URL` 是边缘服务的 Railway 域名。

3. 部署，等待五个服务上线。
4. 打开网关发给您的一次性设置链接，创建第一个用户。
5. 把 `kaeso-gateway` 变量中的 `KAESO_MASTER_KEYS` 复制到密码管理器。Kaeso 用它加密服务商密钥，因此没有它，数据库备份就无法读取。

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

## 用 CLI 部署

先生成主密钥，并保存在密码管理器中：

```bash
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate
```

然后创建一个空项目：

```bash
railway login
railway init
```

在项目的 **Settings** 中，于 **Shared Variables** 下添加 `KAESO_PUBLIC_URL`（暂时填一个占位值）、`KAESO_MASTER_KEYS`、`KAESO_SETUP_EMAIL`、您 SMTP 服务器的各项 `KAESO_SMTP_*` 值，以及用于请求日志的 `KAESO_CLICKHOUSE_URL`。

把该版本的 [`.railway/railway.ts`](https://github.com/logicplanes/kaeso/blob/v0.6.0/.railway/railway.ts) 放进您自己的一个文件夹，安装 Railway 的 TypeScript 包并应用它：

```bash
npm install railway
railway 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 上测试。

## 下一步

- [文档中的 Railway](https://docs.kaeso.app/zh-CN/self-hosting/platforms/railway)，包含每个变量。
- [备份和主密钥](https://docs.kaeso.app/zh-CN/self-hosting/backups)：备份 Railway Postgres，并把主密钥保存在 Railway 之外。
- [在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso)：Railway 与其他平台的比较。

作者：Kaeso Team

## 更多文章

- [在 Render 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render.md)：借助仓库里的蓝图，在 Render 上运行它：公开边缘、私有网关和控制台，加上 Render Postgres、Key Value。从主密钥到自己的域名，逐步讲解。
- [在 DigitalOcean 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-digitalocean.md)：用一键部署按钮，部署到 App Platform；或在生产环境中，用 doctl 和托管 Valkey。应用自带的边缘服务，在同一个域名上，路由控制台和 API。

[查看所有文章](https://kaeso.app/zh-CN/articles.md)

## 网关归您。记录也归您

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[安装 Kaeso](https://docs.kaeso.app/zh-CN/self-hosting/installation) · [打开在线演示](https://demo.kaeso.app)
