Skip to content

The open alternative to Salesforce, designed for AI.

41.1 KB
Raw Blame
---
title: Настройка
description: Настройка Twenty из панели администратора или с переменными среды.
---

import { PageBanner } from "/snippets/page-banner.mdx"

## Обзор

<Warning>
**Устанавливаете впервые?** Следуйте [руководству по установке Docker Compose](/ru/developers/self-host/capabilities/docker-compose), чтобы запустить Twenty, затем вернитесь сюда для настройки.
</Warning>

Twenty предлагает **два режима конфигурации**, чтобы соответствовать разным потребностям развертывания:

**Доступ к панели администратора:** Только пользователи с правами администратора (`canAccessFullAdminPanel: true`) могут получить доступ к интерфейсу конфигурации.

## 1. Конфигурация панели администратора (по умолчанию)

```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # default
```

**Большая часть конфигурации происходит через UI** после установки:

1. Получите доступ к вашему экземпляру Twenty (обычно `http://localhost:3000`)
2. Перейдите в **Настройки / Панель администратора / Переменные конфигурации**
3. Настройте интеграции, почту, хранилище и многое другое
4. Изменения вступают в силу немедленно (в течение 15 секунд для многоконтейнерных развертываний)

<Warning>
**Многоконтейнерное развертывание:** при использовании конфигурации базы данных (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`) серверные и рабочие контейнеры читают из одной базы данных. Изменения в панели администратора влияют на оба контейнера автоматически, исключая необходимость дублирования переменных среды между контейнерами (за исключением инфраструктурных переменных).
</Warning>

**Что вы можете настроить через панель администратора:**

* **Аутентификация** - Google/Microsoft OAuth, настройки паролей
* **Электронная почта** - настройки SMTP, шаблоны, верификация
* **Хранилище** - конфигурация S3, пути локального хранения
* **Интеграции** - Gmail, Google Calendar, сервисы Microsoft
* **Рабочий процесс и Ограничения скорости** - лимиты выполнения, ограничение API
* **И многое другое...**

![Переменные конфигурации панели администратора](/images/user-guide/setup/admin-panel-config-variables.png)

<Warning>
Каждая переменная документирована с описаниями в вашей панели администратора в **Настройки → Панель администратора → Переменные конфигурации**.
Некоторые инфраструктурные настройки, такие как соединения с базой данных (`PG_DATABASE_URL`), URL сервера (`SERVER_URL`) и секреты (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`), могут быть настроены только через файл `.env`.

[Полная техническая ссылка →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>

## Ключи шифрования

Twenty использует два ключа шифрования, задаваемых только через переменные окружения:

| Переменная                | Назначение                                                                                                                                                                                        | Обязательно                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `ENCRYPTION_KEY`          | Основной ключ, используемый для шифрования секретов в состоянии покоя (OAuth-токены, переменные приложения, закрытые ключи для подписания, TOTP-секреты, конфиденциальные значения конфигурации). | Да, для новых установок (устаревшие установки могут вместо этого полагаться на `APP_SECRET` — см. ниже) |
| `FALLBACK_ENCRYPTION_KEY` | Ключ, используемый только для проверки. Во время ротации установите значение равным *предыдущему* `ENCRYPTION_KEY`, чтобы существующие строки оставались доступными для расшифровки.              | Только во время ротации                                                                                 |

Для обеспечения обратной совместимости, если `ENCRYPTION_KEY` не задан, Twenty использует `APP_SECRET` для шифрования данных в состоянии покоя — что соответствует устаревшему поведению для более старых развертываний. Для новых установок всегда следует задавать отдельный `ENCRYPTION_KEY`.

Генерируйте значения с помощью `openssl rand -base64 32` и храните их в безопасном месте (менеджер секретов, защищённая конфигурация и т. п.). Потеря `ENCRYPTION_KEY` означает потерю доступа ко всем секретам, хранящимся в базе данных.

Чтобы выполнить ротацию `ENCRYPTION_KEY` без простоя, см. [руководство по ротации ключей](/ru/developers/self-host/capabilities/key-rotation).

## 2. Конфигурация только для среды

```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=false
```

**Вся конфигурация управляется через файлы `.env`:**

1. Установите `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` в своем `.env` файле
2. Добавьте все переменные конфигурации в ваш файл `.env`
3. Перезапустите контейнеры, чтобы изменения вступили в силу
4. Панель администратора будет показывать текущие значения, но не сможет их изменить

## Режим нескольких рабочих пространств

По умолчанию Twenty работает в **режиме одного рабочего пространства** — оптимально для большинства развертываний с самостоятельным размещением, где вашей организации нужен один экземпляр CRM.

### Режим одного рабочего пространства (по умолчанию)

```bash
IS_MULTIWORKSPACE_ENABLED=false  # default
```

* Одно рабочее пространство на один экземпляр Twenty
* Первый пользователь автоматически становится администратором с полными привилегиями (`canImpersonate` и `canAccessFullAdminPanel`)
* Новые регистрации отключаются после создания первого рабочего пространства
* Простая структура URL: `https://your-domain.com`

### Включение режима нескольких рабочих пространств

```bash
IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value
```

Включите режим нескольких рабочих пространств для развертываний, похожих на SaaS, где нескольким независимым командам нужны собственные рабочие пространства на одном экземпляре Twenty.

**Ключевые отличия от режима одного рабочего пространства:**

* На одном экземпляре можно создать несколько рабочих пространств
* Каждое рабочее пространство получает собственный поддомен (например, `sales.your-domain.com`, `marketing.your-domain.com`)
* Пользователи регистрируются и входят на `{DEFAULT_SUBDOMAIN}.your-domain.com` (например, `app.your-domain.com`)
* Нет автоматических привилегий администратора — первый пользователь в каждом рабочем пространстве является обычным пользователем
* Параметры, специфичные для рабочего пространства, такие как поддомен и пользовательский домен, становятся доступны в настройках рабочего пространства

<Warning>
**Параметр только среды:** `IS_MULTIWORKSPACE_ENABLED` можно настроить только через файл `.env`; требуется перезапуск. Его нельзя изменить через панель администратора.
</Warning>

### Настройка DNS для режима нескольких рабочих пространств

При использовании режима нескольких рабочих пространств настройте DNS с помощью подстановочной записи, чтобы разрешить динамическое создание поддоменов:

```
*.your-domain.com -> your-server-ip
```

Это включает автоматическую маршрутизацию поддоменов для новых рабочих пространств без ручной настройки DNS.

### Ограничение создания рабочих пространств

В режиме нескольких рабочих пространств вы можете ограничить круг пользователей, которые могут создавать новые рабочие пространства:

```bash
IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
```

Если включено, только пользователи с правом `canAccessFullAdminPanel` могут создавать дополнительные рабочие пространства. Пользователи все равно могут создать свое первое рабочее пространство во время первоначальной регистрации.

## Интеграция Gmail и Google Calendar

### Создайте проект в Google Cloud

1. Перейдите в [Google Cloud Console](https://console.cloud.google.com/)
2. Создайте новый проект или выберите существующий
3. Включите следующие API:

* [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com)
* [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
* [People API](https://console.cloud.google.com/apis/library/people.googleapis.com)

### Настройте OAuth

1. Перейдите к [Учётные данные](https://console.cloud.google.com/apis/credentials)
2. Создайте OAuth 2.0 Client ID
3. Добавьте эти URI перенаправления:
   * `https://{your-domain}/auth/google/redirect` (для SSO)
   * `https://{your-domain}/auth/google-apis/get-access-token` (для интеграций)

### Настройка в Twenty

1. Перейдите в **Настройки → Панель администратора → Переменные конфигурации**
2. Найдите раздел **Google Auth**
3. Установите эти переменные:
   * `MESSAGING_PROVIDER_GMAIL_ENABLED=true`
   * `CALENDAR_PROVIDER_GOOGLE_ENABLED=true`
   * `AUTH_GOOGLE_CLIENT_ID={client-id}`
   * `AUTH_GOOGLE_CLIENT_SECRET={client-secret}`
   * `AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect`
   * `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`

<Warning>
**Режим только для среды:** если вы установили `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, добавьте эти переменные в свой `.env` файл вместо этого.
</Warning>

**Необходимые границы** (автоматически настроены):
[Посмотреть соответствующий исходный код](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10)

* `https://www.googleapis.com/auth/calendar.events`
* `https://www.googleapis.com/auth/gmail.readonly`
* `https://www.googleapis.com/auth/profile.emails.read`

### Если ваше приложение находится в тестовом режиме

Если ваше приложение находится в тестовом режиме, вам потребуется добавить тестовых пользователей в ваш проект.

На [экране согласия OAuth](https://console.cloud.google.com/apis/credentials/consent) добавьте тестовых пользователей в раздел "Тестовые пользователи".

## Интеграция Microsoft 365

<Warning>
Пользователи должны иметь [лицензию Microsoft 365](https://admin.microsoft.com/Adminportal/Home), чтобы иметь возможность использовать API Календаря и Сообщений. Они не смогут синхронизировать свою учетную запись в Twenty без нее.
</Warning>

### Создайте проект в Microsoft Azure

Вам потребуется создать проект в [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) и получить учетные данные.

### Включите API

На консоли Microsoft Azure включите следующие API в "Разрешениях":

* Microsoft Graph: Mail.ReadWrite
* Microsoft Graph: Mail.Send
* Microsoft Graph: Calendars.ReadWrite
* Microsoft Graph: User.Read
* Microsoft Graph: openid
* Microsoft Graph: email
* Microsoft Graph: profile
* Microsoft Graph: offline_access

<Note>
Все эти разрешения обязательны, даже если вы хотите синхронизировать только электронные письма и события календаря. Twenty всегда запрашивает "Mail.ReadWrite", "Mail.Send" и "Calendars.ReadWrite", когда пользователь подключает свою учетную запись, поэтому разрешений только для чтения, таких как "Mail.Read" или "Calendars.Read", недостаточно.
</Note>

<Note>
Если ваш клиент не позволяет обычным пользователям давать согласие на эти разрешения, при подключении учетной записи они увидят ошибку AADSTS90094. Администратор может исправить это, нажав "Grant admin consent for {your-tenant}" на странице "API permissions" регистрации приложения.
</Note>

### Авторизованные URI перенаправления

Вам нужно добавить следующие URI перенаправления в ваш проект:

* `https://{your-domain}/auth/microsoft/redirect` если вы хотите использовать Microsoft SSO
* `https://{your-domain}/auth/microsoft-apis/get-access-token`

### Настройка в Twenty

1. Перейдите в **Настройки → Панель администратора → Переменные конфигурации**
2. Найдите раздел **Microsoft Auth**
3. Установите эти переменные:
   * `MESSAGING_PROVIDER_MICROSOFT_ENABLED=true`
   * `CALENDAR_PROVIDER_MICROSOFT_ENABLED=true`
   * `AUTH_MICROSOFT_ENABLED=true`
   * `AUTH_MICROSOFT_CLIENT_ID={client-id}`
   * `AUTH_MICROSOFT_CLIENT_SECRET={client-secret}`
   * `AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect`
   * `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`

<Warning>
**Режим только для среды:** если вы установили `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, добавьте эти переменные в свой `.env` файл вместо этого.
</Warning>

### Настройка областей доступа

соответствующий исходный код](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L11)

* 'openid'
* 'электронная почта'
* 'профиль'
* 'offline_access'
* 'Mail.ReadWrite'
* 'Mail.Send'
* 'Calendars.ReadWrite'
* 'User.Read'

### Если ваше приложение находится в тестовом режиме

Если ваше приложение находится в тестовом режиме, вам потребуется добавить тестовых пользователей в ваш проект.

Добавьте тестовых пользователей в раздел "Пользователи и группы".

## Фоновые задания для Календаря и Сообщений

После настройки интеграций Gmail, Google Calendar или Microsoft 365, вам необходимо запустить фоновые задания, синхронизирующие данные.

Зарегистрируйте следующие повторяющиеся задания в вашем контейнере рабочего:

```bash
# from your worker container
yarn command:prod cron:messaging:messages-import
yarn command:prod cron:messaging:message-list-fetch
yarn command:prod cron:calendar:calendar-event-list-fetch
yarn command:prod cron:calendar:calendar-events-import
yarn command:prod cron:messaging:ongoing-stale
yarn command:prod cron:calendar:ongoing-stale
yarn command:prod cron:workflow:automated-cron-trigger
```

## Исходящие подключения к внутренним хостам

По умолчанию Twenty отклоняет исходящие подключения к частным/внутренним IP-адресам (защита от SSRF). Это относится к HTTP-действиям рабочих процессов, вебхукам, поставщикам удостоверений SSO и подключениям IMAP/SMTP/CalDAV. Если ваш поставщик удостоверений, почтовый или календарный сервер работает в частной сети, укажите его имя хоста или IP-адрес:

```bash
OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS=keycloak,mail.internal,192.168.1.10
```

Записи сопоставляются только по имени хоста, без подстановочных знаков: для издателя OIDC, например `http://keycloak:8080/realms/twenty`, укажите `keycloak`. Все остальные частные адреса остаются заблокированными, и даже разрешенный хост никогда не сможет получить доступ к диапазону адресов метаданных облака. Установите для переменной значение `*`, чтобы полностью отключить защиту; это допустимо только в доверенных изолированных сетях.

`OUTBOUND_HTTP_SAFE_MODE_ENABLED` устарела. Пока ей присвоено значение `false`, защита остается полностью отключенной, а `OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS` игнорируется, поэтому удалите ее при переходе на список.

Этот список не охватывает вложения файлов для ИИ: изображения и PDF поступают в модель в виде ссылок, сформированных из `SERVER_URL` и получаемых либо поставщиком ИИ, либо AI SDK в воркере, который отклоняет приватные адреса. Для работы вложений `SERVER_URL` должен быть общедоступным; при `localhost` или приватном `SERVER_URL` чаты и агенты ИИ работают только с текстом.

## Конфигурация электронной почты

1. Перейдите в **Настройки → Панель администратора → Переменные конфигурации**
2. Найдите раздел **Электронной почты**
3. Настройте параметры вашего SMTP:

<Tabs>

  <Tab title="Gmail">

  Вам потребуется предоставить [Пароль Приложения](https://support.google.com/accounts/answer/185833).
  * EMAIL_DRIVER=smtp
  * EMAIL_SMTP_HOST=smtp.gmail.com
  * EMAIL_SMTP_PORT=465
  * EMAIL_SMTP_USER=gmail_email_address
  * EMAIL_SMTP_PASSWORD='gmail_app_password'

  </Tab>

  <Tab title="Office365">

  Помните, что если у вас включена двухфакторная аутентификация, вам потребуется предоставить [пароль приложения](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
  * EMAIL_DRIVER=smtp
  * EMAIL_SMTP_HOST=smtp.office365.com
  * EMAIL_SMTP_PORT=587
  * EMAIL_SMTP_USER=office365_email_address
  * EMAIL_SMTP_PASSWORD='office365_password'

  </Tab>

  <Tab title="smtp4dev">

  **smtp4dev** - это поддельный SMTP почтовый сервер для разработки и тестирования.
  * Запустите образ smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
  * Получите доступ к интерфейсу smtp4dev здесь: [http://localhost:8090](http://localhost:8090)
  * Установите следующие переменные:
    * EMAIL_DRIVER=smtp
    * EMAIL_SMTP_HOST=localhost
    * EMAIL_SMTP_PORT=2525

  </Tab>

</Tabs>

<Warning>
**Режим только для среды:** если вы установили `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, добавьте эти переменные в свой `.env` файл вместо этого.
</Warning>

## S3 Хранилище

<Warning>
По умолчанию Twenty магазинов загрузили файлы в локальной файловой системе. Для продакшн-развертываний используйте S3 или совместимый с S3 сервис (MinIO, DigitalOcean Spaces и т. д.). чтобы файлы сохранялись при перезапусках контейнеров и были доступны на нескольких экземплярах сервера при масштабировании.
</Warning>

Установите `STORAGE_TYPE=S_3` и настройте переменные `STORAGE_S3_*` через админ-панель или `.env`.

| Переменная                            | Обязательно | Описание                                                                                                                                                                                                                                  |
| ------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `STORAGE_S3_REGION`                   | Да          | Регион бакета: регион AWS, например `eu-west-3`, или специфичный для провайдера идентификатор, например `fr-par` для Scaleway.                                                                                                            |
| `STORAGE_S3_NAME`                     | Да          | Имя бакета.                                                                                                                                                                                                                               |
| `STORAGE_S3_ACCESS_KEY_ID`            | Нет         | Ключ доступа пользователя IAM. Не задавайте, чтобы использовать цепочку учетных данных AWS по умолчанию (см. [Учетные данные](#credentials)).                                                                                             |
| `STORAGE_S3_SECRET_ACCESS_KEY`        | Нет         | Секрет для указанного выше ключа доступа. Требуется, когда задан `STORAGE_S3_ACCESS_KEY_ID`.                                                                                                                                              |
| `STORAGE_S3_ENDPOINT`                 | Нет         | Пользовательский URL-адрес конечной точки. Только для S3-совместимых сервисов, таких как `http://minio:9000`, или для конечной точки интерфейса AWS VPC. Не задавайте для нативного AWS S3, где SDK определяет конечную точку по региону. |
| `STORAGE_S3_PRESIGNED_URL_ENABLED`    | Нет         | Когда задано `true`, скачивания перенаправляются на предварительно подписанные URL-адреса, а браузеры загружают файлы напрямую в бакет, минуя сервер. По умолчанию: `false`.                                                              |
| `STORAGE_S3_PRESIGNED_URL_BASE`       | Нет         | Публичная конечная точка для использования в предварительно подписанных URL-адресах, когда `STORAGE_S3_ENDPOINT` — внутренний адрес, недоступный браузерам, например MinIO внутри Docker.                                                 |
| `STORAGE_S3_PRESIGNED_URL_EXPIRES_IN` | Нет         | Срок действия предварительно подписанных URL-адресов в секундах. По умолчанию: `900`.                                                                                                                                                     |

Минимальный `.env` для AWS S3 с пользователем IAM:

```ini
STORAGE_TYPE=S_3
STORAGE_S3_REGION=eu-west-3
STORAGE_S3_NAME=my-twenty-bucket
STORAGE_S3_ACCESS_KEY_ID=AKIA...
STORAGE_S3_SECRET_ACCESS_KEY=...
```

<Note>
Файл Docker Compose передает из `.env` `STORAGE_TYPE`, `STORAGE_S3_REGION`, `STORAGE_S3_NAME`, `STORAGE_S3_ENDPOINT` и две переменные учетных данных. Задайте переменные предварительно подписанных URL-адресов в панели администратора или добавьте их в блок `environment` сервисов `server` и `worker`.
</Note>

### Учётные данные

Когда `STORAGE_S3_ACCESS_KEY_ID` не задан, сервер получает учетные данные через цепочку AWS SDK по умолчанию: переменные среды `AWS_ACCESS_KEY_ID` и `AWS_SECRET_ACCESS_KEY`, общий файл учетных данных, роль задачи ECS, роль учетной записи сервиса EKS (IRSA) или профиль экземпляра EC2.

<Warning>
**Профили экземпляров EC2 и Docker:** профиль экземпляра предоставляется службой метаданных экземпляра, а контейнер в сети моста Docker по умолчанию находится от нее на один сетевой переход дальше, чем хост. При стандартном ограничении числа переходов IMDSv2, равном 1, контейнер никогда не получает учетные данные, хотя AWS CLI работает на хосте. Увеличьте ограничение до 2 на экземпляре или используйте статические учетные данные.
</Warning>

```bash
aws ec2 modify-instance-metadata-options --instance-id i-0123456789abcdef0 --http-put-response-hop-limit 2
```

Если учетные данные не удается найти, при первой загрузке сервер записывает в журналы `CredentialsProviderError: Could not load credentials from any providers`, тогда как в пользовательском интерфейсе отображается только общая ошибка.

### Разрешения бакета

Сначала загружаемый файл записывается во временный путь, проверяется, затем копируется в окончательный путь, а временный объект удаляется. Поэтому политике требуется больше, чем `s3:PutObject`:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::my-twenty-bucket"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload"
      ],
      "Resource": "arn:aws:s3:::my-twenty-bucket/*"
    }
  ]
}
```

`s3:ListBucket` используется для удаления папок, например при удалении рабочего пространства. Без него S3 отвечает на запросы отсутствующих объектов ошибкой отказа в доступе вместо сообщения об отсутствии объекта, поэтому сервер не может отличить отсутствующий файл от проблемы с разрешениями.

### Конечная точка и адресация

Twenty всегда использует адресацию в стиле пути, поэтому запросы направляются на `https://endpoint/bucket/key`. Для нативного AWS S3 не задавайте `STORAGE_S3_ENDPOINT`: SDK формирует `https://s3.{region}.amazonaws.com` из `STORAGE_S3_REGION`, поэтому ошибка в названии региона проявляется как ошибка DNS, а не ошибка S3. Задавайте конечную точку только для S3-совместимых сервисов или когда сервер обращается к S3 через конечную точку интерфейса VPC.

### CORS (совместное использование ресурсов между источниками)

Когда `STORAGE_S3_PRESIGNED_URL_ENABLED` имеет значение `true`, браузеры взаимодействуют с бакетом напрямую. Скачивания выполняются запросами `GET`, а загрузки — запросами `PUT` с заголовком `Content-Type`, из-за чего браузер сначала отправляет предварительный запрос. Поэтому политика CORS бакета должна разрешать ваш источник Twenty, оба метода и этот заголовок:

```json
[
  {
    "AllowedOrigins": ["https://crm.example.com"],
    "AllowedMethods": ["GET", "PUT"],
    "AllowedHeaders": ["Content-Type"],
    "MaxAgeSeconds": 3000
  }
]
```

Без предварительно подписанных URL-адресов весь файловый трафик проходит через сервер, и бакету не требуется настройка CORS.

### Устранение неполадок

Ошибки загрузки отображаются в пользовательском интерфейсе как общая ошибка. Базовая ошибка S3 содержится в журналах сервера (`docker compose logs server`) и в ответе GraphQL, видимом на вкладке сети браузера.

## Логические функции и интерпретатор кода

Twenty поддерживает логические функции для рабочих процессов и интерпретатор кода для анализа данных ИИ. Оба запускают предоставленный пользователем код и требуют явной настройки в целях безопасности.

### Настройки безопасности по умолчанию

**В продакшене (NODE_ENV=production):** логические функции и интерпретатор кода по умолчанию — **Отключено**. Если вам нужны эти функции, вы должны явно включить их с помощью `LOGIC_FUNCTION_TYPE` и `CODE_INTERPRETER_TYPE`.

**В разработке (NODE_ENV=development):** оба по умолчанию — **LOCAL** для удобства при локальном запуске.

<Warning>
**Уведомление о безопасности:** локальный драйвер (`LOGIC_FUNCTION_TYPE=LOCAL` или `CODE_INTERPRETER_TYPE=LOCAL`) выполняет код напрямую на хосте в процессе Node.js без изоляции. Его следует использовать только для доверенного кода в разработке. Для рабочих развёртываний, обрабатывающих недоверенный код, используйте `LOGIC_FUNCTION_TYPE=LAMBDA` или `CODE_INTERPRETER_TYPE=E2B` (с песочницей) либо оставьте их отключёнными.
</Warning>

### Логические функции — доступные драйверы

| Драйвер   | Переменная окружения           | Сценарий использования                 | Уровень безопасности                      |
| --------- | ------------------------------ | -------------------------------------- | ----------------------------------------- |
| Отключено | `LOGIC_FUNCTION_TYPE=DISABLED` | Полностью отключить логические функции | Н/Д                                       |
| Локальный | `LOGIC_FUNCTION_TYPE=LOCAL`    | Разработка и доверенные среды          | Низкий (без изоляции)                     |
| Lambda    | `LOGIC_FUNCTION_TYPE=LAMBDA`   | Продакшн с недоверенным кодом          | Высокий (изоляция на уровне оборудования) |

### Логические функции — рекомендуемая конфигурация

**Для разработки:**

```bash
LOGIC_FUNCTION_TYPE=LOCAL  # default when NODE_ENV=development
```

**Для продакшна (AWS):**

```bash
LOGIC_FUNCTION_TYPE=LAMBDA
LOGIC_FUNCTION_LAMBDA_REGION=us-east-1
LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key
LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
```

**Чтобы отключить логические функции:**

```bash
LOGIC_FUNCTION_TYPE=DISABLED  # default when NODE_ENV=production
```

### Интерпретатор кода — доступные драйверы

| Драйвер   | Переменная окружения             | Сценарий использования                                | Уровень безопасности              |
| --------- | -------------------------------- | ----------------------------------------------------- | --------------------------------- |
| Отключено | `CODE_INTERPRETER_TYPE=DISABLED` | Отключить выполнение кода ИИ                          | Н/Д                               |
| Локальный | `CODE_INTERPRETER_TYPE=LOCAL`    | Только для разработки                                 | Низкий (без изоляции)             |
| E2B       | `CODE_INTERPRETER_TYPE=E_2_B`    | Рабочая среда с изолированным исполнением в песочнице | Высокий (изолированная песочница) |

<Note>
При использовании `LOGIC_FUNCTION_TYPE=DISABLED` или `CODE_INTERPRETER_TYPE=DISABLED` любая попытка выполнения вернёт ошибку. Это полезно, если вы хотите запускать Twenty без этих возможностей.
</Note>

## API и фронтенд на отдельных хостах

Актуально только в том случае, если вы не позволяете бэкенду обслуживать фронтенд. Для развертываний с одинаковым origin
здесь ничего не требуется.

Укажите каждый браузерный origin, который обращается к API, через запятую. `SERVER_URL`
и `FRONTEND_URL` уже считаются доверенными. Сервер записывает предупреждение в журнал, когда браузер
обращается к нему с неуказанного источника.

```bash
AUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com
```

<Warning>
Фронтенд отправляет учетные данные при каждом запросе, а браузеры отклоняют
ответ с учетными данными от неуказанного источника, поэтому приложение не загружается, пока
вы не зададите этот параметр.
</Warning>

Если два хоста находятся в разных регистрируемых доменах (а не просто в разных
поддоменах), также установите `AUTH_COOKIE_SAME_SITE=none`, что требует HTTPS.

При включённой поддержке нескольких рабочих пространств не перечисляйте здесь все поддомены рабочих пространств.
Вместо этого маршрутизируйте пути API (`/graphql`, `/metadata`, `/rest`, `/auth/`, `/client-config`, `/file`) на бэкенд для каждого имени хоста рабочего пространства, чтобы каждое рабочее пространство оставалось в рамках одного источника (same-origin) — именно так работает Twenty Cloud.

<PageBanner illustration="dev-self-host" />