Tailchat项目Docker Compose部署指南

前言

Tailchat是一款开源的即时通讯解决方案，采用现代化的技术栈构建。本文将详细介绍如何使用Docker Compose部署Tailchat项目，帮助开发者快速搭建自己的即时通讯平台。

系统要求

推荐配置

• 最低配置: 1核CPU + 2GB内存
• 推荐配置: 2核CPU + 4GB内存

对于只有1核1GB内存的服务器，可以通过创建交换分区来扩展内存空间。内存使用情况可参考下图：

环境准备

Docker环境安装

在开始部署前，请确保系统已安装以下组件：

• Docker引擎
• Docker Compose工具

如果尚未安装，可以参考Docker官方文档完成安装。

镜像获取方式

Tailchat提供了多种获取Docker镜像的方式，用户可根据自身需求选择：

1. 使用CLI工具一键安装（推荐）

此方式需要服务器已安装Node.js环境（建议版本16+）：

npx tailchat-cli docker update

该命令会自动拉取最新的Tailchat镜像。

2. 从公共镜像仓库手动拉取

docker pull moonrailgun/tailchat
docker tag moonrailgun/tailchat tailchat

3. 从源代码编译（高级用户）

此方式适合需要自定义修改或获取最新功能的用户：

1. 安装Node.js和pnpm包管理器
2. 克隆Tailchat仓库
3. 执行编译命令：

cd tailchat && docker compose build

编译过程对服务器配置有一定要求，2核4G配置下约需10分钟

项目配置与启动

配置方式选择

使用CLI工具配置（推荐）

npx tailchat-cli docker init

该命令会以交互方式引导用户完成配置，自动生成所需文件。

手动配置

1. 下载配置文件：

mkdir tailchat && cd tailchat
wget https://raw.githubusercontent.com/msgbyte/tailchat/master/docker-compose.yml
wget https://raw.githubusercontent.com/msgbyte/tailchat/master/docker-compose.env

2. 修改docker-compose.env文件中的关键配置：

• API_URL: 外部可访问的URL地址（用于文件服务）
• SECRET: 服务器端加密密钥（用于生成Token）

启动项目

完成配置后，执行以下命令启动所有服务：

docker compose up -d

服务启动后，可通过http://<服务器IP>:11000访问Tailchat。

注意：部分云服务可能需要手动开放防火墙端口

服务架构说明

Tailchat的Docker Compose配置默认包含以下服务：

1. mongodb: 持久化数据库服务
2. redis: KV存储和消息传输服务
3. minio: 分布式文件存储服务

所有持久化数据（数据库、文件存储）均通过Docker Volume管理：

docker volume ls | grep "tailchat-server"

环境变量详解

Tailchat支持通过环境变量进行丰富配置，完整的环境变量列表可参考项目文档中的环境变量章节。

进阶部署选项

1. HTTPS网关配置: 为Tailchat添加SSL证书支持
2. 管理平台部署: 部署Tailchat管理后台

常见问题

1. 图片无法显示: 检查API_URL环境变量是否配置正确
2. 性能优化: 对于小内存服务器，建议配置交换分区
3. 端口冲突: 可根据需要修改docker-compose.yml中的端口映射

通过以上步骤，您应该已经成功部署了Tailchat项目。如需进一步定制或扩展，可以参考项目的详细文档或社区讨论。