Chaskiq Docker部署完整教程：生产环境配置指南

【免费下载链接】chaskiq A full featured Live Chat, Support & Marketing platform, alternative to Intercom, Drift, Crisp, etc ... 项目地址: https://gitcode.com/gh_mirrors/ch/chaskiq

Chaskiq是一款功能全面的实时聊天、支持和营销平台，可作为Intercom、Drift、Crisp等工具的替代方案。本教程将详细介绍如何使用Docker在生产环境中部署Chaskiq，帮助您快速搭建企业级客户沟通系统。

准备工作：环境与依赖检查

在开始部署前，请确保您的服务器满足以下要求：

• Docker Engine 20.10+
• Docker Compose 2.0+
• 至少2GB RAM和20GB可用磁盘空间
• Git工具

图：Chaskiq部署流程示意图

安装Docker环境

如果您的服务器尚未安装Docker，可以使用以下命令快速安装：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 安装Docker Compose
sudo apt install docker-compose-plugin -y

# 将当前用户添加到docker组
sudo usermod -aG docker $USER

步骤1：获取Chaskiq源代码

首先克隆官方仓库到您的服务器：

git clone https://gitcode.com/gh_mirrors/ch/chaskiq
cd chaskiq

步骤2：配置生产环境变量

创建环境变量配置文件：

cp .env.example .env.production

使用文本编辑器修改关键配置：

nano .env.production

需要重点配置的参数包括：

• SECRET_KEY_BASE：使用bundle exec rails secret生成
• DATABASE_URL：数据库连接地址
• REDIS_URL：Redis连接地址
• RAILS_ENV=production：设置生产环境
• DOMAIN：您的域名

步骤3：定制Docker Compose配置

Chaskiq提供了完整的Docker Compose配置文件docker-compose.yml，生产环境下建议做以下调整：

1. 修改image参数为生产镜像
2. 调整资源限制
3. 配置持久化存储
4. 设置适当的网络模式

核心服务包括：

• rails：主应用服务
• sidekiq：后台任务处理
• postgres：数据库服务
• redis：缓存和消息队列
• anycable：实时通讯服务

步骤4：构建与启动容器

使用以下命令构建并启动所有服务：

# 构建生产镜像
docker-compose -f docker-compose.yml build

# 启动服务
docker-compose -f docker-compose.yml up -d

首次启动需要执行数据库迁移：

docker-compose exec rails bundle exec rails db:migrate
docker-compose exec rails bundle exec rails db:seed

步骤5：配置Nginx反向代理

为了实现HTTPS和更好的性能，建议使用Nginx作为反向代理。创建Nginx配置文件：

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location /cable {
        proxy_pass http://localhost:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

步骤6：验证部署与基本操作

访问您的域名，应该能看到Chaskiq的登录界面。使用默认管理员账号登录：

• 用户名：admin@example.com
• 密码：password

首次登录后请立即修改密码并创建新用户。

图：Chaskiq管理界面欢迎页

生产环境优化建议

1. 资源配置：根据用户量调整容器资源限制
2. 备份策略：定期备份PostgreSQL数据库
3. 监控：添加Prometheus和Grafana监控容器状态
4. 日志管理：配置集中式日志收集
5. 自动更新：设置CI/CD流程实现自动部署

常见问题解决

1. 容器启动失败

检查日志定位问题：

docker-compose logs rails

2. 数据库连接问题

确保PostgreSQL服务正常运行并检查连接参数：

docker-compose exec postgres psql -U postgres

3. 静态资源加载失败

重新编译资产：

docker-compose exec rails bundle exec rails assets:precompile

总结

通过Docker部署Chaskiq可以极大简化安装流程并确保环境一致性。按照本指南操作，您可以在30分钟内完成生产环境的搭建。Chaskiq的模块化设计使其能够轻松扩展以满足不同规模企业的需求，无论是小型团队还是大型企业都能从中受益。

如需进一步定制或开发，请参考项目中的Dockerfile和docker-compose.yml文件进行高级配置。

【免费下载链接】chaskiq A full featured Live Chat, Support & Marketing platform, alternative to Intercom, Drift, Crisp, etc ... 项目地址: https://gitcode.com/gh_mirrors/ch/chaskiq