
Activepieces 如何用一条命令完成 Docker Compose 自托管安装并验证服务健康【免费下载链接】activepiecesAI Agents MCPs AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows AI Agents • MCPs for AI Agents项目地址: https://gitcode.com/GitHub_Trending/ac/activepiecesActivepieces 的官方自托管方式是 Docker Compose一条命令即可完成配置写入、密钥生成和容器启动装完后需要确认四个容器全部Up、健康检查接口有响应并且 Worker 列表里能看到至少一个 worker。本文按这条路径走先确认环境再执行安装命令最后做健康验证。前提条件执行安装前文档列出的要求是Docker Compose v2旧的docker-compose命令不能用于这套配置。可以先用docker compose version确认报错就说明是 v1需要先升级。至少2 vCPU 和 4 GB 内存。Windows 上需要使用WSL2命令在 WSL2 内部执行。在你想让 Activepieces 存放的目录下执行安装命令脚本默认安装到./activepieces。一条命令安装curl -fsSL https://get.activepieces.com | sh这条命令一行完成三件事写入配置、生成密钥密码、AP_ENCRYPTION_KEY、AP_JWT_SECRET等、启动全部容器。两个常用参数如果 8080 端口已被占用curl -fsSL https://get.activepieces.com | sh -s -- --port 8090如果不想装在当前目录下的./activepieces用--dir path指定其他位置。想先审查脚本再执行curl -fsSL https://get.activepieces.com会直接打印脚本内容而不执行。验证安装是否健康安装结束后在 Activepieces 所在目录执行docker compose -p activepieces ps curl http://localhost:8080/api/v1/health文档给出的成功条件是四个容器都处于Up状态健康检查接口有响应。四个容器及各自的角色容器角色appAPI 和 UI对外服务端口 8080worker执行你的流程postgres存储流程、运行记录和连接redis任务队列之后再登录界面确认 Worker打开http://localhost:8080远程服务器则用http://服务器IP:端口创建第一个账号——第一个账号会成为平台管理员系统没有默认用户名或密码。登录后进入Platform Admin → Infrastructure → Workers应该能看到至少一个 worker列表为空则按下面Workers 页面为空一节排查。两点必须记住密钥写在activepieces/.env里备份这个文件。没有AP_ENCRYPTION_KEY已存储的连接无法解密即使有完整的数据库备份也不行。数据不在activepieces文件夹里而在postgres_dataDocker volume 中所以备份文件夹不等于备份了流程数据。可选不用安装脚本手动跑 Docker Compose如果你不希望把远程脚本直接管道进 shell或变更流程要求先审查 compose 文件再启动可以手动完成同样的四个容器git clone --depth 1 https://github.com/activepieces/activepieces.git cd activepieces sh tools/deploy.shtools/deploy.sh会把.env.example复制为.env并用openssl随机生成密码和密钥依赖openssl。脚本即使缺少openssl也会报告成功但留下空值所以生成后必须检查grep -E ^(AP_ENCRYPTION_KEY|AP_JWT_SECRET|AP_POSTGRES_PASSWORD) .env三项都必须有值有任意为空安装openssl后重跑sh tools/deploy.sh。如果要用企业版ee向.env添加AP_EDITIONee AP_EXECUTION_MODESANDBOX_CODE_ONLY因为.env.example自带AP_EXECUTION_MODEUNSANDBOXED而ee版会在启动时拒绝它。手动路径还要在docker-compose.yml中给worker服务单独设置AP_FRONTEND_URLworker: environment: - AP_CONTAINER_TYPEWORKER - AP_FRONTEND_URLhttp://appworker和app共享同一个.env其中的AP_FRONTEND_URL是你的公网地址——对浏览器来说它指向 app对 worker 容器来说却指向它自己。没有这个覆盖worker 打不开自己的 socketWorkers 页面会一直为空。最后启动docker compose -p activepieces up -d仓库中的 docker-compose.yml 镜像标签固定到具体发布版本如ghcr.io/activepieces/activepieces:0.90.4升级时需要自己改worker默认replicas: 5对单台小机器偏多上生产前建议参考 生产环境配置 调整。常见问题排查安装命令失败docker compose version报错说明是 Compose v1需要安装 Docker Compose v2 后才能继续。Workers 页面为空说明 worker 连不上 app查看日志docker compose -p activepieces logs worker | grep -i socket反复出现Socket.IO connection error表示 worker 的AP_FRONTEND_URL指向了容器内部无法解析的地址localhost在容器里指 worker 自己。它必须是 Docker 网络上 app 的服务名http://appapp 自身的AP_FRONTEND_URL仍保持公网 URL 不变。更多 websocket 问题见 Websocket Issues。8080 端口已被占用安装时换端口如上面示例的--port 8090已有安装则修改.env中的AP_HOST_PORT后执行docker compose -p activepieces up -d。注意不要设置AP_PORT那是容器内 app 的监听端口改动会破坏端口映射。app 容器反复重启读取启动错误docker compose -p activepieces logs app | grep -i failed to start常见原因是AP_EDITIONee下仍使用AP_EXECUTION_MODEUNSANDBOXED启动时会被拒绝应改为SANDBOX_CODE_ONLY详见 Sandboxing Mode。读日志docker compose -p activepieces logs -f app docker compose -p activepieces logs -f worker下一步安装默认运行在免费版如有试用或付费 license key参考 License key 激活以解锁付费功能。升级前先备份数据库docker compose -p activepieces exec postgres pg_dump -U postgres activepieces backup.sql再执行curl -fsSL https://get.activepieces.com | sh -s -- --upgrade。升级会保留你的.env、数据和docker-compose.yml的手改内容版本固定在.env的AP_VERSION中。升级前建议阅读 破坏性变更说明。需要外部可达的 webhook 地址如本机测试用隧道或生产环境参数见 Docker 自托管文档 中 Make webhooks reachable 与 Going to production 两节。【免费下载链接】activepiecesAI Agents MCPs AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows AI Agents • MCPs for AI Agents项目地址: https://gitcode.com/GitHub_Trending/ac/activepieces创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考