
whatsapp rest.
Требования
Поддерживаемые платформы: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL рекомендуется).
Докер
Изображения публикуются на Docker Hub и GHCR:aldinokemal2104/go-whatsapp-web-multideviceghcr.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
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 перечисляет каждый флаг.
Из источника
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-сервере.