限制
HTTP 请求正文限制等于视频限制 (100 MB),所以上传不能超过它。 用
GET /app/info (max_image_size, max_file_size, max_video_size)查询实时值。这些限制是编译为默认值;它们没有环境变量。
提供媒体的两种方式
每个媒体端点接受一个多部分文件或 GOWA 获取服务器的 URL:处理中
GOWA 需要 FFmpeg 和 libwebp 在主机上(两者都在 Docker 图像中)。/send/file发送文件时没有转换。
解码前图像处理检查标题尺寸。接受时间最长的边缘是32,768像素。非JPEG图像的预算为4,000万像素。 JPEG拥有8 000万像素上限加上320 MB 十进制内存预算,所以一些较大的累进或CMYK JPEG被拒绝低于像素最高限额。 原始图像在解码超过预算时可以省略缩略图。交互旋转的旋转旋转图像在交互信息中具有分开的、较小的限制。
传入媒体
使用WHATSAPP_AUTO_DOWNLOAD_MEDIA=true (默认),GOWA 下载传入消息的媒体至statics/media/ 并将相对路径放入webhook payload:
http://<host>:3000/statics/media/<file> 获取文件。设置 WHATSAPP_IGNORE_STATUS_MEDIA=true 可跳过状态更新中的媒体。
在自动下载后,有效载荷带有WhatsApp CDN URL。通过 GOWA 下载,解密文件:
main 分支中,显式下载和转发操作可以请求手机重新上传已过期的媒体。手机必须在线且仍保留该文件。GOWA 最多等待 30 秒以获取响应。这也适用于 MCP 的 download_media 和 forward 操作,以及 Chatwoot 历史消息导入。
存储和清理
路径相对于进程的工作目录;从源码运行时通常为src/,在 Docker 中则为 /app。Compose 会将仓库中的 storages/ 和 statics/ 目录挂载到 /app 下。
目前没有按存储时长设置的媒体保留选项,也没有清理端点。同一张图片可能在
storages/ 和 statics/media/ 中各有一份副本。切勿为了回收媒体空间而删除整个 storages/ 目录。
暂停 GOWA 和其他作者,备份所需的文件,然后预览文件以移除。 此 GNU 找到从部署目录运行的示例,选择至少31天前的文件。
-print 替换为 -delete。请保留数据库文件、SQLite 的 -wal 和 -shm 辅助文件、定时任务的附件以及自定义文件。随后重启 GOWA。删除后的路径及其静态 URL 将无法访问,删除媒体也不会清除聊天记录。
WHATSAPP_AUTO_DOWNLOAD_MEDIA=false 会停止后续的自动下载和额外的图片副本生成。它不会删除旧文件,也不会阻止通过 REST 或 MCP 显式下载。参阅完整的媒体存储和清理指南。
/statics仍然是公开的。已保存的 HTML、SVG、脚本和其他文档都被用作application/octet-stream和nosniff的附件。 图像预览路径支持的图像字节可以内嵌。 这些内容保护并不限制谁可以下载文件。在反向代理上保护敏感媒体。
