---
title: 在 Northflank 上部署
x-i18n:
  generated_at: "2026-02-01T21:19:03Z"
  model: claude-opus-4-5
  provider: pi
  source_hash: ad0be8dda41c51d0b6424259316db1b22be5216434f5879f21a5e8c60e0a2ee0
  source_path: northflank.mdx
  workflow: 15
---

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

## 如何开始

1. 点击 [Deploy Gensparx](https://northflank.com/stacks/deploy-gensparx) 打开模板。
2. 如果你还没有账户，请创建一个 [Northflank 账户](https://app.northflank.com/signup)。
3. 点击 **Deploy gensparx now**。
4. 设置必需的环境变量：`SETUP_PASSWORD`。
5. 点击 **Deploy stack** 构建并运行 gensparx 模板。
6. 等待部署完成，然后点击 **View resources**。
7. 打开 gensparx 服务。
8. 打开公开的 gensparx URL，在 `/setup` 完成设置。
9. 在 `/gensparx` 打开控制面板 UI。

## 你将获得

- 托管的 gensparx Gateway网关 + 控制面板 UI
- `/setup` 处的网页设置向导（无需终端命令）
- 通过 Northflank Volume（`/data`）实现持久化存储，配置/凭据/工作区在重新部署后不会丢失

## 设置流程

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

如果 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；权限范围：`bot`、`applications.commands`）
