Перейти к основному содержанию

Безопасность

  • Установите APP_BASIC_AUTH с длинным произвольным паролем. Для привязки без привязки к циклу требуются учетные данные, если только APP_ALLOW_UNAUTHENTICATED=true не будет такой проверки. Loopback может работать без учётных данных для локальной разработки.
  • Установите WHATSAPP_WEBHOOK_SECRET явно. Без этого GOWA генерирует случайный ключ, который меняется при перезапуске. Проверьте X-Hub-Signature-256 через тело запроса. Держите исходящее webhook проверка TLS включена.
  • Terminate TLS на обратном прокси; GOWA сам говорит на HTTP.
  • Ограничить /statics. QR-коды и загруженные файлы под /statics/* обслуживаются без Базовой Авто. Блокируйте или защищайте этот путь от прокси при чувствительности носителя и регулярно подбирайте statics/media.
  • Не выставляйте /chatwoot/webhook без CHATWOOT_WEBHOOK_SECRET при включении Chatwoot.
  • Установите APP_CORS_ALLOWED_ORIGINS, если браузеры вызывают API напрямую; wildcard CORS не авторизовывает запись браузера или /ws. Настройте конкретное происхождение в APP_TRUSTED_ORIGINS или в списке разрешений CORS. См. Authentication.
  • Привязка к приватно (APP_HOST=127.0.0.1 или частной сети), когда только локальным службам нужен доступ.
  • Сбой авторизации на прокси-сервере; у GOWA нет ограничения скорости.

Хранилище и резервное копирование

  • Использовать PostgreSQL для DB_URI, если вы хотите управляемые резервные копии; хранилище чата всегда SQLite.
  • Резервное копирование во время остановки GOWA или использование инструментов резервного копирования вашей базы данных.
  • Резервные копии хранилища зашифрованы: база данных сессии эквивалентна авторизованной учетной записи.
  • Запустите экземпляр GOWA на каждое хранилище. Два процесса, разделяющие сеанс, вызывают отключения и конфликты. GOWA не поддерживает горизонтальное масштабирование.

Докер

  • Закрепить метку версии, а не latest и прочитать заметки о выпуске перед обновлением.
  • Контейнер запускается как некорневой пользователь (UID 20001); убедитесь, что смонтированные тома доступны для записи.
  • Изображение устанавливает TZ=UTC. Расписания используют timezone, который вы перенесёте, поэтому это не повлияет на них.

Обратный прокси

  • Установите APP_TRUSTED_PROXIES на ваш прокси-сервер для корректного чтения IP-адресов.
  • Разрешить обновление WebSocket на /ws.
  • Увеличить ограничение тела до 100 MB (client_max_body_size 100m; в nginx).
  • Оставьте таймауты прокси выше таймаута 45-секундного запроса GOWA.
  • Для развертывания подпути используйте APP_BASE_PATH; /health остается в корне.
См. пример nginx Installation.

Мониторинг

  • Жизненно: GET /health возвращает 200 OK когда процесс находится в хранилище. Он не проверяет WhatsApp.
  • WhatsApp подключение: Опрос GET /devices/{device_id}/status и оповещение, когда is_logged_in false.
  • События: Подпишитесь на веб-хуки и оповещайте о пропущенном трафике для номеров занятых.
  • Журналы: собирайте контейнер stdout; используйте APP_DEBUG=true только при диагностике.
GOWA переподключается автоматически при запуске и проверяется каждые 5 минут. Устройство, вышедшее из системы должно быть восстановлено. GET /app/metrics возвращает процесс аутентификации, память, диск и метрику устройства без выбора устройства. См. Server metrics. Предупреждение о device.logged_out, device.temporary_ban и device.reachout_timelock webhooks.

Получатели вебхуков

  • Верните ответ 2xx в течение 10 секунд; выполняйте обработку асинхронно.
  • Дедупликация устройством, типом событий и идентификаторами события. Только идентификаторы сообщений не различают редактирования, реакции или более поздние состояния чека.
  • После 5 неудачных попыток событие прекращается. Используйте GET /chats и GET /chat/{jid}/messages, чтобы выгнать из строя после неудачи.

Отправка гигиены

  • Сообщение людям, которые сначала выбрали или написали письмо.
  • Посылается с задержками и jitter; избегайте идентичного наполненного текста.
  • Остановить WA_REACHOUT_TIMELOCK.
  • Держите WHATSAPP_ACCOUNT_VALIDATION=true так что незарегистрированные цифры проходят быстро.
  • WhatsApp позволяет до четырех связанных устройств на одном аккаунте, а также развязывает спутников через 14 дней, если телефон не в сети.