Chatwootv4.19.1
Поддержка клиентов для команды: чат сайта, почта и Telegram, история обращений и ответственные - замена чат-части Intercom.
Операторы отвечают клиентам из общей очереди, передают диалоги коллегам и видят предыдущую переписку. Макрос отправляет готовый ответ и закрывает решенный вопрос, а база знаний помогает отправить клиенту инструкцию. В бесплатной Community Edition нет лицензионной платы за каждого оператора; сервер и обслуживание вы оплачиваете сами.
После создания сервера рецепт устанавливает Chatwoot CE 4.19.1, создает администратора и открывает приложение по HTTPS с сертификатом Let's Encrypt. На чистых стендах страница входа открывалась примерно за 5-13 минут; основное время уходило на пакеты, образы и миграции. О ходе установки приходят уведомления. Собственный домен для первого входа не нужен.
Что внутри
- Chatwoot CE 4.19.1 на Ruby 3.4.4 и Rails
7.2.3.1 - кабинет оператора, виджет сайта, макросы, поиск, отчеты и база знаний для клиентов; интерфейс частично переведен на русский.
- Sidekiq 7.3.10
- обработка фоновых задач и писем, чтобы они не задерживали работу в очереди.
- PostgreSQL 16.15 с pgvector 0.8.7
- пользователи, обращения и история сообщений.
- Redis 7.4.12
- очередь фоновых задач и кеш приложения.
- Caddy 2.11.7
- вход по HTTPS, выпуск и автоматическое продление сертификата.
Всего пять контейнеров: веб-приложение и отдельный обработчик задач используют один образ Chatwoot.
Безопасность
- Администратор создан до открытия сайтапосторонний не сможет занять первый аккаунт; свободная регистрация закрыта, операторов приглашает администратор.
- Приложение и базы изолированыRails опубликован только на
127.0.0.1:3000, PostgreSQL и Redis не открыты в интернет; веб-доступ идет через Caddy по HTTPS. - Свои секреты и ключи шифрованияустановка генерирует их один раз, сохраняет при повторном запуске и ограничивает чтение конфигурации владельцем сервера.
- fail2ban для SSHпосле пяти неудачных попыток входа блокирует адрес на час.
- Телеметрия и push relay выключеныстатистика установки не отправляется вендору, внешний ретранслятор push-уведомлений не используется.
- Закрепленные образырецепт использует проверенные теги и digest, чтобы следующий заказ получил ту же сборку.
- Исправления уязвимостей прежних версийCE 4.19.1 содержит исправление CVE-2025-21628: в старых выпусках пользователь мог через фильтры обращений и контактов внедрить SQL-команду. Эта критическая ошибка закрыта еще в 3.16.0.
Как войти
Дождитесь уведомления о готовности. Адрес формируется из IP сервера: замените точки на дефисы, добавьте
.fatmetal.netи откройте/app/login. Например, для IP45.15.159.10вход находится по адресуhttps://45-15-159-10.fatmetal.net/app/login.Администратор уже создан. Логин -
admin@<исходное имя сервера>безhttps://и пути: например,admin@45-15-159-10.fatmetal.net. Если при установке задавалиADMIN_EMAIL, используйте его. Первый пароль - пароль сервера из личного кабинета Fatmetal с префиксомCw1!без пробела: сначалаCw1!, сразу за ним весь пароль сервера. Публичная регистрация закрыта.После входа смените пароль и укажите настоящий email в настройках профиля. Заполните предложенную форму компании, включая роль, сайт и часовой пояс. Чтобы изменить сайт, нажмите кнопку с карандашом рядом с полем.
Откройте Настройки -> Источники -> Добавить источник -> Сайт. Задайте название и адрес сайта, добавьте операторов, включая себя, и завершите создание. Скопируйте показанный JavaScript-код на страницы сайта перед закрывающим тегом
body.Откройте сайт как посетитель и отправьте сообщение. В Chatwoot выберите Диалоги -> Все или Неназначен, откройте обращение, назначьте ответственного и ответьте. Убедитесь, что ответ появился у посетителя в виджете.
Важно
Каналы вы подключаете на своих реквизитах. Для писем откройте Настройки -> Источники -> Добавить источник -> Email: укажите свой ящик, IMAP для приема и SMTP для ответов. Для Telegram выберите источник Telegram и укажите токен своего бота. Установка не создает почтовый ящик или бота; на стенде проверены сайт и почта.
Для приглашений операторов и восстановления пароля настройте системный SMTP отдельно от почтового источника. В /opt/chatwoot/.env заполните значения своего провайдера; ниже пример для порта 587 с STARTTLS:
SMTP_ADDRESS=smtp.example.org
SMTP_PORT=587
SMTP_USERNAME=support@example.org
SMTP_PASSWORD=пароль_вашего_SMTP
SMTP_AUTHENTICATION=login
SMTP_ENABLE_STARTTLS_AUTO=true
SMTP_OPENSSL_VERIFY_MODE=peer
SMTP_DOMAIN=example.org
MAILER_SENDER_EMAIL="Поддержка <support@example.org>"
Замените пример своими реквизитами и примените настройки:
cd /opt/chatwoot
sudo docker compose up -d --force-recreate rails sidekiq
Перед обновлением сохраните резервную копию PostgreSQL, вложения из тома chatwoot_storage_data и файл /opt/chatwoot/.env, включая ключи ACTIVE_RECORD_ENCRYPTION_*. Копирования только базы недостаточно, чтобы восстановить вложения. Проверенные команды копирования и восстановления приведены в разборе.
Платные Captain, SLA и SSO в эту установку CE не входят. Для этих возможностей выбирайте соответствующую редакцию вендора.
Лицензия
Community Edition распространяется по лицензии MIT.
Свой домен
- Направьте
A-запись своего домена на публичный IPv4 сервера. - Проверьте DNS:
ping ваш-домендолжен показывать этот IP. Если показывает прежний адрес, дождитесь обновления записей. - По SSH в файле
/etc/chatwoot-mp/params.envзадайте свой домен без протокола и пути, напримерDOMAIN=help.example.org. - Выполните
sudo bash /opt/chatwoot-mp/install.shи дождитесь завершения. Рецепт обновит адрес приложения и настройки Caddy; HTTPS проверяется до пяти минут с интервалом около десяти секунд. - Если свой домен еще не указывает на сервер, исправное приложение завершит установку успешно. Направьте
A-запись на IP этого сервера из личного кабинета Fatmetal: Caddy получит сертификат после обновления DNS. Если письмо о готовности уже приходило, повторно оно не отправляется. Когда DNS обновится, откройтеhttps://ваш-домен/app/login. - Логин администратора не меняется. Если первая установка была на автоматическом адресе, замените точки в IP сервера на дефисы и используйте
admin@<IP-с-дефисами>.fatmetal.net: например, для45.15.159.10логин -admin@45-15-159-10.fatmetal.net. Если задавалиADMIN_EMAIL, используйте этот адрес. Первый пароль - пароль этого сервера из личного кабинета Fatmetal с префиксомCw1!без пробела: сначалаCw1!, сразу за ним весь пароль сервера. Если меняли пароль в профиле, используйте свой новый пароль. - Для ранее установленного виджета скопируйте код с новым адресом из настроек источника сайта и замените старый код на страницах сайта.
При повторном запуске текущий DNS, нужный IP и пояснение об ожидании сертификата также доступны в приветствии при входе по SSH и в файле реквизитов: sudo cat /root/chatwoot-credentials.txt.
Требования
Для пилота с чатом сайта и почтой берите тариф CPU4-RAM8-DISK100: 4 ядра и 8 ГБ памяти. На CE 4.19.1 процессы пяти контейнеров занимали около 989 МиБ в простое; при передаче одного файла 8 МиБ наблюдали до 1058 МиБ. Это проверка сценария, а не лимит числа операторов. Для растущей команды, когда в часы нагрузки заканчивается свободная память или накапливаются фоновые задачи, рассмотрите CPU6-RAM16-DISK100; количество одновременно работающих операторов оценивайте по своей нагрузке.