
whatsapp rest 启动。
B. 所需经费
支持的平台:Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL 推荐)。
停靠栏
图片已发布到 Docker Hub 和 GHCR:aldinokemal2104/go-whatsapp-web-multideviceghcr.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 列出每个标记。
从来源
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 端点取代。