Evolution API
evolution-foundation/evolution-apiAI 已审核
RepoPicks Radar 检查于
Evolution API 是什么?
Evolution API 是一个介于 WhatsApp 和你其他工具之间的服务器。你可以连接一个 WhatsApp 号码(通过非官方的 Baileys 方式扫码,或使用 Meta 官方的 Cloud API),然后通过 REST API 收发消息,并已经预置了与 Typebot、Chatwoot、n8n、Dify、OpenAI、RabbitMQ、Kafka 和 S3 的连接。它是为开发者和代理商设计的:你需要一台安装了 Node.js 20+、PostgreSQL 或 MySQL,最好还有 Redis 的服务器,或者使用仓库里提供的 Docker Compose 文件。
Evolution API 免费开源(Apache-2.0),可以替代 ManyChat、Twilio WhatsApp API和Chatfuel。
Evolution API 安装有多容易?
D · 终端、多个工具或特定显卡 · Windows
- Windows D
- macOS D
- Linux D
Linux 服务器是常见的运行环境,评级依然是 D:没有安装程序,你需要克隆仓库、填写一份很长的 .env 文件、准备 PostgreSQL 或 MySQL 以及 Redis、运行数据库迁移,然后用 Docker Compose 或 Node.js 启动它。Mac 和 Windows 也是在终端里运行同样的技术栈(package.json 里甚至专门有 Windows 的迁移脚本),所以也不会更简单。
即将推出:用 RepoPicks 应用一键安装。
Evolution API 的 GitHub 数据
- 星标
- 10,0832026年11月10日
- 下载量
- —所有发布版本
- 增长
- +496 天内新增星标
星标变化
事实
- 可运行于
- Windows, macOS, Linux
- 需要安装
- Node.js, Docker, FFmpeg
- 从源码编译需要
- Node.js, Docker, FFmpeg
- 磁盘空间
- 100 MB–500 MB · 估算
- 账号或密钥
- Meta WhatsApp Cloud API (only for the official route), OpenAI (optional, for voice-to-text and AI replies), Pusher (optional, for events)
- 费用
- 免费 · 代码本身是免费的,但 LICENSE 文件附加了条件:必须保留标志,并显示一条说明表示正在使用 Evolution API,否则就需要购买商业许可。Meta 官方的 Cloud API 按消息计费,OpenAI 和 Pusher 的连接也是付费服务。
- 许可证
- Apache-2.0 (宽松型)
- 可以替代
- ManyChat, WhatsApp API, Chatfuel
- GitHub 上的最近改动
- 2026年5月6日
Evolution API 的风险信号 (7)
- 注意依赖存在已知漏洞
锁定的依赖中存在已知漏洞(OSV):baileys: GHSA-qvv5-jq5g-4cgg
自动检查
- 注意非官方的 WhatsApp 访问方式会让号码面临风险
README 写道:“WhatsApp API - Baileys: A free API based on WhatsApp Web, leveraging the Baileys library... this method relies on the web version of WhatsApp and may have limitations compared to official APIs”。这条路径没有得到 Meta 的授权:用这种方式让一个普通账号自动化运作违反了 WhatsApp 的条款,号码可能被封。批量发送还可能违反当地的营销和消费者保护规定。
AI 审核
- 注意许可证在 Apache 之外附加了额外条件
GitHub 把这个许可证标记为 NOASSERTION(无法判定),LICENSE 文件解释了原因:“Apache License 2.0, with the following additional conditions... you may not remove or modify the LOGO or copyright information”,以及“the user is required to display a clear notification within the system that Evolution API is being utilized. Failure to comply with this requirement may result in the necessity for a commercial license”。
AI 审核
- 注意存储他人的消息和联系人
.env.example 默认开启了全部保存:DATABASE_SAVE_DATA_NEW_MESSAGE=true、DATABASE_SAVE_DATA_CONTACTS=true、DATABASE_SAVE_DATA_CHATS=true、DATABASE_SAVE_DATA_HISTORIC=true。你的数据库最终会保存客户的对话内容和电话号码,这会让你承担隐私方面的责任(如 LGPD、GDPR)。
AI 审核
- 注意默认开启了遥测功能
.env.example 默认写的是 TELEMETRY_ENABLED=true,README 说它会“collects anonymous telemetry data (routes used, most accessed routes, API version)”。除非你自己把它设为 false,否则它会把数据回传给项目方。
AI 审核
- 信息默认设置是开放的
.env.example 把 CORS_ORIGIN 设为 *(任何网站都可以从浏览器调用这个 API),docker-compose.dev.yaml 会把 8080 端口暴露在所有网络接口上,而 docker-compose.yaml 则只绑定到 127.0.0.1。除非你自己加上,否则它前面没有 HTTPS。
AI 审核
- 信息开发放缓,最新版本只是预览版
检测记录显示,最后一次提交是在 2026-05-06(距本次分析 182 天前),最新发布是在 2026-05-17。最新的两个版本 2.4.0-rc2 和 2.4.0-rc1 都标记为候选发布版;上一个稳定版本是 2025-12-05 发布的 2.3.7。
AI 审核
证据以原始语言显示。
Radar 无法验证的 Evolution API 相关内容
- 非官方的 WhatsApp Web 方式现在是否还能用,因为 Meta 会不断调整,库也必须跟着更新。
- 在实际使用中,号码被封的可能性有多大。
- 发布的 Docker 镜像是否与这个仓库里的代码一致。
- 按照你的消息量,Meta 的 Cloud API 和 OpenAI 连接大概要花多少钱。
- 被标记为存在漏洞的 baileys 库版本,实际上是否会影响你的部署。