> ## 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 с Docker, Docker Compose, бинарный релиз или из исходного кода, и запустите его за обратным прокси.

![GOWA Развертывание и обзор доступа](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

GOWA поставляется как один двоичный файл. REST API, webhooks, dashboard и MCP конечная точка начала с `whatsapp rest`.

## Требования

| Пункт 1 | Нужно для |
| - | - |
| FFmpeg | Преобразование медиа (видео, голосовые заметки). Включено в изображение Docker. |
| утилиты libwebp (`cwebp`, `dwebp`, `webpmux`) | Стикеры, включая анимированный WebP. Включено в изображение Docker. |
| Перейти 1.26+ | Сборка только из исходного кода. |

Поддерживаемые платформы: 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`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

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

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

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

Сгенерируйте ключ стабильного 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](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). Архивы с именем `whatsapp_<version>_<os>_<arch>.zip`, например:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

Установите медиа инструменты на хост:

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

Проверить загрузку с помощью `checksums.txt` из того же релиза. `./whatsapp version` печатает версию; `./whatsapp --help` перечисляет каждый флаг.

## Из источника

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

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

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

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

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## Хранилище

По умолчанию всё SQLite находится в разделе `storages/`:

| Данные | По умолчанию | Настройка |
| - | - | - |
| WhatsApp сеансы и ключи | `file:storages/whatsapp.db` | `DB_URI` |
| Кэш ключей сессии (необязательно, отдельная DB) | uses `DB_URI` | `DB_KEYS_URI` |
| История чата, реестр устройств, расписания | `file:storages/chatstorage.db` | не настраивается |
| Клиенты и токены MCP OAuth | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI` также принимает PostgreSQL, например, `postgres://user:pass@host:5432/gowa?sslmode=verify-full`. Удаленная сессия PostgreSQL хранит проверку сертификата, если не установлен эффективный режим TLS. Настройки TLS по-прежнему применимы к прописке URI, окружения или PostgreSQL. Смотрите [конфигурацию хранения](https://gowa-docs.mintlify.site/ru/configuration.md#%D1%85%D1%80%D0%B0%D0%BD%D0%B8%D0%BB%D0%B8%D1%89%D0%B5).

GOWA создает SQLite файлы с разрешениями владельца `0600` и новыми родительскими каталогами с `0700`. Существующие каталоги сохраняют свои права. Резервное копирование `storages/` (или PostgreSQL плюс `storages/`) для восстановления устройств. Рассматривайте эти резервные копии как учетные данные.

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

Сервируйте GOWA с помощью `APP_BASE_PATH` и доверяйте перенаправленным прокси заголовкам с помощью `APP_TRUSTED_PROXIES`:

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/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`.

## Подтвердить

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

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

## Обновление

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


## Related topics

- [Установка конфигурации вебхука устройства](https://gowa-docs.mintlify.site/ru/api-reference/device/установка-конфигурации-вебхука-устройства.md)
- [Установить тему группы](https://gowa-docs.mintlify.site/ru/api-reference/group/установить-тему-группы.md)
- [Установить исчезающий таймер сообщений](https://gowa-docs.mintlify.site/ru/api-reference/chat/установить-исчезающий-таймер-сообщений.md)
- [Ссылка на конфигурацию](https://gowa-docs.mintlify.site/ru/configuration.md)
- [Быстрый старт](https://gowa-docs.mintlify.site/ru/quickstart.md)


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