Chatwoot Docker镜像文档

镜像概述

Chatwoot Docker镜像是开源客户支持平台Chatwoot的容器化部署方案，旨在简化客户互动中心的构建与运维。该镜像封装了Chatwoot应用服务，支持通过单一容器或容器编排工具（如Docker Compose）快速部署，提供多渠道客户沟通、团队协作、数据管理等核心能力，适用于各类企业客户支持场景。

核心功能与特性

多渠道沟通整合

• 支持网站实时聊天、电子邮件、、 Messenger、***等主流沟通渠道
• 统一消息 inbox 管理，集中处理跨渠道客户咨询

团队协作工具

• 对话分配与转接，支持团队成员协作处理客户请求
• 内部备注功能，便于团队共享客户信息与处理思路
• SLA（服务等级协议）管理，监控响应时效

自动化与效率提升

• 预设回复与自动化规则，自动响应常见问题
• 聊天机器人集成，支持AI辅助客户服务
• 工作流自动化，简化重复性操作

客户数据与分析

• 客户资料管理，记录互动历史与偏好
• 实时报表与数据分析，跟踪客服效率与客户满意度
• 自定义仪表板，可视化关键指标

可扩展性与定制化

• 开放API与Webhook，支持与CRM、ERP等系统集成
• 自定义品牌样式，匹配企业视觉形象
• 支持多语言界面，适配全球化需求

使用场景与适用范围

适用团队与行业

• 中小企业客户支持团队
• 电商平台客服中心（处理订单咨询、售后问题）
• SaaS产品客户成功团队（用户引导、技术支持）
• 教育机构学生咨询服务
• 企业内部IT支持或HR服务

典型应用场景

• 构建7×24小时在线客服系统，提升客户响应速度
• 整合分散的客户沟通渠道，减少信息孤岛
• 通过数据分析优化客服流程，降低人力成本
• 基于客户互动数据优化产品或服务策略

使用方法与配置说明

前提条件

• Docker Engine 20.10+ 或 Docker Desktop
• Docker Compose（推荐，用于管理依赖服务）
• 至少2GB RAM与20GB磁盘空间
• 外部数据库（PostgreSQL 12+）与缓存服务（Redis 6+）

快速部署（Docker Compose）

1. 创建docker-compose.yml文件

version: '3'

services:
  web:
    image: chatwoot/chatwoot:latest
    restart: always
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://postgres:password@db:5432/chatwoot
      - REDIS_URL=redis://redis:6379/1
      - SECRET_KEY_BASE=your_secure_secret_key  # 生成命令: openssl rand -hex 64
      - FRONTEND_URL=http://localhost:3000
      - RAILS_ENV=production
      - SMTP_ADDRESS=smtp.example.com  # SMTP服务器地址
      - SMTP_PORT=587
      - SMTP_USERNAME=***
      - SMTP_PASSWORD=your_smtp_password
      - SMTP_DOMAIN=example.com
      - SMTP_AUTHENTICATION=plain
      - SMTP_ENABLE_STARTTLS_AUTO=true
    depends_on:
      - db
      - redis
    volumes:
      - chatwoot_data:/app/storage

  worker:
    image: chatwoot/chatwoot:latest
    restart: always
    command: bundle exec sidekiq -C config/sidekiq.yml
    environment:
      - DATABASE_URL=postgresql://postgres:password@db:5432/chatwoot
      - REDIS_URL=redis://redis:6379/1
      - SECRET_KEY_BASE=your_secure_secret_key
      - RAILS_ENV=production
    depends_on:
      - db
      - redis

  db:
    image: postgres:14-alpine
    restart: always
    environment:
      - POSTGRES_PASSWORD=password
      - POSTGRES_USER=postgres
      - POSTGRES_DB=chatwoot
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:6-alpine
    restart: always
    volumes:
      - redis_data:/data

volumes:
  chatwoot_data:
  postgres_data:
  redis_data:

2. 启动服务

# 生成安全密钥（替换配置中的your_secure_secret_key）
openssl rand -hex 64

# 启动所有服务
docker-compose up -d

# 初始化数据库（首次启动时）
docker-compose exec web bundle exec rails db:chatwoot_prepare

# 创建管理员账户
docker-compose exec web bundle exec rails c "User.create!(*** '***', password: 'your_secure_password', role: 'administrator')"

3. 访问服务

打开浏览器访问 http://localhost:3000，使用管理员账户登录并配置渠道、团队与自动化规则。

核心配置参数（环境变量）

数据持久化与备份

• 持久化卷：chatwoot_data卷存储上传文件、日志等；postgres_data与redis_data存储数据库与缓存数据，需定期备份
• 备份命令示例：

  # 备份PostgreSQL数据
  docker exec chatwoot_db_1 pg_dump -U postgres chatwoot > chatwoot_backup_$(date +%F).sql
  
  # 备份卷数据（需停止服务）
  cp -r /var/lib/docker/volumes/chatwoot_chatwoot_data/_data /path/to/backup/
  

注意事项

• 生产环境需配置HTTPS（建议使用Nginx反向代理配合Let's Encrypt）
• 定期更新镜像以获取安全补丁：docker-compose pull && docker-compose up -d
• 高并发场景需调整资源限制（如docker-compose.yml中添加deploy.resources配置）
• 详细文档参见 Chatwoot***文档