本教程适用于以下操作系统版本

  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)

本页内容

  • 先决条件
  • 安装并配置 MariaDB 数据库服务器
  • 安装 Mattermost
  • 为 Mattermost 创建 Systemd 服务文件
  • 配置 Nginx 作为 Mattermost 的反向代理
  • 访问 Mattermost Web 界面
  • 结论

Mattermost 是一款以安全为设计理念打造的免费开源协作与消息传递平台。它是 Discord 或 Slack 的替代方案,提供众多实用功能,包括一对一消息、无限制的搜索历史与文件共享能力、双因素认证以及通知。它是一款使用 Golang 和 React 编写的自托管在线聊天服务,专为组织和公司设计,可让团队随时随地安全地进行沟通。

在本教程中,我们将向你演示如何在 Debian 11 上安装 Mattermost Chat 服务器。

先决条件

  • 一台运行 Debian 11 的服务器。
  • 一个指向你服务器 IP 的有效域名。
  • 服务器上已配置 root 密码。

安装并配置 MariaDB 数据库服务器

Mattermost 使用 MySQL 或 MariaDB 作为数据库后端。因此你需要在服务器上安装 MariaDB 服务器。可以使用以下命令安装:

apt-get install mariadb-server -y

MariaDB 安装完成后,启动 MariaDB 服务并设置为系统重启时自动启动:

systemctl start mariadb
systemctl enable mariadb

接下来,使用以下命令连接到 MariaDB shell:

mysql

连接成功后,使用以下命令创建数据库和用户:

MariaDB [(none)]> create database mattermost;
MariaDB [(none)]> create user mattermost@localhost identified by 'password';

接下来,使用以下命令为 Mattermost 数据库授予所有权限:

MariaDB [(none)]> grant all privileges on mattermost.* to mattermost@localhost;

接下来,使用以下命令刷新权限并退出 MariaDB shell:

MariaDB [(none)]> flush privileges;
MariaDB [(none)]> exit;

完成后,即可继续下一步。

安装 Mattermost

首先,使用以下命令为 Mattermost 创建一个专用用户:

useradd --system --user-group mattermost

接下来,使用以下命令下载最新版本的 Mattermost:

wget https://releases.mattermost.com/6.0.2/mattermost-6.0.2-linux-amd64.tar.gz

下载完成后,使用以下命令解压已下载的文件:

tar -xvzf mattermost-6.0.2-linux-amd64.tar.gz

接下来,使用以下命令将解压出的目录移动到 /opt:

mv mattermost /opt

接下来,使用以下命令为 mattermost 创建数据目录:

mkdir /opt/mattermost/data

接下来,使用以下命令更改 mattermost 目录的所有者:

chown -R mattermost:mattermost /opt/mattermost
chmod -R g+w /opt/mattermost

接下来,使用以下命令编辑 config.json 文件:

nano /opt/mattermost/config/config.json

找到以下几行:

    "DriverName": "postgres",
    "DataSource": "postgres://mmuser:mostest@localhost/mattermost_test?sslmode=disable\u0026connect_timeout=10",

并根据你的数据库设置将其替换为以下几行:

"DriverName": "mysql",
"DataSource": "mattermost:password@tcp(127.0.0.1:3306)/mattermost?charset=utf8mb4,utf8\u0026readTimeout=30s\u0026writeTimeout=30s",

完成后保存并关闭文件。

为 Mattermost 创建 Systemd 服务文件

接下来,你需要为 Mattermost 创建 systemd 服务文件。可使用以下命令创建:

nano /etc/systemd/system/mattermost.service

添加以下几行:

[Unit]
Description=Mattermost
After=syslog.target network.target mysqld.service

[Service]
Type=notify
WorkingDirectory=/opt/mattermost
User=mattermost
ExecStart=/opt/mattermost/bin/mattermost
PIDFile=/var/spool/mattermost/pid/master.pid
TimeoutStartSec=3600
LimitNOFILE=49152

[Install]
WantedBy=multi-user.target

保存并关闭文件,然后重新加载 systemd 守护进程以使更改生效:

systemctl daemon-reload

接下来,启动 Mattermost 并设置为系统重启时自动启动:

systemctl start mattermost
systemctl enable mattermost

接下来,使用以下命令检查 Mattermost 的状态:

systemctl status mattermost

你将看到如下输出:

? mattermost.service - Mattermost
     Loaded: loaded (/etc/systemd/system/mattermost.service; disabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-11-12 13:56:25 UTC; 4s ago
   Main PID: 2888 (mattermost)
      Tasks: 31 (limit: 4679)
     Memory: 273.3M
        CPU: 12.191s
     CGroup: /system.slice/mattermost.service
             ??2888 /opt/mattermost/bin/mattermost
             ??2915 plugins/com.mattermost.plugin-channel-export/server/dist/plugin-linux-amd64
             ??2925 plugins/playbooks/server/dist/plugin-linux-amd64
             ??2931 plugins/focalboard/server/dist/plugin-linux-amd64

Nov 12 13:56:24 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:24.681 Z","level":"info","msg":"Scheduling next survey for Dec 3, 2>
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.064 Z","level":"info","msg":"Post.Message has size restrictions">
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.084 Z","level":"info","msg":"info [2021-11-12 13:56:25.083 Z] co>
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.131 Z","level":"info","msg":"\n    -- collation of mattermost's >
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.491 Z","level":"info","msg":"debug [2021-11-12 13:56:25.488 Z] i>
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.777 Z","level":"info","msg":"info [2021-11-12 13:56:25.777 Z] Se>
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.963 Z","level":"info","msg":"Starting Server...","caller":"app/s>
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.964 Z","level":"info","msg":"Server is listening on [::]:8065",">
Nov 12 13:56:25 debian11 mattermost[2888]: {"timestamp":"2021-11-12 13:56:25.964 Z","level":"info","msg":"Sending systemd READY notification.>
Nov 12 13:56:25 debian11 systemd[1]: Started Mattermost.

配置 Nginx 作为 Mattermost 的反向代理

默认情况下,Mattermost 监听 8065 端口。因此较好的做法是安装并配置 Nginx 作为反向代理,以便通过 80 端口访问 Mattermost。首先,使用以下命令安装 Nginx:

apt-get install nginx -y

Nginx 安装完成后,使用以下命令创建 Nginx 虚拟主机配置文件:

nano /etc/nginx/conf.d/mattermost.conf

添加以下几行:

upstream mattermost {
   server localhost:8065;
   keepalive 32;
}

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

server {
   listen 80;
   server_name mattermost.example.com;

   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;
       client_body_timeout 60;
       send_timeout 300;
       lingering_timeout 5;
       proxy_connect_timeout 90;
       proxy_send_timeout 300;
       proxy_read_timeout 90s;
       proxy_pass http://mattermost;
   }

   location / {
       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_http_version 1.1;
       proxy_pass http://mattermost;
   }
}

保存并关闭文件,然后使用以下命令检查 Nginx 配置是否存在语法错误:

nginx -t

你应看到如下输出:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

接下来,启动 Nginx 服务以使更改生效:

systemctl start nginx

你也可以使用以下命令检查 Nginx 的状态:

systemctl status nginx

你应得到如下输出:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-11-12 13:57:02 UTC; 1min 12s ago
       Docs: man:nginx(8)
    Process: 3384 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 3392 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 3602 (nginx)
      Tasks: 3 (limit: 4679)
     Memory: 6.6M
        CPU: 55ms
     CGroup: /system.slice/nginx.service
             ??3602 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??3604 nginx: worker process
             ??3605 nginx: worker process

Nov 12 13:57:01 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 12 13:57:02 debian11 systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Nov 12 13:57:02 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.

至此,Nginx 已安装并配置为 Mattermost 的反向代理。现在可以继续下一步。

访问 Mattermost Web 界面

现在,打开 Web 浏览器,通过 URL http://mattermost.example.com 访问 Mattermost Web 界面。你将被重定向到如下页面:

在 Debian 11 系统上完整部署 Mattermost 团队协作平台教程

填写管理员邮箱地址、用户名和密码,然后点击 Create Account 按钮。你应看到如下页面:

在 Debian 11 系统上完整部署 Mattermost 团队协作平台教程

现在,点击 Go to System Console。你将被重定向到 Mattermost 仪表板,如下所示:

在 Debian 11 系统上完整部署 Mattermost 团队协作平台教程

结论

恭喜!你已在 Debian 11 上成功安装了以 Nginx 作为反向代理的 Mattermost。现在可以在你的组织中部署 Mattermost,让团队随时随地相互沟通。