Seguridad
- Establece
APP_BASIC_AUTHcon una contraseña aleatoria larga. Un enlace no-loopback requiere credenciales a menos queAPP_ALLOW_UNAUTHENTICATED=truedeshabilite 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. VerifiqueX-Hub-Signature-256sobre 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 limpiastatics/mediaregularmente. - No exponga
/chatwoot/webhooksinCHATWOOT_WEBHOOK_SECRETcuando Chatwoot esté habilitado. - Establece
APP_CORS_ALLOWED_ORIGINSsi los navegadores llaman directamente a la API; comodín CORS no autoriza escrituras del navegador o/ws. Configure los orígenes específicos enAPP_TRUSTED_ORIGINSo la lista permitida CORS. Vea Authentication. - Vincula privadamente (
APP_HOST=127.0.0.1o 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_URIsi 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 latimezoneque pasa, así que esto no los afecta.
Invertir proxy
- Establece
APP_TRUSTED_PROXIESen 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;/healthpermanece en la raíz.
Monitoreo
- Livedad:
GET /healthdevuelve200 OKcuando el proceso y el almacenamiento están arriba. No comprueba WhatsApp. - Conectividad de WhatsApp: encuesta
GET /devices/{device_id}/statusy alerta cuandois_logged_inesfalse. - Eventos: suscríbete a webhooks y alerta sobre el tráfico perdido para números ocupados.
- Registros: recolecta el contenedor stdout; usa
APP_DEBUG=truesólo mientras se resuelven problemas.
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
2xxen 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 /chatsyGET /chat/{jid}/messagespara 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=truepara 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.
