如何在Ubuntu 18.04上部署Mattermost

Mattermost是企业级的即时消息传递平台,它是开源的自托管Slack替代产品。 它是用Golang和React编写的,可以将MySQL或PostgreSQL用作数据库后端。 Mattermost将您所有团队的沟通融合到一处,并提供各种功能,包括文件共享,一对一和组消息传递,自定义表情符号,视频通话等。

在本教程中,我们将在Ubuntu 18.04服务器上安装Mattermost并将Nginx配置为SSL反向代理。

先决条件

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

  • 您以具有sudo特权的用户身份登录。
  • 您有一个指向服务器IP地址的域名。 在本文中,我们将使用 example.com
  • 您已经安装了Nginx,如果没有,请查看本指南。
  • 您已经为您的域安装了SSL证书。 您可以按照本指南安装免费的“让我们加密SSL”证书。

创建MySQL数据库

我们将使用MySQL作为Mattermost的数据库。 如果您的服务器上未安装MySQL或MariaDB,则可以按照以下说明进行安装。

登录到MySQL Shell:

mysql -u root

使用以下内容为我们的Mattermost安装创建新的数据库和用户:

CREATE DATABASE mattermost;GRANT ALL ON mattermost.* TO [email protected] IDENTIFIED BY 'P4ssvv0rD';

确保您使用的密码比 P4ssvv0rD

创建新的系统用户#

创建一个将运行我们的Mattermost实例的新用户和组。 我们将为用户命名 mattermost

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

安装Mattermost服务器#

在撰写本文时,Mattermost的最新稳定版本是5.1.0版。 使用以下curl命令下载档案:

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

下载完成后,解压缩存档并将其移至 /opt 目录

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

创建文件的存储目录:

sudo mkdir -p /opt/mattermost/data

将目录所有权更改为 mattermost 用户:

sudo chown -R mattermost: /opt/mattermost

打开 /opt/mattermost/config/config.json 文件,将数据库驱动程序设置为 mysql 并输入数据库信息:

/opt/mattermost/config/config.json

"SqlSettings": {
    "DriverName": "mysql",
    "DataSource": "mattermost:[email protected](localhost:3306)/mattermost?charset=utf8mb4,utf8&readTimeout=30s&writeTimeout=30s",

为了确保我们的Mattermost实例能够按预期工作,我们将测试Mattermost服务器。 换成 /opt/mattermost 目录并使用以下命令启动服务器:

cd /opt/mattermostsudo -u mattermost bin/mattermost

如果一切正常,服务器将启动,输出将类似于以下内容:

{"level":"info","ts":1532546921.941638,"caller":"app/server.go:115","msg":"Starting Server..."}
{"level":"info","ts":1532546921.9421031,"caller":"app/server.go:154","msg":"Server is listening on [::]:8065"}
{"level":"info","ts":1532546921.9541554,"caller":"app/web_hub.go:75","msg":"Starting 2 websocket hubs"}

现在,我们可以使用以下命令停止Mattermost服务器 CTRL+C 并继续下一步。

创建一个系统单位

为了将Mattermost实例作为服务运行,我们将创建一个 mattermost.service 单位文件 /etc/systemd/system/ 目录。

打开您的文本编辑器并创建以下文件:

/etc/systemd/system/mattermost.service

[Unit]
Description=Mattermost
After=network.target
After=mysql.service
Requires=mysql.service

[Service]
Type=notify
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
Restart=always
RestartSec=10
WorkingDirectory=/opt/mattermost
User=mattermost
Group=mattermost
LimitNOFILE=49152

[Install]
WantedBy=mysql.service

通知systemd我们已经创建了一个新的单元文件,并使用以下命令启动Mattermost服务:

sudo systemctl daemon-reloadsudo systemctl start mattermost

现在,我们可以通过以下方式检查服务状态:

sudo systemctl status mattermost
● mattermost.service - Mattermost
   Loaded: loaded (/etc/systemd/system/mattermost.service; disabled; ven
   Active: active (running) since Wed 2018-07-25 18:39:05 UTC; 41s ago
 Main PID: 3091 (mattermost)
    Tasks: 18 (limit: 507)
   CGroup: /system.slice/mattermost.service
           ├─3091 /opt/mattermost/bin/mattermost

如果没有错误,请启用Mattermost服务以在启动时自动启动:

sudo systemctl enable mattermost

使用Nginx设置反向代理

如果您遵循我们如何在Ubuntu 18.04上安装Nginx以及如何在Ubuntu 18.04上使用Let’s Encrypt来保护Nginx指南,则您应该已经安装了Nginx并配置了SSL证书。

现在,我们需要为Mattermost实例设置一个新的服务器块。 打开您的文本编辑器并创建以下文件:

/etc/nginx/conf.d/example.com.conf

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 example.com www.example.com;

    include snippets/letsencrypt.conf;
    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name www.example.com;

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

    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com;

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

    access_log /var/log/nginx/example.com-access.log;
    error_log /var/log/nginx/example.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#

打开浏览器,输入您的域,您将被重定向到sugnup页面。

输入您的电子邮件,选择用户名和密码,然后单击 Create Account 按钮创建您的第一个帐户。

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

在下一步中,配置向导将要求您创建一个新团队。

最重要的创建帐户

点击 Create a new team 链接,输入您的第一支球队,然后点击 Next 按钮。

最重要的团队名称

在下一步中,系统会要求您选择新团队的网址:

最重要的团队网址

点击 Finish 按钮,您将被重定向到Mattermost仪表板,以管理员身份登录。

最重要的仪表板

通过单击导航面板顶部的用户名,打开系统控制台,然后在打开的新菜单中,单击 System Console 链接。

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

最重要的网站网址

要启用电子邮件通知,请转到通知→电子邮件,更改 Enable Email Notifications 来自的价值 falsetrue 并输入您的SMTP参数。

最重要的电子邮件通知

您可以使用任何流行的交易电子邮件服务,例如SendinBlue,SendGrid,Amazon SES,Mandrill,Mailgun,Mailjet和Postmark,也可以按照本教程设置自己的邮件服务器。

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

sudo systemctl restart mattermost

结论#

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

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

火箭聊天nodejs Ubuntu

Sidebar