---
title: 在 Railway 上部署
x-i18n:
  generated_at: "2026-02-01T21:36:21Z"
  model: claude-opus-4-5
  provider: pi
  source_hash: 6d5c2ec2f779bb240e778b5e18ffb8138ce175c4bbdf58b2064a6ad200bf4d1b
  source_path: railway.mdx
  workflow: 15
---

通过一键模板在 Railway 上部署 Gensparx，并在浏览器中完成设置。
这是最简单的"无需在服务器上使用终端"的方式：Railway 为你运行 Gateway网关，
你只需通过 `/setup` 网页向导完成所有配置。

## 快速检查清单（新用户）

1. 点击下方的 **Deploy on Railway**。
2. 添加一个挂载到 `/data` 的 **Volume**。
3. 设置必需的**变量**（至少需要 `SETUP_PASSWORD`）。
4. 在端口 `8080` 上启用 **HTTP Proxy**。
5. 打开 `https://<your-railway-domain>/setup` 并完成向导。

## 一键部署

<a href="https://railway.com/deploy/clawdbot-railway-template" target="_blank" rel="noreferrer">
  Deploy on Railway
</a>

部署完成后，在 **Railway → 你的服务 → Settings → Domains** 中找到你的公开 URL。

Railway 会：

- 为你生成一个域名（通常是 `https://<something>.up.railway.app`），或者
- 使用你绑定的自定义域名。

然后打开：

- `https://<your-railway-domain>/setup` — 设置向导（需密码保护）
- `https://<your-railway-domain>/gensparx` — 控制面板 UI

## 你将获得

- 托管的 gensparx Gateway网关 + 控制面板 UI
- `/setup` 网页设置向导（无需终端命令）
- 通过 Railway Volume（`/data`）实现持久化存储，配置/凭证/工作区在重新部署后不会丢失
- 在 `/setup/export` 导出备份，方便日后从 Railway 迁移

## 必需的 Railway 设置

### 公共网络

为服务启用 **HTTP Proxy**。

- 端口：`8080`

### Volume（必需）

挂载一个 Volume 到：

- `/data`

### 变量

在服务上设置以下变量：

- `SETUP_PASSWORD`（必需）
- `PORT=8080`（必需 — 必须与公共网络中的端口一致）
- `GENSPARX_STATE_DIR=/data/.gensparx`（推荐）
- `GENSPARX_WORKSPACE_DIR=/data/workspace`（推荐）
- `GENSPARX_GATEWAY_TOKEN`（推荐；请视为管理员密钥）

## 设置流程

1. 访问 `https://<your-railway-domain>/setup` 并输入你的 `SETUP_PASSWORD`。
2. 选择模型/认证提供商并粘贴你的密钥。
3. （可选）添加 Telegram/Discord/Slack 令牌。
4. 点击 **Run setup**。

如果 Telegram 私信设置为配对模式，设置向导可以批准配对码。

## 获取聊天令牌

### Telegram 机器人令牌

1. 在 Telegram 中给 `@BotFather` 发消息
2. 执行 `/newbot`
3. 复制令牌（格式类似 `123456789:AA...`）
4. 将其粘贴到 `/setup` 中

### Discord 机器人令牌

1. 前往 https://discord.com/developers/applications
2. **New Application** → 选择一个名称
3. **Bot** → **Add Bot**
4. 在 Bot → Privileged Gateway Intents 下**启用 MESSAGE CONTENT INTENT**（必需，否则机器人启动时会崩溃）
5. 复制 **Bot Token** 并粘贴到 `/setup` 中
6. 邀请机器人加入你的服务器（OAuth2 URL Generator；scopes：`bot`、`applications.commands`）

## 备份与迁移

在以下地址下载备份：

- `https://<your-railway-domain>/setup/export`

这会导出你的 gensparx 状态和工作区，方便你迁移到其他主机而不丢失配置或记忆。
