> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 生产最佳做法

> 在生产中安全运行GOWA：安全、储存、备份、逆向代理、监测和传送卫生。

## 安全

* **设置`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 允许列表中配置具体来源。参阅[身份验证](https://gowa-docs.mintlify.site/zh/api-reference/authentication.md)。
* **私人绑定** (`APP_HOST=127.0.0.1` 或私人网络) 只有本地服务需要访问。
* Rate-limit 登录失败。GOWA 没有内置的 [rate limiting](https://gowa-docs.mintlify.site/zh/advanced/rate-limiting.md)。

## 存储和备份

| 路径 | 目录 | 备份？ |
| - | - | - |
| `storages/whatsapp.db` (or `DB_URI`) | WhatsApp 会话和密钥 | 是的，丢失意味着重新配对每个设备。 |
| `storages/chatstorage.db` | 聊天、短信、日程表和其他GOWA状态 | 否 |
| `storages/oauth.db` | MCP OAuth 客户端和令牌哈希值 | 如果使用 OAuth |
| `statics/` | 二维码、下载和排定的媒体 | 可选的 |

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

## 停靠栏

```bash theme={null}
docker run -d --name gowa --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v gowa-storages:/app/storages \
  -v gowa-statics:/app/statics \
  -e APP_BASIC_AUTH=admin:a-long-random-password \
  -e WHATSAPP_WEBHOOK=https://example.com/wa-hook \
  -e WHATSAPP_WEBHOOK_SECRET=another-long-random-secret \
  aldinokemal2104/go-whatsapp-web-multidevice:v9.9.0 rest
```

* 固定使用某个版本标签，而非 `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](https://gowa-docs.mintlify.site/zh/installation.md#%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86) 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` 无需选择设备，即可在通过身份验证后返回进程、内存、磁盘和设备指标。参见[服务器指标](https://gowa-docs.mintlify.site/zh/api-reference/metrics.md)。为 `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天后取消链接。


## Related topics

- [获取服务器健康度量表](https://gowa-docs.mintlify.site/zh/api-reference/app/获取服务器健康度量表.md)
- [正在接收消息](https://gowa-docs.mintlify.site/zh/examples/receiving-messages.md)
- [会话和连接生命周期](https://gowa-docs.mintlify.site/zh/concepts/sessions.md)
- [配置引用](https://gowa-docs.mintlify.site/zh/configuration.md)
- [Webhooks](https://gowa-docs.mintlify.site/zh/concepts/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.