Як встановити Activepieces за допомогою Docker на ваш сервер

Activepieces — це платформа автоматизації, яка дозволяє підключати програми, отримувати вебхуки та запускати робочі процеси з візуального інтерфейсу. Окрім використання хмарного сервісу, ви можете Встановіть Activepieces на власний сервер та безпосередньо керувати програмою, базою даних та оновленнями.

Рекомендований спосіб самостійного розміщення – це Docker ComposeЦей метод розгортає інтерфейс та API, виконавців, відповідальних за виконання потоків, PostgreSQL та Redis окремо. Також доступна спрощена інсталяція в одному контейнері, хоча вона обмежена особистими проектами та тестуванням.

Самостійне розміщення платформи покращує контроль над інфраструктурою, але це не означає, що всі дані автоматично залишаються на сервері. Коли потік використовує Gmail, Slack, OpenAI або інший зовнішній API, необхідна інформація все одно буде надіслана цьому постачальнику. Ось чому вам також слід Підключіть агентів та автоматизовані системи без розкриття облікових даних.

Яку інсталяцію Activepieces вам слід обрати?

Activepieces пропонує два основні шляхи використання Docker. Вибір залежить від цільового призначення, кількості виконань та можливості масштабування інфраструктури пізніше.

Заклад	Компоненти	Рекомендоване використання
Один контейнер	Програма, PGLite та черга пам'яті	Особисті тести та проекти
Docker Compose	Застосунок, воркер, PostgreSQL та Redis	Стабільний сервер та обладнання
Архітектура виробництва	Програми, воркери, сховище PostgreSQL, Redis та S3	Висока паралельність та масштабовані розгортання

В одному контейнері використовується PGlite як інтегрована база даних і зберігає чергу завдань у пам'яті. Він підтримує лише один екземпляр на машину та не може бути безпосередньо перетворений на інсталяцію Enterprise. Якщо пізніше вам знадобиться перейти на повну архітектуру, вам доведеться підготувати нове розгортання.

Docker Compose більше підходить, коли ви хочете зберегти потоки в PostgreSQL, використовувати Redis для черг та розділити виконання автоматизацій за допомогою воркерів.

Вимоги до встановлення Activepieces за допомогою Docker

Для офіційної інсталяції за допомогою Docker Compose потрібні такі ресурси:

• Докер та Докер Композування версії 2.
• Принаймні 2 віртуальних процесори та 4 ГБ оперативної пам'яті.
• Un Система Linux або сервер, сумісний з Docker.
• WSL2 якщо ви збираєтеся запускати інсталятор з Windows.
• Доступ до терміналу з правами на керування Docker.
• Домен, якщо вам потрібно отримувати вебхуки з Інтернету.
• HTTPS для публічної або виробничої інсталяції.

Перевірте, чи доступний Docker Compose v2:

docker compose version

Правильна команда містить пробіл між docker y composeСтародавній інструмент docker-compose Це відповідає Compose v1 та не працює з поточним розгортанням.

Якщо ви використовуєте Windows, завантажте дистрибутив Linux за допомогою WSL2 та виконайте там команди інсталяції. Docker Desktop має бути налаштований для інтеграції з цим дистрибутивом.

Швидке встановлення для особистих проектів

Якщо ви хочете протестувати Activepieces лише на одній машині та не потребуєте масштабування, ви можете почати спрощену версію з одного контейнера:

docker run -d --name activepieces -p 8080:80 \
  -v ~/.activepieces:/root/.activepieces \
  -e AP_DB_TYPE=PGLITE \
  -e AP_REDIS_TYPE=MEMORY \
  -e AP_FRONTEND_URL="http://localhost:8080" \
  activepieces/activepieces:latest

Ця команда:

• Опублікувати активні матеріали через порт 8080.
• Збережіть конфігурацію та базу даних en ~/.activepieces.
• Використання PGlite як інтегрована база даних.
• Керує чергою виконання в пам'яті процесу.

Після запуску контейнера відкрийте:

http://localhost:8080

Перший зареєстрований користувач стане адміністратором. Немає імені користувача чи пароля за замовчуванням..

Цей підхід не підходить для продакшену, багаторазових реплікацій або інсталяцій, які можуть вимагати функцій корпоративного рівня. Якщо є можливість масштабування проєкту, почніть безпосередньо з Docker Compose.

Як встановити Activepieces однією командою

В офіційній документації рекомендовано використовувати скрипт, який створює конфігурацію, генерує секрети та запускає контейнери. Спочатку перейдіть до папки, де потрібно зберегти файли розгортання, та виконайте команду:

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

Якщо ви бажаєте переглянути вміст перед його запуском, ви можете відобразити його в терміналі:

curl -fsSL https://get.activepieces.com

Інсталятор створює папку під назвою activepiecesПідготуйте файл .env та розгортає необхідні служби.

Якщо порт 8080 вже використовується, вкажіть інший:

curl -fsSL https://get.activepieces.com | sh -s -- --port 8090

Ви також можете вибрати інший каталог:

curl -fsSL https://get.activepieces.com | sh -s -- --dir /ruta/activepieces

Коли закінчите, відкрийте http://localhost:8080 або замінює localhost за IP-адресою сервера.

Як вручну встановити Activepieces за допомогою Docker Compose

Ручна інсталяція дозволяє переглянути файл Compose та змінні перед запуском будь-яких контейнерів. Почніть з клонування репозиторію:

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

Потім запустіть скрипт, який готує файл .env і генерує паролі:

sh tools/deploy.sh

Цей процес потребує opensslЯкщо його не встановлено, скрипт може завершитися без явної помилки та залишити деякі секрети відсутніми. Перевірте їх, перш ніж продовжити:

grep -E '^(AP_ENCRYPTION_KEY|AP_JWT_SECRET|AP_POSTGRES_PASSWORD)=' .env

Усі три змінні повинні містити значення:

• AP_ENCRYPTION_KEY Зашифруйте збережені з'єднання.
• AP_JWT_SECRET підписує токени автентифікації.
• AP_POSTGRES_PASSWORD захищає доступ до PostgreSQL.

За замовчуванням під час встановлення використовується версія Community. Якщо у вас є комерційна ліцензія, і ви хочете активувати її пізніше, вам слід підготувати відповідну версію перед початком розгортання та використовувати сумісний режим запуску.

Під час ручного встановлення служба worker Він повинен мати можливість зв'язуватися з програмою, використовуючи внутрішню назву контейнера. Перевірте, чи його розділ містить:

worker:
  environment:
    - AP_CONTAINER_TYPE=WORKER
    - AP_FRONTEND_URL=http://app

Ця адреса стосується лише працівника. Змінна AP_FRONTEND_URL загальний опис файлу .env Ви повинні зберегти публічну URL-адресу, яка використовуватиметься зовнішніми браузерами та службами.

Нарешті, запустіть контейнери:

docker compose -p activepieces up -d

Які контейнери встановлює Activepieces?

Розгортання за допомогою Docker Compose створює чотири типи сервісів:

Контейнер	Функція
app	Він забезпечує інтерфейс, API та адміністрування платформи.
worker	Він збирає завдання з черги та виконує робочі процеси.
postgres	Він зберігає потоки, з'єднання, користувачів та виконання.
redis	Керування чергою завдань та очікуваними виконаннями.

Дані PostgreSQL не зберігаються безпосередньо в клонованій папці. Вони залишаються в томі Docker. postgres_dataОтже, Копіювання лише папки Activepieces не створює повної резервної копії.

Як перевірити, чи працює Activepieces

Перевірте стан контейнерів:

docker compose -p activepieces ps

Усі служби мають бути запущені. Потім перевірте кінцеву точку справності:

curl http://localhost:8080/api/v1/health

Увійти та відкрити Адміністратор платформи > Інфраструктура > ПрацівникиПринаймні один працівник має бути доступний. Якщо список порожній, працівник, ймовірно, не може зв’язатися із застосунком.

Ви також можете переглядати записи в режимі реального часу:

docker compose -p activepieces logs -f app
docker compose -p activepieces logs -f worker

Як налаштувати домен та вебхуки

Використання Activepieces AP_FRONTEND_URL для генерації адрес вебхуків, переадресацій OAuth та публічних посилань. Якщо він містить localhostТакі сервіси, як Stripe, GitHub або Slack, не зможуть надсилати дані з Інтернету.

Редагувати файл .env та вводить суспільне надбання:

AP_FRONTEND_URL=https://automatizaciones.tudominio.com

Потім повторно створіть служби, щоб впровадити зміни:

docker compose -p activepieces up -d

Для виконання тестів з комп'ютера без публічної адреси можна використовувати тимчасовий тунель:

ngrok http 8080

Введіть HTTPS-адресу, надану тунелем, у AP_FRONTEND_URL і перезапускає контейнери. Ngrok корисний для тестування, але його адреса може змінюватися і Це не слід вважати постійною виробничою конфігурацією..

Тунель Cloudflare також можна використовувати для публікації екземпляра без безпосереднього відкриття порту 8080. Однак вам потрібно буде правильно налаштувати підтримку домену, HTTPS та WebSockets.

Як захистити ActivePieces за допомогою HTTPS

Публічний екземпляр повинен використовувати HTTPS. Ви можете завершити шифрування за допомогою зворотного проксі-сервера, такого як Nginx, балансувальника навантаження або проксі-сервісу, що надається вашим інтернет-провайдером.

Базова конфігурація Nginx повинна пересилати запити на порт 8080 та дозволяти підключення WebSocket:

location / {
    proxy_pass http://localhost:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

Сертифікат можна отримати через Let's Encrypt, Certbot, Cloudflare або вашого постачальника інфраструктури. Після ввімкнення HTTPS перевірте, що AP_FRONTEND_URL починається з https://.

Не публікуйте PostgreSQL або Redis безпосередньо в інтернеті. Також обмежте доступ через SSH, оновлюйте Docker та використовуйте різні паролі для сервера та підключених програм.

Як зробити резервну копію

Перед оновленням Activepieces експортуйте базу даних:

docker compose -p activepieces exec postgres \
  pg_dump -U postgres activepieces > backup.sql

Також збережіть безпечну копію файлу .envБез того ж самого AP_ENCRYPTION_KEYActivepieces не зможе розшифрувати збережені з'єднання, навіть якщо ви успішно відновите PostgreSQL.

У персональній інсталяції за допомогою PGLite необхідно створити резервну копію такої папки:

~/.activepieces

Не зберігайте резервні копії лише на одному сервері. Використовуйте інший комп’ютер, зашифроване сховище або систему резервного копіювання з керуванням версіями.

Як оновити Activepieces

Спочатку перевірте наявність несумісних змін, опублікованих для нової версії. Після створення резервної копії виконайте:

curl -fsSL https://get.activepieces.com | sh -s -- --upgrade

Інсталятор зберігає файл .env, дані та зміни, внесені до docker-compose.ymlВикористана версія фіксується AP_VERSIONЦе запобігає випадковим оновленням щоразу під час перезапуску контейнерів.

У особистому контейнері ви повинні зупинити його, створити резервну копію ~/.activepieces, видаліть старий контейнер, завантажте новий образ і створіть його знову, використовуючи той самий том.

Типові помилки під час встановлення Activepieces

Команда docker compose не існує

Перевірте версію:

docker compose version

Якщо команда не спрацює, встановіть Docker Compose v2. Не замінюйте команду автоматично на docker-compose, оскільки поточне розгортання не підтримує Compose версії 1.

Порт 8080 вже зайнятий

Встановити на інший порт:

curl -fsSL https://get.activepieces.com | sh -s -- --port 8090

У існуючій установці це змінюється AP_HOST_PORT в межах .env та відтворює контейнери. Не змінюйте AP_PORTоскільки він відповідає внутрішньому порту та може порушити відображення.

Сторінка "Працівники" виглядає порожньою

Перевірте записи:

docker compose -p activepieces logs worker | grep -i socket

Повторювані помилки Socket.IO зазвичай вказують на те, що воркер намагається підключитися до localhost або у публічний домен з Docker. Налаштуйте наступне для цього сервісу:

AP_FRONTEND_URL=http://app

Вебхуки відображають локальний хост

Введіть публічний домен у змінну AP_FRONTEND_URL з файлу .env та перезапустіть служби. Адреса має бути доступною із зовнішньої програми, яка надсилатиме вебхук.

Тестові кнопки або оновлення в режимі реального часу не працюють

Зворотний проксі-сервер, ймовірно, неправильно пересилає з’єднання WebSocket. Перевірте заголовки. Upgrade y Connection та увімкніть HTTPS, оскільки деякі браузери блокують незашифровані WebSockets.

Ключі у файлі .env порожні.

Встановити openssl і запустіть його знову:

sh tools/deploy.sh

Не починайте встановлення, доки не переконаєтеся, що AP_ENCRYPTION_KEY, AP_JWT_SECRET y AP_POSTGRES_PASSWORD Вони містять цінності.

Додаток постійно перезавантажується

Перевірте помилку запуску:

docker compose -p activepieces logs app | grep -i "failed to start"

Одна з можливих причин — використання AP_EDITION=ee разом з AP_EXECUTION_MODE=UNSANDBOXEDКорпоративна версія відхиляє цю комбінацію; вона використовує сумісний режим пісочниці як SANDBOX_CODE_ONLY.

Потоки зникають після повторного створення контейнерів.

Перевірте, чи гучність postgres_data Він все ще існує, і ви не виконали очищення. Видалення контейнерів не повинно призвести до видалення тома, але команди, що видаляють томи, можуть безповоротно знищити базу даних.

Коли автоматизація зупиняється, вона спочатку перевіряє журнали програми та працівників. Ця ж методологія корисна для визначення Що робити, коли автоматизація виходить з ладу та відокремити проблему від потоку інфраструктурного збою.

Коли вам потрібна архітектура виробничого процесу?

Docker Compose достатньо для початку роботи з власним сервером, але організації з багатьма одночасними запуском потрібно буде розділити та масштабувати компоненти.

Рекомендована архітектура виробництва використовує Незалежні працівники, кілька реплік програм, сховище, сумісне з PostgreSQL, Redis та S3Пропускну здатність слід розраховувати на основі максимальної кількості одночасних потоків, а не лише щоденної кількості виконань.

Також слід налаштувати моніторинг, збереження журналів, перевірені резервні копії та ізоляцію виконання. Самостійне розміщення забезпечує контроль, але також перекладає відповідальність за доступність, оновлення та безпеку на адміністратора.

Встановлення ActivePieces за допомогою Docker Compose дозволяє вам мати платформу автоматизації, якою можна керувати з вашої власної інфраструктури. Найважливіше не налаштування контейнерів, а вибір правильного між PGLite та PostgreSQL, захист секретів, налаштування стабільної публічної URL-адреси та створення резервних копій бази даних і ключа шифрування.

Завдяки цим запобіжним заходам ви можете запускати потоки, отримувати вебхуки та підключати програми, не покладаючись на розміщену інфраструктуру Activepieces, водночас маючи можливість масштабувати систему зі збільшенням робочого навантаження.