如何在 CentOS 7 上部署 Mattermost

Mattermost 是一个开源即时通讯平台，是一个自托管的 Slack 替代品。它是用 Golang 和 React 编写的，可以使用 MySQL 或 PostgreSQL 作为数据库后端。 Mattermost 将您的所有团队沟通集中到一处，并提供各种功能，包括文件共享、一对一和群组消息传递、自定义表情符号、视频通话等。在本教程中，我们将向您展示如何在 CentOS 7 服务器上部署 Mattermost 并将 Nginx 配置为 SSL 反向代理。

先决条件#

在继续本教程之前，请确保您已满足以下先决条件：

• 您登录的身份为具有 sudo 权限的用户 .
• 您有一个指向您的服务器 IP 地址的域名。我们将使用linuxize-test.com.
• 你已经安装了Nginx，如果没有安装请检查this guide.
• 您已为您的域安装了 SSL 证书。您可以按照以下步骤安装免费的 Let’s Encrypt SSL 证书this guide.

创建MySQL数据库#

我们将使用 MariaDB 10.3 作为数据库后端。 Mattermost 不适用于 MariaDB 5.5 版。

如果您的服务器上没有安装 MariaDB 10.3，您可以检查本指南 .

登录 MySQL shell：

mysql -u root -p

并运行以下命令为我们的 Mattermost 安装创建新的数据库和用户：

create database mattermost;GRANT ALL ON mattermost.* TO mattermost@localhost IDENTIFIED BY 'P4ssvv0rD';

创建新的系统用户#

创建名为的新用户和组mattermost，这将运行 Mattermost 安装，请运行以下命令：

sudo useradd -U -M -d /opt/mattermost mattermost

安装 Mattermost 服务器#

在撰写本文时，Mattermost 的最新稳定版本是版本 5.4.0。在继续下一步之前，您应该检查最重要的下载页面查看是否有新版本可用。

下载包含以下内容的存档卷曲命令 :

sudo curl -L https://releases.mattermost.com/5.4.0/mattermost-5.4.0-linux-amd64.tar.gz -o /tmp/mattermost.tar.gz

下载完成后，解压存档并将其移至opt目录：

sudo tar zxf /tmp/mattermost.tar.gz -C /opt

创建文件的存储目录：

sudo mkdir /opt/mattermost/data

更改目录所有权 to the mattermost user:

sudo chown -R mattermost: /opt/mattermost

打开config.json与您最喜欢的文件一起归档文本编辑器 :

sudo nano /opt/mattermost/config/config.json

将数据库驱动程序设置为mysql，输入我们在本教程前面创建的数据库名称和数据库用户密码：

...
"SqlSettings": {
    "DriverName": "mysql",
    "DataSource": "mattermost:P4ssvv0rD@tcp(localhost:3306)/mattermost?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s",
    "DataSourceReplicas": [],
...

为了测试我们的安装，确保在创建 systemd 单元和设置之前一切正常使用 Nginx 进行反向代理我们将启动 Mattermost 服务器。

更改为/opt/mattermost目录并启动服务器：

cd /opt/mattermostsudo -u mattermost bin/mattermost

输出应显示 Mattermost 服务器是监听端口 8065 :

{"level":"info","ts":1540921243.6797202,"caller":"app/plugin.go:100","msg":"Starting up plugins"}
{"level":"info","ts":1540921244.3483207,"caller":"app/server.go:88","msg":"Starting Server..."}
{"level":"info","ts":1540921244.3488805,"caller":"app/server.go:148","msg":"Server is listening on [::]:8065"}
{"level":"info","ts":1540921244.3620636,"caller":"app/web_hub.go:75","msg":"Starting 2 websocket hubs"}
{"level":"info","ts":1540921244.451155,"caller":"jobs/workers.go:63","msg":"Starting workers"}
{"level":"info","ts":1540921244.456804,"caller":"jobs/schedulers.go:68","msg":"Starting schedulers."}

您现在可以使用以下命令停止 Mattermost 服务器CTRL+C并继续执行后续步骤。

创建一个 Systemd 单元#

为了将 Mattermost 实例作为服务运行，我们将创建一个mattermost.service单元文件中的/etc/systemd/system/目录包含以下内容：

[Unit]
Description=Mattermost
After=network.target nss-lookup.target mariadb.service

[Service]
Type=notify
WorkingDirectory=/opt/mattermost
User=mattermost
SyslogIdentifier=mattermost
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
LimitNOFILE=49152

[Install]
WantedBy=multi-user.target

通知 systemd 我们创建了一个新的单元文件并通过执行以下命令启动 Mattermost 服务：

sudo systemctl daemon-reloadsudo systemctl start mattermost

我们现在可以使用以下命令检查服务状态：

sudo systemctl status mattermost

● mattermost.service - Mattermost
   Loaded: loaded (/etc/systemd/system/mattermost.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2018-10-30 17:44:46 UTC; 3s ago
 Main PID: 25959 (mattermost)
   CGroup: /system.slice/mattermost.service
           └─25959 /opt/mattermost/bin/mattermost

最后，启用 Mattermost 服务在启动时自动启动：

sudo systemctl enable mattermost

使用 Nginx 设置反向代理#

如果您关注我们的如何在 CentOS 7 上安装 Nginx and 如何在 CentOS 7 上使用 Let’s Encrypt 保护 Nginx指南中您应该已经安装了 Nginx 并配置了 SSL 证书。现在我们只需要为 Mattermost 安装创建一个新的服务器块。

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=mattermost_cache:10m max_size=3g inactive=120m use_temp_path=off;

upstream mattermost_backend {
  server 127.0.0.1:8065;
}

server {
    listen 80;
    server_name linuxize-test.com www.linuxize-test.com;

    include snippets/letsencrypt.conf;
    return 301 https://linuxize-test.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name www.linuxize-test.com;

    ssl_certificate /etc/letsencrypt/live/linuxize-test.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/linuxize-test.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/linuxize-test.com/chain.pem;
    include snippets/ssl.conf;

    return 301 https://linuxize-test.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name linuxize-test.com;

    ssl_certificate /etc/letsencrypt/live/linuxize-test.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/linuxize-test.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/linuxize-test.com/chain.pem;
    include snippets/ssl.conf;

    access_log /var/log/nginx/linuxize-test.com-access.log;
    error_log /var/log/nginx/linuxize-test.com-error.log;

   location ~ /api/v[0-9]+/(users/)?websocket$ {
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection "upgrade";
       client_max_body_size 50M;
       proxy_set_header Host $http_host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header X-Frame-Options SAMEORIGIN;
       proxy_buffers 256 16k;
       proxy_buffer_size 16k;
       proxy_read_timeout 600s;
       proxy_pass http://mattermost_backend;
   }

   location / {
       proxy_http_version 1.1;
       client_max_body_size 50M;
       proxy_set_header Connection "";
       proxy_set_header Host $http_host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header X-Frame-Options SAMEORIGIN;
       proxy_buffers 256 16k;
       proxy_buffer_size 16k;
       proxy_read_timeout 600s;
       proxy_cache mattermost_cache;
       proxy_cache_revalidate on;
       proxy_cache_min_uses 2;
       proxy_cache_use_stale timeout;
       proxy_cache_lock on;
       proxy_pass http://mattermost_backend;
   }
}

重新加载Nginx服务使更改生效：

sudo systemctl reload nginx

配置 Mattermost#

打开浏览器，输入您的域名并创建您的第一个帐户：

系统中第一个创建的用户具有管理员权限。

点击Create a new team链接，创建您的第一个团队，并设置团队 URL：

创建第一个管理员帐户和第一个团队后，您将被重定向到 Mattermost 仪表板，以管理员身份登录。打开系统控制台，单击导航面板顶部的用户名，然后在打开的新菜单中单击System Console link:

通过转至设置常规 → 配置来设置站点 URL。

转至通知→电子邮件启用电子邮件通知

并输入您的 SMTP 参数。您可以使用任何流行的事务性电子邮件服务，例如 SendinBlue、SendGrid、Amazon SES、Mandrill、Mailgun、Mailjet 和 Postmark，或者您也可以设置您自己的邮件服务器 .

最后，我们需要重新启动 Mattermost 服务以使更改生效：

sudo systemctl restart mattermost

结论#

您已在 CentOS 7 服务器上成功安装 Mattermost 并将 Nginx 设置为反向代理。您现在可以开始使用 Mattermost 与您的团队协作。

如果您在安装时遇到任何问题，请随时发表评论。