Перейти к основному содержанию
GOWA Развертывание и обзор доступа GOWA поставляется как один двоичный файл. REST API, webhooks, dashboard и MCP конечная точка начала с whatsapp rest.

Требования

Поддерживаемые платформы: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL рекомендуется).

Докер

Изображения публикуются на Docker Hub и GHCR:
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storages хранит базы данных SQLite (сессии, история чата, расписания, OAuth). Потеря их удаляет все устройства.
  • /app/statics содержит QR-изображения, загрузки и загруженный носитель.
  • Команда по умолчанию — rest. Передать флаги после него, например ... go-whatsapp-web-multidevice rest --autoreply="Away".
  • Точка входа фиксирует количество владельцев и уменьшает привилегии на gowauser (UID 20001, GID 20000).
  • Контейнерное время является UTC (TZ=UTC). Переопределите TZ, если вам нужны локальные временные метки журнала.

Докер Составление

docker-compose.yml
Сгенерируйте ключ стабильного webhook с помощью openssl rand -hex 32 и установите WHATSAPP_WEBHOOK_SECRET в вашей оболочке или написать .env перед началом этого примера. Файл docker-compose.yml из репозитория собирает образ из docker/golang.Dockerfile и считывает src/.env. Используйте его для локальной сборки: cp src/.env.example src/.env && docker compose up -d --build.

Релиз двоичного файла

Скачайте архив с GitHub Releases. Архивы с именем whatsapp_<version>_<os>_<arch>.zip, например:
Установите медиа инструменты на хост:
Проверить загрузку с помощью checksums.txt из того же релиза. ./whatsapp version печатает версию; ./whatsapp --help перечисляет каждый флаг.

Из источника

В macOS также export CGO_CFLAGS_ALLOW="-Xpreprocessor" перед сборкой.

ARM без C инструментальной цепи

Тег сборки purego выбирает драйвер pure-Go SQLite, так что вы можете перекрестно скомпилировать с CGO отключено:

Хранилище

По умолчанию всё SQLite находится в разделе storages/: DB_URI также принимает PostgreSQL, например, postgres://user:pass@host:5432/gowa?sslmode=verify-full. Удаленная сессия PostgreSQL хранит проверку сертификата, если не установлен эффективный режим TLS. Настройки TLS по-прежнему применимы к прописке URI, окружения или PostgreSQL. Смотрите конфигурацию хранения. GOWA создает SQLite файлы с разрешениями владельца 0600 и новыми родительскими каталогами с 0700. Существующие каталоги сохраняют свои права. Резервное копирование storages/ (или PostgreSQL плюс storages/) для восстановления устройств. Рассматривайте эти резервные копии как учетные данные.

За обратным прокси

Сервируйте GOWA с помощью APP_BASE_PATH и доверяйте перенаправленным прокси заголовкам с помощью APP_TRUSTED_PROXIES:
/health остается в корне (/health, а не /gowa/health), поэтому проверяет работу независимо от базового пути. Страна браузера нуждается в публичном хост-узле. Сохраняйте Host или отправьте X-Forwarded-Host с доверенного прокси. Индивидуальная панель отдельно нуждается в точном месте в APP_TRUSTED_ORIGINS или APP_CORS_ALLOWED_ORIGINS. Подстановочная карта не разрешает мутации или WebSockets. Серверная панель управления через HTTP или HTTPS, потому что file:// содержит ненадежный источник null. Слушатель по умолчанию отказывается запускаться без полной учётной записи Basic Auth. Включите APP_ALLOW_UNAUTHENTICATED=true, когда прокси аутентифицирует вызывающих и клиентов не может обойти ее. Для локальной разработки без аутентификации привяжите APP_HOST=127.0.0.1.

Подтвердить

/health возвращает OK после инициализации хранилища. Он не сообщает, подключена ли какая-либо учетная запись WhatsApp; для этого используйте GET /devices/{device_id}/status.

Обновление

Создайте резервную копию storages/, загрузите новый образ или бинарный файл и перезапустите приложение. Сначала ознакомьтесь с примечаниями к выпускам, чтобы узнать о несовместимых изменениях. Основные из них: в v6 подкоманда rest стала обязательной, в v7 бинарные файлы перенесены в архивы GoReleaser, в v8 добавлена поддержка нескольких устройств (если устройств больше одного, вызовам для конкретного устройства требуется X-Device-Id), а отдельный режим whatsapp mcp (:8080/sse) заменён конечной точкой /mcp на REST-сервере.