Railway

使用 Railway 的一键模板在数分钟内将 Activepieces 部署到云端

Railway 通过一个可扩展且易于使用的单一平台，简化了从服务器到可观测性的基础设施栈。借助 Railway 的一键部署，你可以在数分钟内启动并运行 Activepieces，无需管理服务器、数据库或基础设施。

在 Railway 上部署

部署内容

Railway 模板将部署 Activepieces 及其以下组件：

  • Activepieces 应用程序：运行来自 Docker Hub 最新版本的主 Activepieces 容器
  • PostgreSQL 数据库：用于存储工作流、执行记录和应用数据的托管 PostgreSQL 数据库
  • Redis 缓存：用于作业排队和缓存的 Redis 实例（可选，可使用内存缓存）
  • 自动 SSL：Railway 提供带 SSL 证书的自动 HTTPS
  • 自定义域名支持：通过 Railway 控制台配置你自己的域名

前置条件

部署前，请确保你拥有：

  • 一个 Railway 账户（提供免费套餐）
  • 对环境变量的基本了解（可选，用于高级配置）

快速开始

  1. 点击上方的部署按钮，打开 Railway 的部署界面
  2. 配置环境变量以进行高级用法（请参阅下面的配置）
  3. 部署 — Railway 将自动预配资源并启动实例

部署完成后，Railway 会提供一个公网 URL，你可以通过该 URL 访问 Activepieces 实例。

配置

环境变量

Railway 允许你通过环境变量配置 Activepieces。你可以在 Railway 控制台的 Variables 标签页下进行设置。

执行模式

配置执行模式以优化安全性和性能： 有关每种模式的详细信息，请参阅沙箱文档。

其他重要变量

  • AP_TELEMETRY_ENABLED：启用/禁用遥测（默认值：false）

有关所有可用环境变量的完整列表，请参阅环境变量文档。

自定义域名设置

Railway 支持带自动 SSL 的自定义域名：

  1. 进入 Railway 项目控制台
  2. 导航至 Settings → Networking
  3. 添加你的自定义域名
  4. 更新 AP_FRONTEND_URL 环境变量以匹配你的自定义域名
  5. Railway 将自动预配 SSL 证书

有关 SSL 配置的更多详细信息，请参阅设置 SSL 指南。

生产环境注意事项

在部署到生产环境之前，请检查以下重要事项：

  • 查看安全实践文档
  • 根据工作负载和硬件资源配置 AP_WORKER_CONCURRENCY
  • 确保在 Railway 中配置了 PostgreSQL 备份
  • 考虑 Railway 中的数据库扩展选项

可观测性

Railway 为 Activepieces 提供了内置的可观测性功能。你可以在 Railway 控制台中查看日志和指标。

升级

要在 Railway 上升级到新版本的 Activepieces：

  1. 进入 Railway 项目控制台
  2. 导航至 Deployments
  3. 点击最新部署上的 Redeploy
  4. Railway 将拉取最新的 Activepieces 镜像并重新部署
在升级之前，请查看[破坏性变更](/docs/activepieces/install/configuration/breaking-changes)文档，以确保与你的工作流和配置兼容。

后续步骤

在 Railway 上部署 Activepieces 后：

  1. 访问你的实例，使用 Railway 提供的 URL
  2. 创建你的第一个工作流 — 请参阅构建工作流
  3. 配置 Webhook — 请参阅设置应用 Webhook
  4. 浏览 Piece — 在 Piece 库中查看可用的集成

更多资源