这周和大家分享一个开源的即时聊天项目。也是作者@moonrailgun强烈推荐咕咕用的。
【资料图】
PS:作者目前就职于字节的飞书团队担任前端工程师
ministar
的微内核架构)- 自定义主题- 自定义面板- 自定义操作- 消息内容转换- ...
后端插件系统(基于moleculer
的微服务架构)开放平台Connect ID(其他正在开发中)快速跳转Tailchat 的设计之处就是以插件化的架构来满足不同人群对于不同需求的实现。
咕咕的Demo:https://chat.gugu.ovh/
文档:https://tailchat.msgbyte.com/
GitHub源码:https://github.com/msgbyte/tailchat
作者博客:https://www.moonrailgun.com/about/
这边直接丢出搭建的docker-compose.yaml文件,熟悉docker环境的小伙伴可以直接拷贝搭建。(环境变量可以自行参考文档按需修改)
version: "3.3"services: # 应用网关 service-gateway: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/gateway PORT: 3000 depends_on: - mongo - redis labels: - "traefik.enable=true" - "traefik.http.routers.api-gw.rule=PathPrefix(`/`)" - "traefik.http.services.api-gw.loadbalancer.server.port=3000" networks: - internal # 用户服务 service-user: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/user/* depends_on: - mongo - redis networks: - internal # 群组服务 service-group: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/group/* depends_on: - mongo - redis networks: - internal # 聊天服务 service-chat: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/chat/* depends_on: - mongo - redis networks: - internal # 文件服务 / 插件注册中心 / 配置服务 service-file: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/file,core/plugin/registry,core/config depends_on: - mongo - redis - minio networks: - internal service-openapi: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: openapi/app,openapi/oidc/oidc OPENAPI_PORT: 3003 OPENAPI_UNDER_PROXY: "true" depends_on: - mongo - redis - minio labels: - "traefik.enable=true" - "traefik.http.routers.openapi-oidc.rule=PathPrefix(`/open`)" - "traefik.http.services.openapi-oidc.loadbalancer.server.port=3003" networks: - internal # 插件服务(所有插件) service-all-plugins: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICEDIR: plugins depends_on: - mongo - redis - minio networks: - internal # 数据库 mongo: image: mongo:4 restart: on-failure volumes: - ./data:/data/db networks: - internal # 数据缓存与中转通讯 redis: image: redis:alpine restart: on-failure networks: - internal # 存储服务 minio: image: minio/minio restart: on-failure networks: - internal environment: MINIO_ROOT_USER: tailchat MINIO_ROOT_PASSWORD: com.msgbyte.tailchat volumes: - ./storage:/data command: minio server /data --console-address ":9001" # 路由转发 traefik: image: traefik:v2.1 restart: unless-stopped command: - "--api.insecure=true" # Don"t do that in production! - "--providers.docker=true" - "--providers.docker.exposedbydefault=false" - "--entryPoints.web.address=:80" - "--entryPoints.web.forwardedHeaders.insecure" # Not good ports: - 8080:80 # 8080可以改成自己服务器上没有被占用的端口 - 127.0.0.1:11001:8080 #同上 volumes: - /var/run/docker.sock:/var/run/docker.sock:ro networks: - internal - defaultnetworks: internal: name: tailchat-internal
以下是详细搭建教程。
服务器要求:此项目最好用1核2G以上的VPS,硬盘越大越好。
YouTube:https://youtu.be/PEIbrbp3QMs
哔哩哔哩【高清版本可以点击去吐槽到B站观看】:
腾讯云轻量服务器最大的特点就是“轻量”,相比CVM,更适合小白上手,这边我们之间选择Docker基础镜像,就可以省去后面安装Docker的步骤(如果你非要用国内的服务器,这边装的Docker镜像还会帮你配置好国内镜像源,让你加速访问docker镜像资源)。
服务器初始设置,参考:
新买了一台服务器“必须”要做的6件小事
保护好你的小鸡!保姆级服务器安全教程!
这边由于我们用的是腾讯云轻量应用服务器,系统默认就帮我们创建了名字是lighthouse
的用户,系统后台也有防火墙(默认就开了几个常用的端口)
对小白用户来说,可以不用再去管繁琐的服务器安全的配置,大大降低了服务器防护的门槛。
【Docker系列】不用宝塔面板,小白一样可以玩转VPS服务器!
sudo -i # 切换到root用户apt update -y # 升级packagesapt install wget curl sudo vim git -y # Debian系统比较干净,安装常用的软件
注意:VPS的内存如果过小,建议设置一下SWAP,一般为内存的1-1.5倍即可,可以让系统运行更流畅!
设置SWAP可以用脚本:
wget -O box.sh https://raw.githubusercontent.com/BlueSkyXN/SKY-BOX/main/box.sh && chmod +x box.sh && clear && ./box.sh
选择18
,然后输入你想要扩容的数值即可。
使用腾讯云轻量应用服务器的小伙伴可以直接跳到5.2.4
wget -qO- get.docker.com | bash
docker -v #查看docker版本
systemctl enable docker # 设置开机自动启动
修改Docker配置(可选)(来自烧饼博客)
以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):
cat > /etc/docker/daemon.json <
然后重启 Docker 服务:
systemctl restart docker
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version #查看docker-compose版本
curl -sSL https://get.daocloud.io/docker | sh
docker -v #查看docker版本
systemctl enable docker # 设置开机自动启动
修改Docker配置(可选)(来自烧饼博客)
以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):
cat > /etc/docker/daemon.json <
然后重启 Docker 服务:
systemctl restart docker
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.1.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-composechmod +x /usr/local/bin/docker-composedocker-compose --version #查看docker-compose版本
参考这边的内容:https://blog.laoda.de/archives/nginxproxymanager
创建一下安装的目录:
sudo -imkdir -p /root/data/docker_data/tailchatcd /root/data/docker_data/tailchat
这边我们直接用docker的方式安装。
vim docker-compose.yml
英文输入法下,按i
version: "3.3"services: # 应用网关 service-gateway: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/gateway PORT: 3000 depends_on: - mongo - redis labels: - "traefik.enable=true" - "traefik.http.routers.api-gw.rule=PathPrefix(`/`)" - "traefik.http.services.api-gw.loadbalancer.server.port=3000" networks: - internal # 用户服务 service-user: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/user/* depends_on: - mongo - redis networks: - internal # 群组服务 service-group: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/group/* depends_on: - mongo - redis networks: - internal # 聊天服务 service-chat: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/chat/* depends_on: - mongo - redis networks: - internal # 文件服务 / 插件注册中心 / 配置服务 service-file: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: core/file,core/plugin/registry,core/config depends_on: - mongo - redis - minio networks: - internal service-openapi: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICES: openapi/app,openapi/oidc/oidc OPENAPI_PORT: 3003 OPENAPI_UNDER_PROXY: "true" depends_on: - mongo - redis - minio labels: - "traefik.enable=true" - "traefik.http.routers.openapi-oidc.rule=PathPrefix(`/open`)" - "traefik.http.services.openapi-oidc.loadbalancer.server.port=3003" networks: - internal # 插件服务(所有插件) service-all-plugins: build: context: . image: tailchat restart: unless-stopped env_file: docker-compose.env environment: SERVICEDIR: plugins depends_on: - mongo - redis - minio networks: - internal # 数据库 mongo: image: mongo:4 restart: on-failure volumes: - ./data:/data/db networks: - internal # 数据缓存与中转通讯 redis: image: redis:alpine restart: on-failure networks: - internal # 存储服务 minio: image: minio/minio restart: on-failure networks: - internal environment: MINIO_ROOT_USER: tailchat MINIO_ROOT_PASSWORD: com.msgbyte.tailchat volumes: - ./storage:/data command: minio server /data --console-address ":9001" # 路由转发 traefik: image: traefik:v2.1 restart: unless-stopped command: - "--api.insecure=true" # Don"t do that in production! - "--providers.docker=true" - "--providers.docker.exposedbydefault=false" - "--entryPoints.web.address=:80" - "--entryPoints.web.forwardedHeaders.insecure" # Not good ports: - 8080:80 # 8080可以改成自己服务器上没有被占用的端口 - 127.0.0.1:11001:8080 #11001同上 volumes: - /var/run/docker.sock:/var/run/docker.sock:ro networks: - internal - defaultnetworks: internal: name: tailchat-internal
按一下esc
,然后:wq
保存退出,之后,
vim docker-compose.env
一样写入下面的内容:
LOGGER=trueLOGLEVEL=infoSERVICEDIR=servicesTRANSPORTER=redis://redis:6379CACHER=redis://redis:6379REDIS_URL=redis://redis:6379MONGO_URL=mongodb://mongo/tailchatSECRET=adswddWEQ@4 # 改成自己的密钥# fileAPI_URL=https://chat.gugu.ovh # 改成自己的网站# minioMINIO_URL=minio:9000MINIO_USER=tailchatMINIO_PASS=com.msgbyte.tailchat# SMTPSMTP_SENDER=SMTP_URI=# metricsPROMETHEUS=1
按一下esc
,然后:wq
保存退出,之后,
docker pull moonrailgun/tailchatdocker tag moonrailgun/tailchat tailchat # 修改tag以让配置文件能够识别
最后:
cd /root/data/docker_data/tailchat # 确保来到dockercompose文件所在的文件夹下# 确保配置文件(docker-compose.yml和docker-compose.env)在当前目录下# 执行以下命令一键启动docker-compose up -d
访问: http://
即可打开tailchat
注意部分云服务可能需要手动开放防火墙端口。
在docker-compose.env
文件中提供了部分环境变量可供配置。
tailchat
的docker-compose.yml
配置默认提供了如下配置:
mongodb
: 持久化数据库redis
: KV数据库与消息中转服务minio
: 分布式文件服务打开防火墙的端口8080
腾讯云打开方法如下:
图中示例填的是5230
,备注填的是memos
,这边我们填8080
,示例填microbin
,确定即可(如果你在docker-compose文件里换了8081
,这边就需要填8081
,以此类推)
查看端口是否被占用(以8080
为例),输入:
lsof -i:8080 #查看8080端口是否被占用,如果被占用,重新自定义一个端口
如果啥也没出现,表示端口未被占用,我们可以继续下面的操作了~
如果出现:
-bash: lsof: command not found
运行:
apt install lsof #安装lsof
如果端口没有被占用(被占用了就修改一下端口,比如改成8081,注意docker命令行里和防火墙都要改)
理论上我们就可以输入http://ip:8080
访问了。
注意:
1、不知道服务器IP,可以直接在命令行输入:
curl ip.sb
,会显示当前服务器的IP。2、遇到访问不了的情况,请再次检查在宝塔面板的防火墙和服务商的后台防火墙是否打开对应了端口。
有的小伙伴可能想搭建起来分享给其他人使用,如果后续想要分享给别人,IP+端口太不优雅了,咕咕建议大家还是搞一个域名,容易记,看起来也更正规一点。这样可以做https,会让网页更安全。(非要IP+端口访问的,可以直接跳到5.6
,并且跳过6. 反向代理
部分)
而且namesilo上面xyz后缀的域名一年就7块钱,可以年抛。
如果想要长期使用,还是建议买com后缀的域名,更加正规一些,可以输入laodade
来获得1美元的优惠(不知道现在还有没有)
namesilo自带隐私保护,咕咕一直在用这家,价格也是这些注册商里面比较低的,关键是他家不像其他家域名注册商,没有七七八八的套路!(就是后台界面有些丑古老 = =)
【域名购买】Namesilo优惠码和域名解析教程(附带服务器购买推荐和注意事项)
我们接着往下看!
cd /root/data/docker_data/tailchatdocker-compose down cp -r /root/data/docker_data/tailchat /root/data/docker_data/tailchat.archive # 万事先备份,以防万一,其实这边没必要,因为我们没有映射到本地文件夹docker-compose pulldocker-compose up -d # 请不要使用docker-compose stop来停止容器,因为这么做需要额外的时间等待容器停止;docker-compose up -d直接升级容器时会自动停止并立刻重建新的容器,完全没有必要浪费那些时间。docker image prune # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像
提示:
WARNING! This will remove all dangling images.Are you sure you want to continue? [y/N]
输入y
利用Docker搭建的应用,更新非常容易~
cd /root/data/docker_data/tailchatdocker-compose down rm -rf /root/data/docker_data/tailchat # 完全删除映射到本地的数据
可以卸载得很干净。
在添加反向代理之前,确保你已经完成了域名解析,不会的可以看这个:域名一枚,并做好解析到服务器上(域名购买、域名解析 视频教程)
之后,登陆Nginx Proxy Manager(不会的看这个:安装Nginx Proxy Manager(相关教程))
注意:
Nginx Proxy Manager(以下简称NPM)会用到
80
、443
端口,所以本机不能占用(比如原来就有Nginx)
直接丢几张图:
注意填写对应的
域名
、IP
和端口
,按文章来的话,应该是8080
IP填写:
如果Nginx Proxy Manager和Tailchat 在同一台服务器上,可以在终端输入:
ip addr show docker0
查看对应的Docker容器内部IP。
否则直接填tailchat
所在的服务器IP就行。
再次打开,勾选这些:
然后就可以用域名来安装访问了。
发现还是有不少小伙伴习惯用宝塔面板,这边也贴一个宝塔面板的反代配置:
直接新建一个站点,不要数据库,不要php,纯静态即可。
然后打开下面的配置,修改Nginx的配置。
代码如下:
location / { proxy_pass http://127.0.0.1:8080/; # 注意改成你实际使用的端口 rewrite ^/(.*)$ /$1 break; proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Upgrade-Insecure-Requests 1; proxy_set_header X-Forwarded-Proto https; }
此方法对90%的反向代理都能生效。
有同学可能会问,为什么不直接用宝塔自带的反向代理功能。
也可以,不过咕咕自己之前遇到过当有多个网站需要反代的时候,在这边设置会报错的情况 = =
所以后来就不用了,直接用上面的方法来操作了。
见咕咕的视频。
大家可以多使用多给作者提意见和建议,帮助项目更快迭代升级!
祝大家用得开心,有问题可以去GitHub提Issues,也可以在评论区互相交流探讨。
同时,项目处于刚开始阶段,有能力给项目做贡献的同学,也欢迎积极加入到项目中来,贡献自己的一份力量!
咕咕的Demo:https://chat.gugu.ovh/
文档:https://tailchat.msgbyte.com/
GitHub源码:https://github.com/msgbyte/tailchat
X 关闭
X 关闭