> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Лучшая практика производства

> GOWA безопасно работает в производстве: безопасность, хранение, резервное копирование, обратный прокси, мониторинг и отправка гигиены.

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

* **Установите `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](https://gowa-docs.mintlify.site/ru/api-reference/authentication.md).
* **Привязка к приватно** (`APP_HOST=127.0.0.1` или частной сети), когда только локальным службам нужен доступ.
* Сбой авторизации на прокси-сервере; у GOWA нет [ограничения скорости](https://gowa-docs.mintlify.site/ru/advanced/rate-limiting.md).

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

| Путь | Содержание | Резервное копирование? |
| - | - | - |
| `storages/whatsapp.db` (или `DB_URI`) | WhatsApp сеансы и ключи | Да. Потеря это означает повторное восстановление каждого устройства. |
| `storages/chatstorage.db` | Чаты, сообщения, расписания и другие состояния GOWA | Да |
| `storages/oauth.db` | Клиенты MCP OAuth и хэши токена | Если используется OAuth |
| `statics/` | QR-коды, загруженные и запланированные медиа | Опционально |

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

## Докер

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* Закрепить метку версии, а не `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](https://gowa-docs.mintlify.site/ru/installation.md#%D0%B7%D0%B0-%D0%BE%D0%B1%D1%80%D0%B0%D1%82%D0%BD%D1%8B%D0%BC-%D0%BF%D1%80%D0%BE%D0%BA%D1%81%D0%B8).

## Мониторинг

* **Жизненно:** `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](https://gowa-docs.mintlify.site/ru/api-reference/metrics.md). Предупреждение о `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 дней, если телефон не в сети.


## Related topics

- [Получение сообщений](https://gowa-docs.mintlify.site/ru/examples/receiving-messages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.