一,简介
rocket.chat是一个开源的社交软件,即可以直接在web页面使用,也可以下载APP(Android,IOS,Windows,Mac OS)
主要功能:群组聊天,直接通信,私聊群,桌面通知,媒体嵌入,链接预览,文件上传,语音/视频 聊天,截图等,还支持实时翻译,实现用户之间的自动实时消息转换。
也可以作为公司的内部聊天平台,所有数据都在自己的服务器上。
官方网址:https://rocket.chat/
官方github地址:https://github.com/RocketChat/Rocket.Chat
二,下载安装
安装方式有好几种方式,这里采取docker-compose容器安装方式,快速几分钟即可搭建完成。前提已安装好docker和docker-compose。
参考官方文档:https://docs.rocket.chat/
#创建一个目录
mkdir rocketchat
#进入目录
cd rocketchat
#获取官方docker-compose.yml文件
curl -L https://go.rocket.chat/i/docker-compose.yml -O
以下是获取到的官方docker-compose.yml,默认端口3000,使用mongo数据库,根据自己需求更改。
我这里不需要更改什么,直接使用即可。
version: '2'services:rocketchat:image: registry.rocket.chat/rocketchat/rocket.chat:latestcommand: >bash -c"for i in `seq 1 30`; donode main.js &&s=$$? && break || s=$$?;echo \"Tried $$i times. Waiting 5 secs...\";sleep 5;done; (exit $$s)"restart: unless-stoppedvolumes:- ./uploads:/app/uploadsenvironment:- PORT=3000- ROOT_URL=http://localhost:3000- MONGO_URL=mongodb://mongo:27017/rocketchat- MONGO_OPLOG_URL=mongodb://mongo:27017/local- REG_TOKEN=${REG_TOKEN}
# - MAIL_URL=smtp://smtp.email
# - HTTP_PROXY=http://proxy.domain.com
# - HTTPS_PROXY=http://proxy.domain.comdepends_on:- mongoports:- 3000:3000labels:- "traefik.backend=rocketchat"- "traefik.frontend.rule=Host: your.domain.tld"mongo:image: mongo:4.0restart: unless-stoppedvolumes:- ./data/db:/data/db#- ./data/dump:/dumpcommand: mongod --smallfiles --oplogSize 128 --replSet rs0 --storageEngine=mmapv1labels:- "traefik.enable=false"# this container's job is just run the command to initialize the replica set.# it will run the command and remove himself (it will not stay running)mongo-init-replica:image: mongo:4.0command: >bash -c"for i in `seq 1 30`; domongo mongo/rocketchat --eval \"rs.initiate({_id: 'rs0',members: [ { _id: 0, host: 'localhost:27017' } ]})\" &&s=$$? && break || s=$$?;echo \"Tried $$i times. Waiting 5 secs...\";sleep 5;done; (exit $$s)"depends_on:- mongo#traefik:# image: traefik:latest# restart: unless-stopped# command: ># traefik# --docker# --acme=true# --acme.domains='your.domain.tld'# --acme.email='your@email.tld'# --acme.entrypoint=https# --acme.storagefile=acme.json# --defaultentrypoints=http# --defaultentrypoints=https# --entryPoints='Name:http Address::80 Redirect.EntryPoint:https'# --entryPoints='Name:https Address::443 TLS.Certificates:'# ports:# - 80:80# - 443:443# volumes:# - /var/run/docker.sock:/var/run/docker.sock
下载完成后,直接运行即可
sudo docker-compose up -d
注意,开放3000端口 or 关闭防火墙,如果你是公有云服务器,记得修改你的安全组!
浏览器输入IP:3000,即可访问。
三,登录使用
第一次登录,需要创建管理员相关信息,及组织公司相关信息(不重要),只有邮件地址有效即可。之后进入自己的邮箱确认链接验证即可。
创建完成后,就可以登录账号,也可以创建新的普通用户。当然相关设置只能第一个管理员账号才能设置。
登录进去,默认进入# general公共频道,可以自己创建频道和拉人。剩下的功能自己用管理员账号研究。
四,SSL配置及nginx反向代理
rocket.chat有官方APP,在相关应用商店或者直接下载安装即可。
但是app连接服务器可能出现问题,导致连接不上。如下:
SSL配置
问题1:安卓app必须需要SSL连接才可,即 https://
所以要么自己在服务器上采用自签证,要么用域名商的ssl,如Cloudflare配置域名自动免费签证。
为了简单,直接给自己IP配置域名,开启SSL即可。简单可自行设置即可。
Cloudflare配置完域名,记得开启‘始终使用 HTTPS’功能。
注:如果直接配置域名,请将自己docker映射端口3000改为80端口,否则不生效,
即将docker-compose.yml中ports端口3000:3000,改为80:3000
nginx反向代理
问题2:采用nginx反向代理后,app提示websocket已于此伺服器上禁止
采用nginx反向代理情况:
1:其他安装方式不能改3000端口的情况下(rocket.chat默认端口)。
2:docker服务被其他nginx的80端口占用的情况下,不能改80端口,用其他nginx反向代理给docker的3000端口。
3:或者为了服务器安全,采用其他服务器nginx反向代理给真实服务器。
如果直接配置如下:
server {listen 80;server_name ywbj.cc;location / {proxy_pass http://localhost:3000;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }}
app连接显示会提示:websocket已于此伺服器上禁止
原因是nginx需要开启websocket,加入这重要的两行配置即可。
proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection $connection_upgrade;
更换后配置如下:
map $http_upgrade $connection_upgrade {default upgrade;'' close;
}
server {listen 80;server_name ywbj.cc;location / {proxy_pass http://localhost:3000;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection $connection_upgrade;}}
再次连接app成功登录。