Перейти к содержимому

ДОКУМЕНТАЦИЯ

Развёртывание OpenConnector с Docker

Запустите локальный runtime, выполните первый Action, подключите аккаунты и подготовьте постоянное хранилище и аутентификацию.

Поддерживает OOMOL·

Исходный код проверен 2026-09-09. Примеры сверены с указанной ревизией исходного кода. Это не подтверждение проверки реального API сервиса; ваша версия может отличаться.

Запустите среду выполнения

Вам нужны Git и Docker с Docker Compose. Начните с Action без аутентификации, прежде чем настраивать аккаунт приложения. Клонируйте репозиторий и запустите опубликованный образ. Этот пробный запуск предназначен для локальной работы на вашей машине.

Docker
git clone https://github.com/oomol-lab/open-connector.git
cd open-connector
docker compose up

Вызовите первый Action

В другом терминале получите популярные статьи Hacker News. Этот Action только для чтения не требует аккаунта провайдера.

HTTP · Hacker News
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Вызовите этот Action только для чтения без аутентификации провайдера в локальной среде. Если включена аутентификация среды выполнения, добавьте Bearer-токен.

Подключите аккаунт

Откройте локальную консоль, выберите провайдера и настройте учётные данные. Для OAuth-провайдеров нужно зарегистрировать собственное OAuth-приложение в соответствующем сервисе.

Учётные данные и OAuth →

Сохраняйте и защищайте учётные данные

Образ Docker использует /app/data для локальных данных runtime. Подключите постоянный том. Настройте OOMOL_CONNECT_ENCRYPTION_KEY для шифрования учётных данных и сохраните ключ для восстановления. Перед публикацией runtime изучите руководство по развёртыванию.

Перед публикацией среды настройте аутентификацию администратора, токены среды выполнения, шифрование учётных данных и публичный OAuth origin. Для рабочего окружения следуйте руководству по развёртыванию.

Полное руководство по развёртыванию ↗

Перед открытием внешнего доступа

Compose-файл проекта монтирует connector-data в /app/data. Перед удалённым доступом задайте отдельные OOMOL_CONNECT_ADMIN_TOKEN и OOMOL_CONNECT_RUNTIME_TOKEN, а также OOMOL_CONNECT_ENCRYPTION_KEY. Укажите публичный origin и настройте HTTPS на входе в развёртывание. Не храните секреты в системе контроля версий.

Обновление и восстановление

Запишите версию образа, создайте резервную копию базы runtime и безопасно сохраните копию ключа шифрования. Перед обновлением проверьте восстановление в изолированной среде. При потере ключа зашифрованные записи не восстановить; удаление тома данных удалит локальную базу.

Как читать результат

Ответы HTTP runtime содержат success, message, data и meta. Проверяйте success и выходную схему Action, а не только HTTP-статус. Если метаданные содержат executionId, по нему можно найти журнал с замаскированными секретами. Ниже показан формат ответа, а не результат реального вызова API.

Пример формата ответа
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Если вызов не удался

  • При ошибке аутентификации проверьте адрес и тип учётных данных: административный доступ защищает /api, Bearer-токен runtime используется для /v1 и /mcp. API-ключ провайдера не заменяет токен runtime.
  • При отказе в доступе проверьте scopes Action, правила Actions и разрешения на подключения. Даже действительный токен может не иметь доступа к выбранному аккаунту.
  • Если результат пуст или ресурс отсутствует, проверьте аккаунт и его права на этот ресурс. Успешная авторизация не открывает все рабочие пространства, каналы и документы.
  • Изучите ошибку и журнал до повтора. Если Action изменяет данные провайдера, сначала проверьте, не завершилась ли операция; не повторяйте запрос вслепую.
Читать в Markdown