1.前言

项目地址：https://github.com/msgbyte/tailchat

官网：https://tailchat.msgbyte.com/zh-Hans/

文档：https://tailchat.msgbyte.com/zh-Hans/docs/intro

夜梦博客同步地址：https://tech.yemengstar.com/?p=4255

2.概述

Tailchat 是一款插件化易拓展的开源 IM 应用。可拓展架构赋予 Tailchat 无限可能性。

前端微内核架构 + 后端微服务架构 使得 Tailchat 能够驾驭任何定制化/私有化的场景

面向企业与私域用户打造，高度自由的群组管理与定制化的面板展示可以让私域主能够更好的展示自己的作品，管理用户，打造自己的品牌与圈子。

3.准备

3.1环境准备

夜梦这里使用的雨云服务器：https://www.rainyun.com/YeMeng_

使用此链接注册后，绑定微信可以获得五元优惠券，并且新购、续费、升级均享受95折优惠。

系统为Ubuntu22.04

3.2安装docker

你可以尝试使用

安装docker

如果不成功，可以这篇文章：https://tech.yemengstar.com/?p=536安装docker

3.3内存空间

建议最低配置 1核2G

如果只有1C1G，建议添加SWAP。

执行后选择18，进行swap添加。

4.应用部署

4.1拉取镜像

从公共镜像库拉取 tailchat镜像

将下载的镜像改名为tailchat(和源码编译保持一致，如果不改的话会走源码编译流程)

4.2配置应用

新建文件夹

创建配置文件

填入：

配置环境变量

修改 docker-compose.env 文件的配置，以下字段推荐修改:

• API_URL 对外可访问的url地址，用于文件服务访问, 可以是域名（如果设置了域名需要进行反向代理）也可以是ip。 如果出现发送图片不能正常显示就是这个变量没有设置

• SECRET 服务端加密秘钥，用于生成Token. 默认为 tailchat

4.3启动应用

确保配置文件(docker-compose.yml和docker-compose.env)在当前目录下，执行以下命令一键启动

访问 http://<server ip>:11000 即可打开tailchat

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

4.4注意事项

在docker-compose.env文件中提供了部分环境变量可供配置。

tailchat 的docker-compose.yml配置默认提供了如下配置:

• mongodb: 持久化数据库

• redis: KV数据库与消息中转服务

• minio: 分布式文件服务

其中持久化文件(数据库, 文件存储)通过 docker volume 统一管理

4.5部署管理后台（可选）

创建管理后台配置：

然后填入：

在环境变量 docker-compose.env 中设置管理后台的账号和密码:

修改：

然后启动应用:

注意先后顺序，因为admin.yml依赖docker-compose.yml所以要放在后面

此时访问后台地址后面追加/admin/即可访问:

https://tailchat.example.com/admin/ 或者 http://<server ip>:11000/admin/

注意不要忘记在最后有一个/

5.应用展示

登录界面

使用界面

后台界面