自托管 WATeamInbox,意味着把 Web 应用、数据服务和 WhatsApp 连接 worker 运行在由你的团队掌控的基础设施上。
本文介绍部署前后需要做的决定和检查。如需最新的命令和配置,请参考自托管文档以及 GitHub 仓库中的文件。
先判断你的团队是否适合自己运维
如果团队里有人熟悉 Linux、Docker、数据库、TLS、备份和日常更新,自托管是个合理的选择。它可以让应用和客户对话数据留在你自己管理的环境中。
如果服务停止、磁盘写满或迁移失败时没有人能及时处理,自托管就不太合适。这种情况下,WATeamInbox Cloud 可能更省心,因为应用整套环境由我们来运维。
了解涉及的服务
当前的生产基线包括:
- Web 收件箱
- 位于内部、支持就绪检查的 HAProxy 路由器之后的 API(可选配同构的 API 副本)
- 用于应用数据和搜索的 PostgreSQL
- 用于命令和事件的 NATS
- 用于收件箱实时更新的 Centrifugo
- WhatsApp worker 与编排器(orchestrator)进程
- 通过其账户的 S3 API 端点使用私有 Cloudflare R2 存放媒体文件
- 负责 HTTPS 和边缘路由的 Caddy
在运行开发环境之前,你不必成为每个服务的专家。但你需要知道每个服务把数据存在哪里、哪些端口应保持私有,以及如何发现故障。
先阅读 WhatsApp 风险提示
WATeamInbox 使用的是非官方的 WhatsApp 客户端库。WhatsApp 可能更改其协议或政策,配对可能失效,账号也可能被限制。WATeamInbox 无法保证账号安全,也与 WhatsApp 或 Meta 没有任何关联。
首次部署时,请尽量使用一个不重要的号码。在你的团队测试过连接恢复并商定好备用流程之前,不要迁移重要的客户号码。
写下数据将存放在哪里
在创建服务器之前,请先确定:
- PostgreSQL 数据存放在哪里
- 图片、文档和语音消息使用哪种对象存储
- 备份复制到哪里
- 谁可以管理主机
- 密钥如何创建、保存和轮换
- 日志和客户数据保留多久
请不要把数据库、NATS、搜索和对象存储的管理端口暴露到公网。Web 入口应使用 HTTPS。
分阶段上线
1. 先在本地运行
从仓库里的开发环境配置开始。创建一个工作区,邀请另一位用户,并跟踪一条消息从 WhatsApp 到 Web 收件箱的完整过程。
本地 Compose 配置使用的是开发用凭据,并且开放了端口。请不要把它当作生产配置。
2. 搭建预发布服务器
在一台小型、不重要的服务器上,使用文档中的单主机生产基线。配置真实的密钥文件、TLS、持久化卷和备份目标。
在邀请团队之前,请确认你能够:
- 运行数据库迁移
- 配对并重新连接一个 WhatsApp 号码
- 发送并接收一条测试消息
- 打开受支持的媒体文件
- 在两位用户之间分配对话
- 通过角色和权限限制操作
- 在一个干净的系统上恢复数据库和媒体引用
3. 让两三位队友试运行
让一小批对话在收件箱里流转。商定由谁关注未分配的消息、客服何时分配对话,以及哪些信息应写进内部备注。
试运行期间请持续观察各项服务。检查磁盘增长、备份大小、worker 重启次数和搜索表现,而不是等客户来反馈问题。
4. 为主号码做准备
如果你决定迁移重要号码,请规划好切换时间,并记下如何退回到原来的流程。保留最新的备份,并确保团队知道 WhatsApp 连接中断时该联系谁。
消息和媒体都要备份
如果客户文档和语音消息是单独存放的,只备份数据库是不够的。请按你的团队能承受的数据丢失量来确定频率,同时备份 PostgreSQL 和对象存储。
把它们一起恢复到另一台机器上,确认用户、对话、分配和媒体仍能正常加载。恢复测试是证明备份有用的唯一可靠方式。
上线前检查访问权限
给每位队友单独的账号。所有者和管理员角色只留给需要管理连接、成员、设置和导出的人。
也要检查主机层面的访问权限。产品内的权限无法保护数据免受持有宽泛数据库、对象存储或服务器凭据的人的影响。
上线最低检查清单
在依赖这套部署之前,请确认:
- 生产域名上的 HTTPS 正常工作
- 只有预期的端口对外开放
- 每位队友都使用个人账号登录
- worker 重启后 WhatsApp 连接能够恢复
- 分配和备注在交接后依然保留
- 受支持的媒体文件可以正常显示
- 备份在主机之外运行
- 已在干净的系统上成功完成一次恢复
- 有人会收到服务或存储故障的告警
- 当 WhatsApp 连接不可用时,团队有备用方案
公开的部署指南是单主机基线。它可以为了进程和发布层面的韧性运行多个 API 进程,但并不是高可用或多区域架构,因此请据此设定预期。编排器仍然是单例。
当这些检查成为日常习惯后,请继续按照自托管文档中的命令和配置操作。如果运维这套服务的负担超出了团队的意愿,请对比当前的 Cloud 套餐。