一,简介
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:latest
command: >
bash -c
"for i in `seq 1 30`; do
node main.js &&
s=$? && break || s=$?;
echo \"Tried $i times. Waiting 5 secs...\";
sleep 5;
done; (exit $s)"
restart: unless-stopped
volumes:
- ./uploads:/app/uploads
environment:
- 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.com
depends_on:
- mongo
ports:
- 3000:3000
labels:
- "traefik.backend=rocketchat"
- "traefik.frontend.rule=Host: your.domain.tld"
mongo:
image: mongo:4.0
restart: unless-stopped
volumes:
- ./data/db:/data/db
#- ./data/dump:/dump
command: mongod --smallfiles --oplogSize 128 --replSet rs0 --storageEngine=mmapv1
labels:
- "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.0
command: >
bash -c
"for i in `seq 1 30`; do
mongo 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成功登录。