跳转到主要内容

安全

  • 设置APP_BASIC_AUTH 有长长的随机密码。一个非循环绑定需要凭据,除非APP_ALLOW_UNAUTHENTICATED=true 明确禁用此检查。 循环可以在没有凭据的情况下运行,用于本地发展。
  • 明确设置 WHATSAPP_WEBHOOK_SECRET 。 没有它,GOWA将生成一个随机的键值,在重启时会更改。 在原请求正文上验证 X-Hub-Signature-256 。启用出站Webhook TLS 验证。
  • 在逆向代理中终止TLS ; GOWA本身说纯HTTP。
  • 限制/statics. 在/statics/*下下载的二维码和媒体传输没有基本认证**。 如果介质具有敏感性,并定期修剪statics/media,请阻止或保护代理路径。
  • 启用 Chatwoot 时,请勿在未设置 CHATWOOT_WEBHOOK_SECRET 的情况下公开 /chatwoot/webhook。
  • 如果浏览器直接调用 API,请设置 APP_CORS_ALLOWED_ORIGINS;通配符 CORS 不会授权浏览器写入操作或 /ws。请在 APP_TRUSTED_ORIGINS 或 CORS 允许列表中配置具体来源。参阅身份验证。
  • 私人绑定 (APP_HOST=127.0.0.1 或私人网络) 只有本地服务需要访问。
  • Rate-limit 登录失败。GOWA 没有内置的 rate limiting。

存储和备份

  • 如果你想要管理的备份,使用 PostgreSQL 进行DB_URI;聊天存储总是SQLite。
  • 在 GOWA 停止时备份,或使用数据库的在线备份工具。
  • 存储备份加密:会话数据库等于登录帐户。
  • 每个存储运行一个 GOWA 实例。 两个共享会话过程导致断开连接和冲突。GOWA不支持水平缩放。

停靠栏

  • 固定使用某个版本标签,而非 latest,并在升级前阅读发行说明。
  • 容器运行为非根用户 (UID 20001);请确保挂载的卷是可写的。
  • 图像设置 TZ=UTC。计划使用您通过的 timezone ,因此这不会影响他们。

反转代理

  • 设置APP_TRUSTED_PROXIES 到您代理的地址范围,因此客户端IP是正确的。
  • 允许 /ws 上的 WebSocket 协议升级。
  • 将物体限制提高到至少 100 MB (client_max_body_size 100m; in nginx)。
  • 将代理超时时间保持在 GOWA 的45秒请求超时。
  • 对于子路径部署,使用 APP_BASE_PATH; /health 仍然是根目录下。
请参阅 Installation for an nginx 示例。

监测

  • Liveness: GET /health 返回200 OK 当过程和存储完成时。它不检查 WhatsApp。
  • **WhatsApp 连接状态:**轮询 GET /devices/{device_id}/status,并在 is_logged_in 为 false 时发出告警。
  • Events: 订阅网络钩子和对流失流量的警报。
  • 日志: 收集容器标准输出;只有在故障排除时才使用 APP_DEBUG=true 。
GOWA 在启动时自动重新连接,每5分钟检查连接。从手机上注销的设备必须重新配对。 GET /app/metrics 无需选择设备,即可在通过身份验证后返回进程、内存、磁盘和设备指标。参见服务器指标。为 device.logged_out、device.temporary_ban 和 device.reachout_timelock webhook 配置告警。

Webhook 接收器

  • 在 10 秒内响应2xx ;处理异步操作。
  • 按设备、 事件类型和事件标识符进行编程。仅消息ID不区分编辑、反应或稍后接收状态。
  • 尝试失败 5 次后,事件会被丢弃。故障恢复后,使用 GET /chats 和 GET /chat/{jid}/messages 补取消息。

传送个人卫生

  • 首先给选择或写下消息的人发送消息。
  • Pace 发送时有延迟和干扰;避免相同的批量文本。
  • 在WA_REACHOUT_TIMELOCK上停止.
  • 保留WHATSAPP_ACCOUNT_VALIDATION=true,所以未注册的数字会快速失效。
  • WhatsApp 每个帐户最多允许四个关联的配套设备,如果手机处于离线状态,请在大约14天后取消链接。