项目导读已读公开仓库
Chatwoot Docker 自托管客服：网站收件箱部署步骤
得到一个可登录、能收网站测试消息并分派的 Chatwoot 收件箱。
适用场景客服消息分类、转人工与工单交接
按官方 Docker 指南启动 Chatwoot，为网站加客服收件箱和分派流程。它适合网站在线聊天与邮件等渠道，不含原生微信接入。
来源 · Chatwoot · Open-source walkthrough
背景 / 问题
Section titled “背景 / 问题”网站咨询散在邮箱和页面留言里，换人后容易漏跟进。Chatwoot 能把接入的对话放进团队收件箱；先用测试站点验证收发与分派。它没有内置微信渠道；需要微信时，可按官方 API channel 指南自建并测试接入。
- 准备一台单独的 Linux 测试机和 Docker Compose。Chatwoot 需要应用、PostgreSQL 与 Redis，部署前按官方要求准备资源。
- Chatwoot 主仓库中 enterprise/ 目录以外的代码采用 MIT；enterprise/ 目录另有许可证。商用前先核对自己启用的功能属于哪一部分及其许可条款。
图源：Chatwoot 官方入门教程的会话收件箱截图；示例账号与消息来自官方演示数据。
1. 按生产文档准备 Docker 文件
Section titled “1. 按生产文档准备 Docker 文件”从 Chatwoot 官方仓库取 .env.example 与 production compose 文件。改掉数据库与 Redis 默认密码，生成独立的 SECRET_KEY_BASE，别把 .env 公开。
2. 初始化后端再启动
Section titled “2. 初始化后端再启动”运行官方要求的 db:chatwoot_prepare，再用 docker compose up -d 启动。先在服务器本机检查 Rails API 返回 200，再把反向代理和 HTTPS 接上。
3. 加一个网站收件箱
Section titled “3. 加一个网站收件箱”在后台创建 Website inbox，把官方提供的 widget snippet 放进测试页；自己提交一条虚构咨询，确认它出现在收件箱并能分给测试客服。
4. 走一遍关闭与重开
Section titled “4. 走一遍关闭与重开”客服回复后从访客端再发一条消息，检查会话状态和负责人。确认应用、Postgres、Redis 都有备份与恢复办法，再考虑接真实网站。
得到一个可登录、能收网站测试消息并分派的 Chatwoot 收件箱。
- 测试访客消息进入正确 inbox。
- 不同客服能看见负责人和会话状态。
- HTTPS、强密钥、数据库与 Redis 备份已配置。