Activepieces：开源自动化工作流平台（n8n替代）安装与使用指南

官方信息

项目背景

Zapier 和 n8n 是最有名的两个工作流自动化工具：前者闭源收费，后者虽然开源但采用"fair-code"许可证，商用有限制，而且节点式画布对非技术用户不够友好。Activepieces 走的是第三条路——真正的 MIT 协议开源、垂直步骤式编辑器、原生内置 AI 能力，被很多人视为"更现代的 n8n"。

项目用 TypeScript 编写，在 GitHub 上收获 17k+ Star，集成了 450+ 个应用（Slack、Gmail、Notion、GitHub、OpenAI、Telegram 等），支持 Webhook、定时触发、代码步骤、条件分支、循环、人工审批、AI Agent 节点。架构上把 Web UI、执行 Worker、PostgreSQL、Redis 拆成四个容器，高并发下 UI 依然流畅。

它特别适合：想替代 Zapier 月费、需要把 SaaS 串起来做自动化、或者想在工作流里原生调 LLM 做总结/分类/抽取的团队。自托管完全免费、不限流程数和执行次数。

核心特性

• 450+ 集成应用：覆盖营销、CRM、AI、财务、开发者工具，还能通过 Webhook 接任意 API。
• 垂直步骤式编辑器：比 n8n 的节点画布更易上手，非技术用户也能搭。
• 原生 AI 节点：内置 OpenAI、Claude 调用，无需自己配 API。
• AI Copilot 助手：用自然语言描述想要的自动化，自动生成流程。
• 代码步骤：支持 TypeScript/JavaScript 自定义逻辑，可写复杂转换。
• 分支、循环、人工审批：复杂业务逻辑都能可视化搭建。
• 内联调试：每一步都能单独跑、看输入输出，不用整个流程重跑。
• MIT 协议：真正可商用，没有 fair-code 限制。

环境要求

• Docker 与 Docker Compose v2（旧版 docker-compose 不支持）。
• 至少 2 vCPU、4 GB 内存。
• Linux（Ubuntu/Debian/CentOS）；Windows 需 WSL2。
• 开放端口 8080。

详细部署步骤

方式一：一键脚本（最推荐）

cd /opt
curl -fsSL https://get.activepieces.com | sh

这个脚本会自动写好 docker-compose.yml、生成随机密钥、启动四个容器。如果 8080 被占用：

curl -fsSL https://get.activepieces.com | sh -s -- --port 9000 --dir /opt/activepieces

方式二：手动 Docker Compose（生产推荐）

git clone --depth 1 https://github.com/activepieces/activepieces.git
cd activepieces

# 生成密钥
sh tools/deploy.sh

# 检查三个关键密钥是否都生成了
grep -E '^(AP_ENCRYPTION_KEY|AP_JWT_SECRET|AP_POSTGRES_PASSWORD)=' .env

如果输出里任何一个值为空，说明 openssl 没装，先 sudo apt install openssl 再跑一次 sh tools/deploy.sh。

在 .env 末尾追加（企业版必须）：

AP_EDITION=ee
AP_EXECUTION_MODE=SANDBOX_CODE_ONLY

启动：

docker compose -p activepieces up -d

验证部署

docker compose -p activepieces ps
# 应该看到 app、worker、postgres、redis 四个容器都 Up

curl http://localhost:8080/api/v1/health
# 返回 JSON 即正常

关键说明

• 没有默认账号密码：首次访问 http://服务器IP:8080，第一个注册的账号自动成为平台管理员。
• 三个密钥务必备份：AP_ENCRYPTION_KEY 丢了，所有已保存的第三方连接都解不开；AP_JWT_SECRET 换了所有人被登出。
• 数据在 Docker volume 里：不在 activepieces 文件夹下，备份用 docker compose exec postgres pg_dump -U postgres activepieces > backup.sql。
• 反向代理后必须改公网地址：把 AP_FRONTEND_URL 和 AP_API_URL 改成 https 域名，否则 OAuth 和 Webhook 会坏。

使用方法示例

登录后点"+ Create" → Flow，举个经典例子：

1. 触发：Webhook（别人 POST 过来就触发）。
2. 代码步骤：用 TypeScript 处理数据格式。
3. 分支：如果订单金额 > 1000 才继续。
4. AI 步骤：调用 GPT 总结订单内容。
5. 动作：Slack 发消息到 #orders 频道。

也可以点右上角 "Build with AI"，直接说"每当 Shopify 有新订单，金额超过 1000 美元就发 Slack 通知"，Copilot 会自动搭好。

常见问题（FAQ）

Q1：和 n8n 比哪个好？
A：Activepieces 编辑器更现代、原生带 AI、MIT 协议；n8n 生态集成更多、资料更全。个人/小团队推荐 Activepieces，复杂企业场景两者都能选。

Q2：worker 列表是空的？
A：进 Platform Admin → Operations → Workers 看；如果空，说明 worker 容器没连上 app，检查 compose 里 worker 的 AP_FRONTEND_URL=http://app 是否配置。

Q3：怎么升级？
A：docker compose pull && docker compose up -d，升级前先 pg_dump 备份数据库。

Q4：代码步骤安全吗？
A：自托管单机模式下 AP_EXECUTION_MODE=UNSANDBOXED 方便但有风险；多人/公网环境务必用 SANDBOX_CODE_ONLY。

跳转链接

• GitHub 仓库：https://github.com/activepieces/activepieces
• 官方文档：安装文档
• 云服务版：https://cloud.activepieces.com/
• 集成市场：Pieces