Saltar al contenido principal

Seguridad

  • Establece APP_BASIC_AUTH con una contraseña aleatoria larga. Un enlace no-loopback requiere credenciales a menos que APP_ALLOW_UNAUTHENTICATED=true deshabilite explícitamente esa comprobación. El bucle puede ejecutarse sin credenciales para el desarrollo local.
  • Establece explícitamente WHATSAPP_WEBHOOK_SECRET. Sin él, GOWA genera una clave aleatoria que cambia al reiniciar. Verifique X-Hub-Signature-256 sobre el cuerpo de la petición. Mantenga la verificación TLS saliente activada.
  • Terminar TLS en un proxy inverso; GOWA habla en sí mismo HTTP.
  • Restringir /statics. Los códigos QR y los medios descargados bajo /statics/* se sirven sin Basic Auth. Bloquea o protege esa ruta en el proxy si los medios son sensibles, y limpia statics/media regularmente.
  • No exponga /chatwoot/webhook sin CHATWOOT_WEBHOOK_SECRET cuando Chatwoot esté habilitado.
  • Establece APP_CORS_ALLOWED_ORIGINS si los navegadores llaman directamente a la API; comodín CORS no autoriza escrituras del navegador o /ws. Configure los orígenes específicos en APP_TRUSTED_ORIGINS o la lista permitida CORS. Vea Authentication.
  • Vincula privadamente (APP_HOST=127.0.0.1 o una red privada) cuando sólo los servicios locales necesitan acceso.
  • No se han podido iniciar sesión con el límite de calificación en el proxy; GOWA no tiene límite de tasas.

Almacenamiento y copias de seguridad

  • Utilice PostgreSQL para DB_URI si desea copias de seguridad administradas; el almacenamiento del chat siempre es SQLite.
  • Copia de seguridad mientras GOWA se detiene, o utiliza las herramientas de copia de seguridad en línea de tu base de datos.
  • Guarda copias de seguridad cifradas: la base de datos de sesión es equivalente a una cuenta registrada.
  • Ejecuta una instancia de GOWA por almacenamiento. Dos procesos que comparten una sesión causan desconexiones y conflictos. GOWA no soporta escalado horizontal.

Doctor

  • Anclar una etiqueta de versión en lugar de latest, y leer las notas de publicación antes de actualizar.
  • El contenedor se ejecuta como un usuario no root (UID 20001); asegúrese de que los volúmenes montados son escribibles.
  • La imagen establece TZ=UTC. Los programas utilizan la timezone que pasa, así que esto no los afecta.

Invertir proxy

  • Establece APP_TRUSTED_PROXIES en el rango de direcciones de tu proxy para que el cliente pueda leer correctamente.
  • Permitir actualizaciones de WebSocket en /ws.
  • Aumenta el límite de cuerpo a al menos 100 MB (client_max_body_size 100m; en nginx).
  • Mantener los tiempos de espera de proxy por encima de 45 segundos de solicitud de GOWA.
  • Para implementaciones de sub-ruta use APP_BASE_PATH; /health permanece en la raíz.
Vea Installation para un ejemplo de nginx.

Monitoreo

  • Livedad: GET /health devuelve 200 OK cuando el proceso y el almacenamiento están arriba. No comprueba WhatsApp.
  • Conectividad de WhatsApp: encuesta GET /devices/{device_id}/status y alerta cuando is_logged_in es false.
  • Eventos: suscríbete a webhooks y alerta sobre el tráfico perdido para números ocupados.
  • Registros: recolecta el contenedor stdout; usa APP_DEBUG=true sólo mientras se resuelven problemas.
GOWA se conecta automáticamente al iniciar y comprueba las conexiones cada 5 minutos. Un dispositivo que cierra la sesión del teléfono debe estar emparejado de nuevo. GET /app/metrics devuelve métricas autenticadas de proceso, memoria, disco y dispositivo sin seleccionar un dispositivo. Ver métricas del servidor. Alerta en los webhooks device.logged_out, device.temporary_ban, y device.reachout_timelock.

Receptores Webhook

  • Responde 2xx en 10 segundos; el proceso funciona de forma asincrónica.
  • Deduplicar por dispositivo, tipo de evento y los identificadores del evento. Los identificadores de mensaje por sí solos no distinguen ediciones, reacciones o estados de recepción posteriores.
  • Después de 5 intentos fallidos, el evento ha sido soltado. Usa GET /chats y GET /chat/{jid}/messages para ponerte al día después de una interrupción.

Enviando higiene

  • Envía mensajes a las personas que optaron o escribieron primero.
  • Ritmo envía con retrasos y nervioso; evita idénticos textos a granel.
  • Detenga en WA_REACHOUT_TIMELOCK.
  • Mantenga WHATSAPP_ACCOUNT_VALIDATION=true para que los números no registrados fallen rápidamente.
  • WhatsApp permite hasta cuatro dispositivos de acompañamiento vinculados por cuenta, y desvincula a los compañeros después de unos 14 días si el teléfono se mantiene sin conexión.