Docker部署Chatwoot只需10分钟内即可访问登录页；核心是用docker compose统一管理应用、数据库和缓存服务，需Ubuntu/CentOS系统、Docker≥20.10.7、Compose≥2.10，配置.env与docker-compose.yml后执行docker compose up -d启动。
用Docker部署Chatwoot其实很直接，核心是用docker-compose统一管理应用、数据库和缓存三个服务，整个过程10分钟内就能看到登录页。
环境与基础准备
确保服务器满足基本要求：Ubuntu 22.04/20.04 或 CentOS 7+，2GB内存起步；已安装 Docker（≥20.10.7）和 Docker Compose（≥2.10）。执行以下命令验证：
docker --version-
docker compose version（注意是docker compose，不是旧版docker-compose）
新建项目目录并进入：
mkdir -p ~/chatwoot && cd ~/chatwoot获取配置文件与初始化目录
官方提供开箱即用的生产级配置。直接下载两个关键文件：
- 环境变量模板：
wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example - Docker Compose 配置：
wget -O docker-compose.yml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml
创建挂载目录，保证数据持久化：
关键配置修改
打开.env文件，至少调整这几项：
-
SECRET_KEY_BASE：运行openssl rand -hex 64生成并填入 -
POSTGRES_PASSWORD：设一个强密码（如chatwoot123!），同时在docker-compose.yml中对应服务的environment下保持一致 -
FRONTEND_URL：填你将来访问的域名或IP，比如http://your-domain.com或http://192.168.1.100:3000（开发测试可用） -
MAILER_SENDER_EMAIL和邮件相关配置（SMTP地址、端口、账号密码等）——这步决定能否发注册邮件和通知，国内推荐用QQ邮箱或企业邮箱，注意开启SMTP并使用授权码
启动与验证
保存所有修改后，在项目根目录执行：
docker compose up -d等待约1–2分钟，运行 docker compose ps 查看状态，全部显示 healthy 即成功。访问 http://[你的服务器IP]:3000（默认映射3000端口），首次访问会自动跳转到管理员注册页。
若无法访问，请检查防火墙是否放行3000端口，云服务器还需确认安全组规则。
