跳转到主要内容
GOWA 部署和访问概述 GOWA 以单个二进制文件分发。REST API、Webhook、仪表板和 MCP 端点均通过 whatsapp rest 启动。

B. 所需经费

支持的平台:Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL 推荐)。

停靠栏

图片已发布到 Docker Hub 和 GHCR:
  • aldinokemal2104/go-whatsapp-web-multidevice
  • ghcr.io/aldinokemal/go-whatsapp-web-multidevice
  • /app/storages 持有SQLite 数据库 (会话、 聊天历史、 schedules, OAuth)。每个设备都丢失它。
  • /app/statics持有QR图像、上传和下载的媒体。
  • 默认命令为 rest。请在它之后传递标志,例如 ... go-whatsapp-web-multidevice rest --autoreply="Away"。
  • 切入点修正音量所有权,并将权限移至gowauser (UID 20001, GID 20000)。
  • 容器时间是 UTC (TZ=UTC)。如果你需要本地日志时间戳,则覆盖TZ。

Docker 配置

docker-compose.yml
使用 openssl rand -hex 32 生成稳定的 webhook 密钥,并在你的 shell 或 Compose .env 中设置WHATSAPP_WEBHOOK_SECRET ,然后再开始这个例子。 这个仓库自己的docker-compose.yml可以从 docker/golang.Dockerfile 构建图像并读取src/.env。当你想要本地构建时使用它:cp src/.env.example src/.env && docker compose up -d --build。

释放二进制文件

从 GitHub Releases 下载压缩包。压缩包的命名格式为 whatsapp_<version>_<os>_<arch>.zip,例如:
在主机上安装媒体工具:
使用同一版本的 checksums.txt 验证下载;./whatsapp version 打印版本;./whatsapp --help 列出每个标记。

从来源

在 macOS 上,构建前还需执行 export CGO_CFLAGS_ALLOW="-Xpreprocessor"。

没有C工具链的ARM

purego 构建标签选择了一个 pure-Go SQLite 驱动程序,所以您可以使用 CGO 交叉编译:

存储

默认情况下,所有都是 storages/下的 SQLite : DB_URI 也接受 PostgreSQL 语句,例如postgres://user:pass@host:5432/gowa?sslmode=verify-full 。远程PostgreSQL 会话保存默认证书验证时未设置有效的 TLS 模式。 明确的 URI、环境或 PostgreSQL 服务 TLS 设置仍然适用。请参阅存储配置。 GOWA 创建 SQLite 文件,拥有所有者唯一的 0600 权限和新的 0700 父目录。现有目录保留其权限。 备份storages/ (或PostgreSQL加storages/)以在重建过程中保持配对的设备。将这些备份作为凭据处理。

反向代理

通过 APP_BASE_PATH 服务到 GOWA 的子路径,并且信任代理的转发信头和APP_TRUSTED_PROXIES:
/health 停留在根目录下(/health ,而不是/gowa/health ),所以不论基础路径,都可以工作。 浏览器来源防护需要获取公共主机信息。请按上文所示保留 Host,或通过受信任的代理发送 X-Forwarded-Host。单独托管的仪表板需要在 APP_TRUSTED_ORIGINS 或 APP_CORS_ALLOWED_ORIGINS 中配置其确切来源。通配符不会授权更改状态的操作或 WebSocket 连接。请通过 HTTP 或 HTTPS 提供仪表板,因为 file:// 页面的来源为不受信任的 null。 默认监听器拒绝在没有完整基本认证凭据的情况下启动。 只有当代理认证来电者和客户端无法绕过时,才启用APP_ALLOW_UNAUTHENTICATED=true。对于没有认证的本地开发,绑定APP_HOST=127.0.0.1。

验证

存储初始化完成后,/health 会返回 OK。它不会报告是否有 WhatsApp 账号已连接;如需查看连接状态,请使用 GET /devices/{device_id}/status。

升级

备份 storages/,拉取新镜像或二进制文件,然后重启。请先阅读发行说明,了解不兼容的变更。值得注意的变更包括:v6 强制要求使用 rest 子命令;v7 将二进制文件移至 GoReleaser 归档文件中;v8 增加了多设备支持(一旦存在多个设备,针对设备的调用就需要 X-Device-Id);独立的 whatsapp mcp 模式(:8080/sse)已被 REST 服务器上的 /mcp 端点取代。