Docker Compose

要快速启动 Activepieces，我们将使用 Activepieces Docker 镜像。请按以下步骤操作：

前提条件

需要在你的机器上安装 Git 和 Docker。

安装

1. 克隆 Activepieces 仓库。

使用命令行克隆 Activepieces 仓库：

git clone https://github.com/activepieces/activepieces.git

2. 进入仓库目录。

cd activepieces

3. 生成环境变量

在命令行/终端中运行以下命令：

sh tools/deploy.sh
如果以上方法均无效，可将根目录下的 .env.example 文件重命名为 .env，然后在文件中填写必要信息。

4. 运行 Activepieces。

请注意，"docker-compose"（带短横线）是已过时的 Docker Compose 版本，无法正常使用。我们强烈建议从[此处](https://docs.docker.com/compose/install/)下载并安装第 2 版 Docker Compose。 
docker compose -p activepieces up

配置 Webhook URL（触发器必配，如有公网 IP 可跳过）

注意： 默认情况下，Activepieces 会尝试使用你的公网 IP 作为 webhook。如果你在个人机器上自托管，必须配置前端 URL 以确保 webhook 可从互联网访问。

可选： 在 localhost 上暴露 webhook URL 最简单的方法是使用 ngrok 之类的服务，但它不适用于生产环境。

  1. 安装 ngrok
  2. 运行以下命令：
ngrok http 8080
  1. 将 .env 中的 AP_FRONTEND_URL 环境变量替换为 ngrok URL。
Ngrok 在生产环境中部署时，请确保更新数据库凭据并正确设置环境变量。

请查阅配置指南进行必要的调整。

升级

要升级到使用 Docker Compose 安装的新版本，请在 Activepieces 仓库目录中打开终端并执行以下步骤。

自动拉取

1. 运行更新脚本

sh tools/update.sh

手动拉取

1. 拉取新的 Docker Compose 文件

git pull

2. 拉取新镜像

docker compose pull

3. 查看变更日志中的破坏性变更

请查看[变更日志](../configuration/breaking-changes)中的破坏性变更。

4. 运行更新后的 Docker 镜像

docker compose up -d --remove-orphans

恭喜！你已经成功更新了版本。

删除

以下命令会删除所有 Docker 容器及相关数据，请谨慎使用：

sh tools/reset.sh
执行此命令将删除所有 Docker 容器及其存储的数据。请务必了解此命令的潜在风险后再操作。