Безопасность
- Установите
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остается в корне.
Мониторинг
- Жизненно:
GET /healthвозвращает200 OKкогда процесс находится в хранилище. Он не проверяет WhatsApp. - WhatsApp подключение: Опрос
GET /devices/{device_id}/statusи оповещение, когдаis_logged_infalse. - События: Подпишитесь на веб-хуки и оповещайте о пропущенном трафике для номеров занятых.
- Журналы: собирайте контейнер stdout; используйте
APP_DEBUG=trueтолько при диагностике.
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 дней, если телефон не в сети.
