安全
- 设置
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仍然是根目录下。
监测
- Liveness:
GET /health返回200 OK当过程和存储完成时。它不检查 WhatsApp。 - **WhatsApp 连接状态:**轮询
GET /devices/{device_id}/status,并在is_logged_in为false时发出告警。 - Events: 订阅网络钩子和对流失流量的警报。
- 日志: 收集容器标准输出;只有在故障排除时才使用
APP_DEBUG=true。
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天后取消链接。
