1. Rocket.chat 服务端安装与维护
- 1.1. 安装snap
- 1.2. 安装 rocketchat server
- 1.3. 检查运行状态
- 1.4. SSL设置
  - 1.4.1. 设置 Caddy
  - 1.4.2. 重启caddy
  - 1.4.3. 访问
- 1.5. Rocketchat Server 维护
  - 1.5.1. 升级到最新版
  - 1.5.2. 查看日志
  - 1.5.3. 重启rocketchat
  - 1.5.4. 备份snap数据
  - 1.5.5. 恢复备份的snap数据
2. Rocket.chat 客户端安装使用
- 2.1. pc端
- 2.2. 手机端
  - 2.2.1. 直接下载使用
  - 2.2.2. 开发者编译安装
3. 试用情况说明
- 3.1. 问题
  - 3.1.1. 手机端不稳定
  - 3.1.2. 在阿里云上无法获取正式SSL证书
  - 3.1.3. 官方文档和下载不统一
- 3.2. 可能的解决方案

Rocket.Chat 是特性最丰富的 Slack 开源替代品之一。
主要功能：群组聊天，直接通信，私聊群，桌面通知，媒体嵌入，链接预览，文件上传，语音/视频聊天，截图等等。

1. Rocket.chat 服务端安装与维护

服务器环境：Ubuntu 16.04

1.1. 安装snap

apt install snap snapd

1.2. 安装 rocketchat server

sudo snap install rocketchat-server

浏览 localhost:3000 进行系统设置

1.3. 检查运行状态

sudo systemctl status snap.rocketchat-server.rocketchat-server.service

1.4. SSL设置

Caddy 可以使用 Let’s Encrypt 来自动添加 SSL 加密通讯。

如果是自行手工安装，也可以通过 certbot, acme.sh等进行设置正式的ssl证书。

https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E

https://coolshell.cn/articles/18094.html

官方还没有提供基于snap和Caddy的ssl证书认证过程文档。

1.4.1. 设置 Caddy

产生配置文件

sudo rocketchat-server.initcaddy

如果是Debian 或者其他发布版，则运行

sudo snap run rocketchat-server.initcaddy

编辑Caddy文件: /var/snap/rocketchat-server/current/Caddyfile

http://:8080
proxy / localhost:3000 {
  websocket
  transparent
}

替换 http://:8080 为你的网站,如 chat.bclearning.top

https://chat.bclearning.top:8080
tls self_signed
proxy / localhost:3000 {
  websocket
  transparent
}

或者加上http到https的重定向

chat.bclearning.top:8080 {
tls self_signed
 proxy / localhost:3000 {
   websocket
   transparent
 }
}

加反向代理

chat.bclearning.top:8080 {
        proxy / 127.0.0.1:3000 {
                proxy_header X-Forwarded-Proto {scheme}
                proxy_header X-Forwarded-For {host}
                proxy_header Host {host}
                websocket
        }
}

注：记得将域名指向到这个服务器ip地址。

1.4.2. 重启caddy

sudo systemctl restart snap.rocketchat-server.rocketchat-caddy
sudo systemctl status snap.rocketchat-server.rocketchat-caddy

1.4.3. 访问

https://chat.bclearning.top:8080

1.5. Rocketchat Server 维护

1.5.1. 升级到最新版

sudo snap refresh rocketchat-server

1.5.2. 查看日志

Server运行日志

sudo journalctl -u snap.rocketchat-server.rocketchat-server

数据库日志

sudo journalctl -u snap.rocketchat-server.rocketchat-mongo

1.5.3. 重启rocketchat

sudo systemctl restart snap.rocketchat-server.rocketchat-server

1.5.4. 备份snap数据

运行备份:

sudo snap run rocketchat-server.backupdb

查看备份文件

ls /var/snap/rocketchat-server//backup.tgz

复制 backup.tgz 到其他安全的地方

rsync -vauz  /var/snap/rocketchat-server/1248/backup.tgz ~/bak
# 加上日期标示
cp ~/bak/backup.tgz ~/bak/backup`date +%Y%m%d_%H%M`.tgz
# 仅保留近3天的备份，其余删除
find ~/bak -type f -mtime +3 | xargs rm -f

注：一般是复制到其他机器上。

1.5.5. 恢复备份的snap数据

将备份数据解压

cd ~
mkdir backup_data
cd backup_data
tar zxvf ~/bak/backup.tgz

创建了如下目录和文件: ~/backup_data/var/snap/rocketchat-server//dump/parties

Confirm your database name
The snap database name should be parties, but just to be safe:

sudo /snap/rocketchat-server/current/bin/mongo
(...)
> show dbs
local    0.000GB
parties  0.004GB
> exit

停掉 Rocket.Chat

sudo service snap.rocketchat-server.rocketchat-server stop

恢复数据库数据
Use mongorestore to restore your backup data back into your snap database
Important: before proceeding, consult https://docs.mongodb.com/manual/reference/program/mongorestore/ to learn about additional options and the non-overwriting behavior of mongorestore when the target database already exists.
Please note: at the time of writing, mongorestore required openssl version 1.0.2 specifically. If you see an error like this - (...) version 'OPENSSL_1.0.2' not found (required by /snap/rocketchat-server/current/bin/mongorestore) - simply install the required openssl version to continue.
When you are ready, run the following command (replacing with the appropriate directory name):

sudo /snap/rocketchat-server/current/bin/mongorestore --db parties \
~/backup_data/var/snap/rocketchat-server//dump/parties/

重启数据库，server,caddy服务

sudo service snap.rocketchat-server.rocketchat-mongo  restart
sudo service snap.rocketchat-server.rocketchat-server restart
sudo service snap.rocketchat-server.rocketchat-caddy  restart

sudo service snap.rocketchat-server.rocketchat-mongo  stop
sudo service snap.rocketchat-server.rocketchat-server stop
sudo service snap.rocketchat-server.rocketchat-caddy  stop

2. Rocket.chat 客户端安装使用

客户端覆盖了大部分平台，可以从 http://rocket.chat下载，
下面只列出windows和android版的使用

2.1. pc端

浏览器访问 https://chat.bclearning.top:8080/
因为是自签名，提示不安全，但是继续点击访问即可。

或者下载windows版程序

2.2. 手机端

2.2.1. 直接下载使用

访问
https://github.com/RocketChat/Rocket.Chat.Cordova/releases/
下载 armv7版本到手机， x86版本apk 到平板。

配置服务器为 chat.bclearning.top:8080

2.2.2. 开发者编译安装

https://rocket.chat/docs/developer-guides/mobile-apps/

3. 试用情况说明

Pc端和浏览器版本基本正常。问题主要是出在了手机端，iOS未测试，android进行了测试。

因为手机和个人精力有限，并发量没有测试，仅仅测试2,3个用户。

3.1. 问题

3.1.1. 手机端不稳定

pc端访问正常，很遗憾的是，手机端始终访问不正常，即使采用官方的云服务 rocket.chat 部署的Server也无法访问，可能原因包括被墙，ssl是自签名的非正式版本等等。

采用2.x 版本访问官方的云服务自建服务时，无法连接，出现空白。更别提自建的服务器了。
采用1.x版本访问官方的云服务自建服务时，消息不稳定，延时很厉害。连接自建服务还未充分测试。

而且上述现象似乎还与手机连的是办公wifi或者无wifi下又有不同。

3.1.2. 在阿里云上无法获取正式SSL证书

阿里云上部署的Server始终无法获取Let’s Encrypt 的 SSL 证书，无论是用 certbot 还是 acme.sh
换到国外的主机 vultr之后正常。

 ./acme.sh --issue -d domain.name --standalone

3.1.3. 官方文档和下载不统一

A. 安装步骤并不能都通过，包括手工的pc端安装

B 手机端：官方文档有点乱，同时提供了android客户端的google play商店的2个版本的下载，与github上的release版本也不同。这就造成了试用的混乱。

android 老版本下载： 1.0.13
android上的apk在google play无法下载，可通过通过如下网址，点击生成下载
https://apps.evozi.com/apk-downloader/?id=chat.rocket.android
可以连接官方的服务器 yishineihua.rocket.chat
消息在公共频道有时会有延时

android 2.5 版本下载
https://apps.evozi.com/apk-downloader/?id=com.konecty.rocket.chat

android 新版本下载 2.4 未发布到google play.
https://github.com/RocketChat/Rocket.Chat.Cordova/releases/

3.2. 可能的解决方案

为了避免国内墙或者云服务的问题和干扰，采用国外的主机安装，确保可以获取ssl证书，进而可以搭建自己的服务器能够被手机端访问。
采用 googleplay的 1.x 版本的下载和试用。
将问题充分反馈到github的issue上。
搭建手机端的开发环境，编译下载最新版的，然后连接使用。
采用其他开源软件如：MatterMost
这是我写的介绍，安装配置与使用文章：
团队合作聊天服务Mattermost在Ubuntu 16.04下的安装配置与试用

备注：
如果不采用snap的快速安装，采用手工安装，安装了mongodb-org 3.x
则mongodb的启动方式如下：
mongod --dbpath=/var/lib/mongodb --replSet "001-rs"

Rocket.Chat 团队合作聊天工具安装配置试用