Saltar al contenido principal
GOWA Despliegue y Acceso Resumen GOWA viene como un binario. El API REST, webhooks, dashboard y endpoint MCP empiezan con whatsapp rest.

Requisitos

Plataformas soportadas: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL recomendado).

Doctor

Las imágenes se publican en Docker Hub y GHCR:
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storages contiene las bases de datos SQLite (sesiones, historial de chat, programas, OAuth). Perderlas desemparejan cada dispositivo.
  • /app/statics contiene imágenes QR, subidas y medios descargados.
  • El comando predeterminado es rest. Pasar las banderas después de ella, por ejemplo ... go-whatsapp-web-multidevice rest --autoreply="Away".
  • El punto de entrada corrige la propiedad del volumen y deja caer los privilegios a gowauser (UID 20001, GID 20000).
  • El tiempo del contenedor es UTC (TZ=UTC). Reemplaza TZ si necesitas marcas de tiempo de registro locales.

Componer Docker

docker-compose.yml
Genera una clave web estable con openssl rand -hex 32 y establece WHATSAPP_WEBHOOK_SECRET en tu shell o Componer .env antes de comenzar este ejemplo. El propio repositorio docker-compose.yml construye la imagen desde docker/golang.Dockerfile y lee src/.env. Úsalo cuando quieras construir localmente: cp src/.env.example src/.env && docker compose up -d --build.

Liberar binario

Descarga un archivo de GitHub Releases. Los archivos se llaman whatsapp_<version>_<os>_<arch>.zip, por ejemplo:
Instalar las herramientas multimedia en el host:
Verifique la descarga contra checksums.txt de la misma versión. ./whatsapp version imprime la versión; ./whatsapp --help muestra cada bandera.

Desde la fuente

En macOS también export CGO_CFLAGS_ALLOW="-Xpreprocessor" antes de construir.

ARM sin una toolchain C

La etiqueta de construcción purego selecciona un controlador pure-Go SQLite para que pueda compilar de forma cruzada con CGO deshabilitado:

Almacenamiento

Por defecto todo es SQLite bajo storages/: DB_URI también acepta PostgreSQL, por ejemplo postgres://user:pass@host:5432/gowa?sslmode=verify-full. La sesión remota PostgreSQL almacena por defecto la verificación de certificados cuando no se ha establecido ningún modo TLS efectivo. La URI explícita, el entorno o la configuración TLS del servicio PostgreSQL siguen aplicándose. Vea configuración de almacenamiento. GOWA crea archivos SQLite con permisos 0600 de solo propietario y nuevos directorios padres con 0700. Los directorios existentes mantienen sus permisos. Copia de seguridad storages/ (o PostgreSQL más storages/) para mantener emparejados dispositivos a través de reconstrucciones. Trata estas copias de seguridad como credenciales.

Beind a un proxy inverso

Sirve GOWA bajo una subruta con APP_BASE_PATH, y confía en las cabeceras reenviadas por el proxy con APP_TRUSTED_PROXIES:
/health permanece en la raíz (/health, no /gowa/health) así que las sondas funcionan independientemente del camino base. El protector de origen del navegador necesita el host público. Preservar Host como arriba, o enviar X-Forwarded-Host desde un proxy de confianza. Un dashboard alojado por separado necesita su origen exacto en APP_TRUSTED_ORIGINS o APP_CORS_ALLOWED_ORIGINS. Un comodín no autoriza mutaciones o WebSockets. Sirve el dashboard sobre HTTP o HTTPS, porque las páginas file:// tienen un origen null no confiable. El oyente por defecto se niega a iniciar sin las credenciales completas de Auth Básica. Sólo habilita APP_ALLOW_UNAUTHENTICATED=true cuando el proxy autentifica llamadas y los clientes no pueden eludirlas. Para desarrollo local sin autenticación, vincula APP_HOST=127.0.0.1.

Verificar

/health devuelve OK una vez inicializado el almacenamiento. No reporta si alguna cuenta de WhatsApp está conectada; usa GET /devices/{device_id}/status para eso.

Actualizando

Copia de seguridad storages/, tira la nueva imagen o binario, y reinicia. Lee las notas de lanzamiento para romper los cambios primero. Unos notables: v6 hizo obligatorio el subcomando rest, v7 movió binarios a archivos GoReleaser, v8 agregado multidispositivo (las llamadas con ámbito de dispositivo necesitan X-Device-Id una vez más de un dispositivo existe), y el modo independiente whatsapp mcp (:8080/sse) fue reemplazado por el punto final /mcp en el servidor REST.