francisbreit/chatwoot-n Docker Image Overview

francisbreit/chatwoot-n

francisbreit

Chatwoot是一款开源客户支持平台Docker镜像，用于快速部署多渠道客户互动中心，整合网站聊天、邮件、社交媒体等沟通方式，支持团队协作与客户关系管理，助力企业高效处理客户咨询。

3 收藏0 次下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

中文简介版本下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

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`文件

yaml
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. 启动服务

bash
# 生成安全密钥（替换配置中的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，使用管理员账户登录并配置渠道、团队与自动化规则。

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

变量名	说明	默认值/示例
`DATABASE_URL`	PostgreSQL数据库连接URL	`postgresql://user:pass@host:5432/db`
`REDIS_URL`	Redis缓存服务连接URL	`redis://host:6379/1`
`SECRET_KEY_BASE`	应用加密密钥（必须自定义）	生成命令：`openssl rand -hex 64`
`FRONTEND_URL`	前端访问URL（用于回调与通知）	`http://localhost:3000`
`RAILS_ENV`	运行环境	`production`（生产环境）
`SMTP_*`	SMTP邮件配置（如`SMTP_HOST`、`SMTP_PORT`）	需根据邮件服务商填写
`DEFAULT_LOCALE`	默认界面语言	`en`（支持`zh-CN`等多语言）
`MAX_BODY_SIZE`	请求体大小限制（MB）	`10`

数据持久化与备份

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

备份命令示例：

bash
# 备份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/