Twenty CRM
CRM для B2B-продаж на своем сервере: клиенты, сделки и связанные с ними договоры в бесплатной редакции. Развернули 2.48.0 на Fatmetal Cloud Server, замерили ресурсы и проверили создание полей и связей.
Вердикт
- Отделу B2B-продаж, которому тесно в таблице «клиент - сделка» и нужны свои связанные договоры.
- Интегратору, который настраивает структуру CRM через интерфейс и оставляет базу у заказчика.
- Бухгалтерии, которой нужны проведение документов и регламентированный учет.
- Отделу маркетинга, который рассчитывает на бесплатные кампании в self-hosted редакции.
Что это и какую задачу решает
Если клиентская база, сделки и договоры лежат на разных листах, менеджеру приходится искать связанные строки и сверять названия клиентов. В Twenty эти записи связаны: из карточки клиента можно открыть его сделки и договоры.
Например, у компании «Северный Маяк» видны контакт Ирина Волкова, сделка «Поставка оборудования» и договор ДП-2026-018. Из договора можно перейти обратно к компании или сделке, а не искать их заново по названию.
Договор хранится отдельной записью: у него свои сумма и дата окончания. Такой объект добавляется через «Модель данных» и связывается с существующими компаниями и сделками. Таблица и канбан показывают те же записи разными способами.
Все записи демонстрационные. Объект и поля созданы через интерфейс Community без корпоративного ключа. Сумма сделки и договора - 1,2 млн рублей; названия и значения сохранились после перезагрузки страницы.
Что изменилось с прошлого разбора
Между 2.14.0 и 2.48.0 изменились формы создания записей и настройки. API, вебхуки и приложения находятся в «Разработчиках», MCP - в разделе «ИИ». Производственная установка по-прежнему содержит четыре сервиса.
С 2.34 нужен PostgreSQL 15 или новее; здесь сохранен PostgreSQL 16. Обновились переменные подключения к базе и хранилищу, условия лицензирования расширений и платные ограничения кампаний.
Старая 2.14.0 затронута критической уязвимостью, исправленной в 2.15.0. Детали и другие исправления - в таблице уязвимостей. Перед обновлением сохраните базу, файлы и ключи.
Чем отличается от платных CRM
У Community нет платы за рабочее место: расходы переходят в сервер, обновления и резервные копии. Это полезно, когда нужны свои объекты и прямой контроль над базой.
| Продукт | Публичная ставка за месяц | Что выбирает покупатель |
|---|---|---|
| Twenty Community | 0 за лицензию ядра; сервер отдельно | Своя модель данных и самостоятельное обслуживание |
| Twenty Cloud Pro | $9 за пользователя при годовой оплате | Облако вендора |
| Salesforce Starter Suite | $25 за пользователя | Коммерческая платформа |
| HubSpot Sales Hub Starter | $9 за место при годовой оплате | Облачная CRM |
| Pipedrive Lite | От $14 за место при годовой оплате | Облачная воронка продаж |
Ставки проверены 18 октября 2026: Twenty, Salesforce, HubSpot, Pipedrive. Наборы функций различаются; это ориентиры расходов, а не равнозначные комплектации.
Salesforce ограничивает отношения с российскими клиентами, Pipedrive объявлял приостановку сервиса в России и Беларуси. Международная цена не означает доступный заказ из РФ. Свой сервер Fatmetal оплачивается в рублях.
Как устроен стек и сколько ресурсов выделить
Server отдает интерфейс React и API NestJS, worker выполняет фоновые задания. PostgreSQL хранит записи, Redis обслуживает очередь и кеш. Оба процесса Twenty используют один образ, но память расходуют отдельно.
В production compose нет ClickHouse. HTTPS здесь завершает отдельный Caddy; порт приложения 3000 доступен только на localhost. Постоянные данные лежат в томах PostgreSQL и локальных файлов Twenty.
| Выбор | Для этого разбора |
|---|---|
| ОС | Ubuntu 24.04 LTS |
| Рекомендуемый тариф | CPU4-RAM8-DISK100: 4 vCPU, 8 ГБ, 100 ГБ |
| Цена сервера | 1100 руб/мес на дату проверки |
| Состав | Twenty 2.48.0, PostgreSQL 16.15, Redis 7.4.11, Caddy 2.11.7 |
Рекомендация основана на импорте компаний и запуске: краткий пик превысил два ядра. Диск имел большой запас - система заняла около 5,3 ГБ. Сначала загрузите пробную клиентскую базу: потребление зависит от состава ваших данных.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация: CPU4-RAM8-DISK100
Развертывание на Fatmetal Cloud Server
Установите Docker на чистую Ubuntu
На чистой Ubuntu войдите по SSH и выполните sudo -i. Направьте ваш-домен на сервер, откройте TCP80/443.
curl -fsSL https://get.docker.com -o /tmp/get-docker.sh sh /tmp/get-docker.sh mkdir -p /opt/twenty && cd /opt/twentyВозьмите compose именно из релиза
Работайте в /opt/twenty. Исходник закреплен тегом релиза.
curl -fsSL https://raw.githubusercontent.com/twentyhq/twenty/twenty/v2.48.0/packages/twenty-docker/docker-compose.yml -o docker-compose.yml sed -i 's/"3000:3000"/"127.0.0.1:3000:3000"/; s/postgres:16$/postgres:16.15-bookworm/; s/image: redis$/image: redis:7.4.11-bookworm/; /test: curl --fail/a\ start_period: 300s' docker-compose.ymlЗадайте адрес и отдельные секреты
Подставьте свой домен. Оболочка создаст разные секреты. Сохраните .env для восстановления.
umask 077 cat > .env <<EOF TAG=v2.48.0 SERVER_URL=https://ваш-домен PG_DATABASE_NAME=default PG_DATABASE_USER=postgres PG_DATABASE_PASSWORD=$(openssl rand -hex 24) APP_SECRET=$(openssl rand -hex 32) ENCRYPTION_KEY=$(openssl rand -hex 32) STORAGE_TYPE=local DISABLE_DB_MIGRATIONS=false DISABLE_CRON_JOBS_REGISTRATION=false EOFПоднимите четыре сервиса
Ожидание включает миграции. Предупреждения о незаданных S3-переменных допустимы при STORAGE_TYPE=local; не меняйте ключи при повторном запуске.
docker compose pull docker compose up -d --wait --wait-timeout 600 docker compose ps curl -fsS http://127.0.0.1:3000/healthzВключите HTTPS
Caddy получит сертификат; для выдачи нужен открытый порт80.
cat > /opt/Caddyfile <<'EOF' ваш-домен { reverse_proxy 127.0.0.1:3000 } EOF docker run -d --name twenty-caddy --restart unless-stopped --network host -v /opt/Caddyfile:/etc/caddy/Caddyfile:ro -v caddy_data:/data -v caddy_config:/config caddy:2.11.7
Дождитесь выдачи сертификата: в docker logs twenty-caddy появится certificate obtained successfully. Откройте https://ваш-домен сразу после запуска. Создайте первый аккаунт, пароль и рабочую область: первый пользователь станет владельцем. Дождитесь подготовки рабочей области, заполните профиль; приглашение коллег можно пропустить. Затем выберите Settings → Experience → Language → Russian.
Создайте компанию и сделку, свяжите их через поле «Компания» и откройте повторно после обновления страницы.
Как добавить собственный договор
Откройте «Настройки → Модель данных → Добавить объект». Задайте «Договор» и «Договоры». Отключите синхронизацию меток с техническими именами и укажите contract/contracts.
Добавьте связь «Компания» типа Relation → Belongs to one: снимите «Возможности» и выберите «Компании». Для связи «Сделка» оставьте цель «Возможности». Перед сохранением закройте список целей.
Добавьте Currency с названием «Сумма», валютой RUB и форматом «Полный», затем Date «Дата окончания». Создайте договор и заполните обе связи. Названия типов остаются английскими даже при русской навигации.
Чтобы изменить поле карточки, наведите на значение и нажмите появившийся редактор. После выбора связанной записи список закрывается сам. Договор станет виден и в обратной связи у компании.
Что показали замеры
Стенд CPU4-RAM8-DISK100: Ubuntu 24.04.4, Docker 29.9.1, Compose 5.6.0. Импортировали CSV с тысячей компаний, получили 1006 записей, затем полностью перезапустили стек.
| Показатель | Результат |
|---|---|
| Память в простое после перезапуска | Около 2,0 ГиБ вместе с Caddy |
| Server / worker | 958 / 1022 МиБ |
| PostgreSQL / Redis / Caddy | 11 / 8 / 18 МиБ |
| Скачивание Twenty, PostgreSQL и Redis | 63 секунды |
| Повторный запуск до первого задания worker | Около 3 минут |
| Образ Twenty на диске | 1,85 ГБ |
| Рост базы от 1000 двухполевых компаний | 1,38 МиБ |
| Получение HTML по публичному HTTPS | Около 61 мс |
Последняя строка показывает время получения HTML. Быстрый HTTP-ответ еще не означает готовность фоновых задач: worker закончил запуск позже сервера.
Первый запуск с диагностикой занял около восьми минут. Это запас на установку и разбор ошибки, а не обещание времени готовой карточки. Рост базы относится к компаниям с названием и доменом; вложения потребуют отдельного места.
Проверено 18 октября 2026 на Twenty 2.48.0. Замеры относятся к описанному набору данных и тарифу.
Где может сломаться
Причина. Миграции пустой базы идут дольше стандартного окна healthcheck. Worker ждет здоровый server.
Решение. В статье уже задан start_period: 300s. Посмотрите причину до повторного запуска:
cd /opt/twenty
docker compose logs --tail=80 server worker
docker compose up -d --wait --wait-timeout 600Причина. Режим logger оставляет письма в журнале. Регистрация работает, но это не доставка почты.
Решение. В server и worker раскомментируйте EMAIL_DRIVER/EMAIL_FROM_ADDRESS/EMAIL_SMTP_* из официального compose, заполните своим SMTP и пересоздайте контейнеры:
cd /opt/twenty
nano docker-compose.yml
docker compose up -d --force-recreate server workerИспользуйте EMAIL_DRIVER=smtp, порт своего провайдера и его логин/пароль. На стенде доставку проверили через SMTP; для вашей установки нужны ваши реквизиты.
ИИ и доступ к внешней модели
ИИ-чат работает с внешним провайдером по вашему ключу. На стенде OpenRouter с моделью openai/gpt-4o-mini ответил через прокси Fatmetal; успешные ответы сохранены в интерфейсе.
Прокси к внешним API входит в стоимость сервера Fatmetal. Провайдера моделей выбираете вы.
Для server и worker добавьте одинаковый блок environment; NODE_USE_ENV_PROXY включает его использование встроенным HTTP-клиентом Node.
HTTP_PROXY: http://api-proxy.fatmetal.net:8080
HTTPS_PROXY: http://api-proxy.fatmetal.net:8080
NO_PROXY: localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,db,redis,server,worker
NODE_USE_ENV_PROXY: "1"Создайте /opt/twenty/ai.env с правами600 и своим ключом. Проверенная конфигурация для выбранной модели:
AI_PROVIDERS='{"stand":{"npm":"@ai-sdk/openai-compatible","name":"stand","label":"OpenRouter","baseUrl":"https://openrouter.ai/api/v1","apiKey":"ВАШ_КЛЮЧ","models":[{"name":"openai/gpt-4o-mini","label":"GPT-4o mini","contextWindowTokens":128000,"maxOutputTokens":4096,"inputCostPerMillionTokens":0.15,"outputCostPerMillionTokens":0.6}]}}'
AI_MODELS_DEFAULT_EXTRA_FAST=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_FAST=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_BALANCED=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_SMART=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_EXTRA_SMART=stand/openai/gpt-4o-miniВ обоих сервисах добавьте env_file: [ai.env] на уровне environment, затем выполните docker compose up -d --force-recreate server worker. Откройте «ИИ → Новый чат» и отправьте вопрос.
Ключ и выбранная модель задаются отдельно; прокси их не заменяет. Данные, отправленные в чат внешней модели, покидают вашу CRM. Не передавайте ей клиентские сведения без подходящего основания.
Раздел «Разработчики» содержит API, вебхуки и приложения. Настройки «ИИ → MCP» показывают адрес сервера для внешних клиентов; при выдаче API-ключа выбирайте нужную роль доступа.
Безопасность, копия и восстановление
Оставьте 3000 на localhost, используйте HTTPS и сохраните .env вместе с данными: потеря ENCRYPTION_KEY лишает доступа к зашифрованным секретам. Каталог /opt/twenty доступен администратору сервера.
Для согласованной копии остановите стек. Архив включает базу, локальные файлы и конфигурацию; он содержит секреты. Команды выполняются от root:
cd /opt/twenty
umask 077
docker compose stop
tar --numeric-owner -czf /root/twenty-backup.tgz -C / opt/twenty var/lib/docker/volumes/twenty_db-data/_data var/lib/docker/volumes/twenty_server-local-data/_data
docker compose up -d --wait --wait-timeout 600Перенесите архив в закрытое хранилище вне этой машины. Восстановление ниже заменяет данные текущего инстанса; используйте ту же версию PostgreSQL и Twenty, что записана в архиве.
cd /opt/twenty
docker compose down
docker volume rm twenty_db-data twenty_server-local-data
docker compose create
tar --numeric-owner -xzf /root/twenty-backup.tgz -C /
docker compose up -d --wait --wait-timeout 600Перед обновлением сделайте такую копию. Официальный порядок поддерживает прямой переход с версий от 1.23: миграции запускает server. После копии закрепите целевой релиз и дождитесь завершения:
cd /opt/twenty
docker compose down
sed -i 's/^TAG=.*/TAG=v2.48.0/' .env
docker compose pull
docker compose up -d --wait --wait-timeout 600Не создавайте новый .env поверх действующей установки: сохраните прежние APP_SECRET и ENCRYPTION_KEY. После обновления войдите, откройте компанию и связанную сделку, проверьте worker по журналу. Ошибка миграции требует разбора лога или восстановления копии; смена тега назад не отменяет изменения базы.
Уязвимости прошлых версий
Инструкция ставит 2.48.0 с перечисленными исправлениями. Для старой версии используйте порядок обновления выше; 2.14.0 оставлять публичной не стоит.
| Идентификатор | Уровень | Затронуто | Исправлено в Twenty | Что делать |
|---|---|---|---|---|
| CVE-2026-73069 | critical | < 2.15.0 | 2.15.0 | Право DATA_MODEL позволяло выполнить SQL; при superuser возможны команды в контейнере базы. |
| GHSA-5p4m-2wfm-xmqj; GHSA-f88m-g3jw-g9cj | high | Зависимости js-yaml / sharp из 2.14.0 | Подтверждено в 2.30.0 | Новые версии зависимостей устраняют опубликованные ошибки. |
| CVE-2026-14257; 69152; 69192 | high | brace-expansion / ip-address из старого lock-файла | Подтверждено в 2.30.0 | Старые расширения обновляйте отдельно. |
| CVE-2026-85055 | medium | < 2.22.0 | 2.22.0 | Значение запрещенного поля раскрывалось через фильтрацию и число результатов. |
| CVE-2026-48930 | medium | Node.js 24.16.0 в образе Twenty 2.14.0; повторно в Twenty 2.19.1 | 2.19.0 (первое исправление); 2.20.0 (возвращено после отката 2.19.1) | Обновите образ вместе с Node.js. |
| CVE-2026-53666; 53668; 53669 | medium | Старые react-router / react-router-dom | Подтверждено в 2.43.0 | Обновлен маршрутизатор интерфейса. |
Для зависимостей указан подтвержденный релиз с исправлением. Подробные диапазоны компонентов приведены в связанных бюллетенях и списках изменений.
Когда это НЕ ваш выбор
Нужны кампании и корпоративное разграничение
SSO, доступ по отдельным записям, Audit logs и маркетинговые кампании относятся к Organization/Enterprise. С 2.19 кампании self-host требуют лицензию; свою установку нельзя считать бесплатной заменой всего HubSpot.
Договор должен стать учетным документом
Наш объект хранит связи и реквизиты, а учетные документы и обмен с 1С потребуют отдельного решения. Если это основной процесс, выбирайте специализированный учет.
Операторам нужен полностью русский интерфейс
Навигация переведена, но новые типы полей, некоторые формы и демозначения остаются английскими. Оцените это на рабочих экранах до внедрения.
Ядро распространяется под AGPLv3 с Twenty Application Exception, отдельные SDK/UI/приложения - под MIT; корпоративные части имеют коммерческие условия. Исключение для Application Interfaces позволяет выбирать лицензию расширений, но не снимает AGPL с измененного ядра. Текст лицензии 2.48.0.
Частые вопросы
Можно создать договор без платного ключа?
Да. На Community созданы объект contract, две связи, Currency в RUB и Date; запись сохранилась после обновления страницы.
Как переключить интерфейс на русский?
Settings → Experience → Language → Russian; после переключения раздел называется «Опыт работы». Формат даты и чисел выбирается отдельно.
Достаточно только контейнера server?
Нет. В проверенной установке есть отдельный worker; ему нужны здоровый server, PostgreSQL и Redis.
Как понять, что миграции закончились?
docker compose ps показывает healthy у server. Затем проверьте журнал worker и откройте записи через браузер.
История карточки - это платный Audit logs?
Нет. В карточке есть обычный таймлайн изменений; корпоративный журнал аудита - отдельная возможность.
Ключ модели входит в сервер?
Нет. В стоимость входит сетевой прокси, ключ и расход модели оплачиваются у выбранного провайдера.
Итог
Twenty Community подходит для B2B-базы, структуру которой вы хотите задавать сами. Компании, контакт, сделка и договор связаны через интерфейс; за эту модель не потребовался корпоративный ключ.
Ресурсы выбирайте с учетом двух процессов приложения и времени миграций. Перед переносом клиентской базы начните со своего набора полей, проверьте связи и отработайте восстановление копии.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.