Mattermost — система обмена сообщениями с открытым исходным кодом, предоставляющая безопасную и гибкую службу чата с такими функциями, как обмен файлами, функция поиска и интеграция. Благодаря удобному интерфейсу Mattermost прост в использовании и становится все более популярным. Это бесплатная замена таким платформам, как Slack, Microsoft Teams и аналогичным сервисам. Если вас интересует, как установить Mattermost в систему Ubuntu Linux, то эта статья для вас.

Предварительные условия

  • Сервер под управлением Ubuntu 24.04 или любой другой ОС Linux.
  • Привилегии пользователя: пользователь root или не root с привилегиями sudo.

Конвенции

1
2
# - данные команды должны выполняться с правами root либо непосредственно от имени пользователя root, либо с помощью команды sudo.
$ - данные команды должны выполняться от имени обычного пользователя

Обновите систему

Прежде чем мы начнем установку, нам необходимо обновить системные пакеты до последних доступных версий.

1
$ sudo apt update -y && sudo apt upgrade -y

Создайте пользователя

Служба Mattermost будет запущена другим системным пользователем, а не пользователем root. На этом этапе мы создадим нового системного пользователя с именем «mattermost». Давайте выполним команду ниже, вы можете заменить «mattermost» на любое имя пользователя, которое вам нравится.

1
# useradd -mrd /opt/mattermost mattermost -s "$(which bash)"

Приведенная выше команда автоматически создаст каталог /opt/mattermost в качестве домашнего каталога для пользователя «mattermost». Мы будем использовать этот каталог для пути установки Mattermost.

Установите PostgreSQL

На данный момент Mattermost поддерживает как PostgreSQL 11.0+, так и MySQL 8.0.12+. На этом этапе мы собираемся установить PostgreSQL в качестве сервера базы данных для Mattermost. Давайте завершим этот шаг, просто выполнив следующую команду:

1
# apt install postgresql

После завершения установки PostgreSQL автоматически запустится и заработает. Он также настроен на автоматический запуск при перезагрузке сервера.

Создайте базу данных

Далее давайте создадим базу данных PostgreSQL. Сначала нам нужно войти в систему под пользователем «postgres», а затем перейти в оболочку PostgreSQL.

1
2
# su - postgres
$ psql

После входа в систему давайте выполним приведенные ниже команды, чтобы создать базу данных и пользователя, а затем предоставим пользователю доступ.

1
2
3
4
5
CREATE DATABASE mattermost;
CREATE USER mattermost WITH PASSWORD 'v4VtxMEuDe';
GRANT ALL ON DATABASE mattermost TO mattermost;
ALTER DATABASE mattermost OWNER TO mattermost;
GRANT USAGE, CREATE ON SCHEMA PUBLIC TO mattermost;

Затем выйдите из оболочки PostgreSQL, затем выйдите из пользователя postgres.

1
2
\q
$ exit

Загрузите и установите Mattermost

На предыдущем этапе мы создали системного пользователя с именем «Mattermost»; давайте перейдем к этой учетной записи пользователя и загрузим Mattermost. Если вы хотите загрузить более новый пакет tarball, вы можете перейти на их страницу загрузки и получить ссылку для загрузки

1
# su - mattermost
1
$ wget https://releases.mattermost.com/9.10.1/mattermost-9.10.1-linux-amd64.tar.gz -O mattermost.tar.gz

Установочный файл загружен и сохранен как mattermost.tar.gz. Теперь давайте извлечем файл.

1
$ tar -xzvf mattermost.tar.gz --strip-component 1

Прежде чем запускать Mattermost, нам необходимо настроить его для подключения к нашей базе данных.

1
$ cp /opt/mattermost/config/config.json{,.orig}

Команда выше предназначена для сохранения копии config.json как config.json.orig. Теперь давайте отредактируем файл config.json для подключения к базе данных PostgreSQL.

1
$ nano /opt/mattermost/config/config.json

Настройте следующие свойства в этом файле:

1
Set DataSource to "dbuser:@:3306/dbname?sslmode=disable\u0026connect_timeout=10\u0026binary_parameters=yes",

замените dbuser, dbpassword на свои dbuser и dbpassword, которые вы создали на предыдущем шаге. В этом случае это будет:

1
"DataSource": "postgres://mattermost:v4VtxMEuDe@localhost/mattermost?sslmode=disable\u0026connect_timeout=10\u0026binary_parameters=yes",

Установите свой «SiteURL»: доменное имя для приложения Mattermost (например, https://mattermost.example.com).

сохраните файл, затем выйдите из редактора nano, затем выйдите из пользовательского режима «Mattermost».

1
$ exit

Создайте файл службы Systemd

На этом этапе мы создадим служебный файл systemd для управления нашим сервисом Mattermost. Давайте теперь создадим служебный файл systemd для Mattermost.

1
# nano /etc/systemd/system/mattermost.service

Вставьте следующее в файл службы systemd и сохраните его.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
[Unit]
Description=Mattermost
After=network.target

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

[Install]
WantedBy=multi-user.target

Сохраните файл, выйдите, а затем перезагрузите systemd, чтобы изменения вступили в силу.

1
# systemctl daemon-reload

Далее давайте включим Mattermost запуск при загрузке и запустим службу сейчас.

1
# systemctl enable --now mattermost

Команда выше вернет такой вывод:

1
Created symlink /etc/systemd/system/multi-user.target.wants/mattermost.service → /etc/systemd/system/mattermost.service.

На этом этапе Mattermost должен быть запущен и автоматически запускаться при загрузке.

У вас должен быть доступ к Mattermost по адресу http://ВАШ_СЕРВЕР_IP_АДРЕС:8065

Установите и настройте Nginx

На предыдущем шаге нам удалось получить доступ к Mattermost по адресу http://ВАШ_СЕРВЕР_IP_АДРЕС:8065. Чтобы получить доступ к Mattermost через домен или поддомен без использования порта в конце URL-адреса, нам необходимо установить и настроить обратный прокси-сервер. Давайте установим и настроим nginx.

1
# apt install nginx -y

После установки мы можем создать блок сервера nginx для нашего сайта Mattermost.

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

Затем вставьте в файл следующее.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
upstream backend {
    server 127.0.0.1:8065;
}

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

   location / {
       client_max_body_size 50M;
       proxy_set_header X-Frame-Options SAMEORIGIN;
       proxy_buffers 256 16k;
       proxy_buffer_size 16k;
       proxy_read_timeout 600s;
       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://backend;
   }
}

Сохраните файл, затем выйдите из редактора и перезапустите nginx.

1
# systemctl restart nginx

Завершение

Теперь вы можете получить доступ к Mattermost по адресу http://mattermost.example.com и войти в систему, используя учетные данные. После входа в систему вы можете попробовать отправить сообщение.

Вы успешно установили Mattermost на Ubuntu 24.04. Вы также можете поделиться статьей со своими друзьями в социальных сетях, которым может быть интересна эта статья, или просто оставить комментарий ниже. Спасибо.