Cách cài đặt Mattermost trên Rocky Linux 9

[theanh]

Mattermost là hệ thống nhắn tin tự lưu trữ và mã nguồn mở dành cho tổ chức của bạn. Đây là giải pháp thay thế cho các dịch vụ như Slack và Microsoft Teams. Mattermost kết hợp nhiều tính năng, bao gồm chia sẻ tệp, tìm kiếm, tự động hóa và nhiều tích hợp của bên thứ ba. Đây là nền tảng cộng tác và hệ thống nhắn tin dành cho tổ chức và công ty nội bộ của bạn.

Hướng dẫn này hướng dẫn bạn cách cài đặt Mattermost trên máy chủ Rocky Linux 9. Bạn sẽ thiết lập Mattermost với PostgreSQL làm cơ sở dữ liệu và Nginx làm proxy ngược, sau đó tạo không gian làm việc đầu tiên trong Mattermost.

Điều kiện tiên quyết​

Tiếp tục, hãy đảm bảo bạn có các yêu cầu sau:

• Máy chủ Rocky Linux 9
• Người dùng không phải root có quyền quản trị viên
• Tên miền trỏ đến địa chỉ IP của máy chủ
• SELinux với trạng thái cho phép
• Tường lửa được bật

Cài đặt PostgreSQL và Nginx​

Trong phần này, bạn sẽ cài đặt các phần phụ thuộc cho Mattermost, bao gồm máy chủ PostgreSQL, máy chủ web Nginx và Certbot. Bạn cũng sẽ thêm kho lưu trữ EPEL và kích hoạt mô-đun kho lưu trữ cho PostgreSQL 16.

Trước tiên, hãy chạy lệnh 'dnf' bên dưới để thêm kho lưu trữ EPEL vào hệ thống của bạn.

sudo dnf install epel-release -y

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22222%22%3E%3C/svg%3E


Sau đó kích hoạt mô-đun kho lưu trữ PostgreSQL 16 bằng lệnh sau.

sudo dnf module enable postgresql:16

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22219%22%3E%3C/svg%3E


Bây giờ hãy cài đặt các phần phụ thuộc như PostgreSQL, máy chủ web Nginx và Certbot làm phần phụ thuộc cho Mattermost. Nhập 'Y' để xác nhận cài đặt.

sudo dnf install postgresql-server postgresql-contrib nginx certbot wget curl

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22278%22%3E%3C/svg%3E


Đối với máy chủ PostgreSQL, để máy chủ hoạt động, hãy thực hiện lệnh bên dưới để khởi tạo dữ liệu PostgreSQL thư mục.

sudo /usr/bin/postgresql-setup --initdb

Tiếp theo, chạy lệnh 'systemctl' bên dưới để khởi động và kích hoạt dịch vụ 'postgresql'. Sau đó, hãy xác minh để đảm bảo PostgreSQL đang chạy.

sudo systemctl enable --now postgresql
sudo systemctl status postgresql

Đầu ra sau đây cho thấy máy chủ PostgreSQL đã được bật và đang chạy.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22208%22%3E%3C/svg%3E


Cuối cùng, hãy khởi động và bật máy chủ web Nginx bằng lệnh bên dưới. Sau đó, hãy kiểm tra dịch vụ Nginx.

sudo systemctl enable --now nginx
sudo systemctl status nginx

Như bạn thấy trong hình sau, Nginx đang chạy và được bật.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22218%22%3E%3C/svg%3E

Mở HTTP và HTTPS ports​

Sau khi các dependency được cài đặt, bạn cần mở cả hai cổng HTTP và HTTPS trên hệ thống của mình. Trên Rocky Linux, bạn sẽ sử dụng firewalld, được quản lý thông qua tiện ích 'firewall-cmd'.

Mở cả hai dịch vụ HTTP và HTTPS trên firewalld bằng lệnh 'firewall-cmd' bên dưới. Sau khi thêm, bạn sẽ thấy đầu ra 'thành công'.

sudo firewall-cmd --add-service={http,https} --permanent

Bây giờ hãy tải lại firewalld bằng lệnh sau để áp dụng các quy tắc mới.

sudo firewall-cmd --reload

Cuối cùng, hãy kiểm tra các quy tắc trên firewalld của bạn bằng lệnh bên dưới. Bạn sẽ thấy cả dịch vụ HTTP và HTTPS đều được bật trong firewalld.

sudo firewall-cmd --list-all

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22276%22%3E%3C/svg%3E

Tạo người dùng và cơ sở dữ liệu PostgreSQL​

Trong phần này, bạn sẽ thiết lập Phương pháp xác thực PostgreSQL thành 'scram-sha-256', sau đó tạo một cơ sở dữ liệu và người dùng mới sẽ được Mattermost sử dụng thông qua 'psql' hoặc shell PostgreSQL.

Để thay đổi phương pháp xác thực mật khẩu mặc định, hãy mở cấu hình PostgreSQL '/var/lib/pgsql/data/pg_hba.conf' bằng trình soạn thảo 'nano'.

sudo nano /var/lib/pgsql/data/pg_hba.conf

Thay đổi phương thức xác thực mặc định cho các kết nối localhost bằng 'scram-sha-256' như sau:

# TYPE DATABASE USER ADDRESS METHOD

# "local" is for Unix domain socket connections only
local all all peer
# IPv4 local connections:
host all all 127.0.0.1/32 scram-sha-256
# IPv6 local connections:
host all all ::1/128 scram-sha-256

Lưu tệp và thoát khỏi trình chỉnh sửa.

Bây giờ hãy chạy lệnh 'systemctl' bên dưới để khởi động lại PostgreSQL và áp dụng các thay đổi của bạn.

sudo systemctl restart postgresql

Sau PostgreSQL đã được cấu hình, bạn sẽ tạo một cơ sở dữ liệu và người dùng mới cho Mattermost.

Đăng nhập vào máy chủ PostgreSQL bằng lệnh 'psql' bên dưới.

sudo -u postgres psql

Bây giờ hãy chạy các truy vấn sau để tạo một cơ sở dữ liệu mới 'mattermost', một người dùng mới 'mmuser' với mật khẩu 'mật khẩu'.

CREATE DATABASE mattermost;
CREATE USER mmuser WITH PASSWORD 'password';
GRANT ALL ON DATABASE mattermost TO mmuser;
ALTER DATABASE mattermost OWNER TO mmuser;
GRANT USAGE, CREATE ON SCHEMA PUBLIC TO mmuser;

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22625%22%20height=%22318%22%3E%3C/svg%3E


Kiểm tra danh sách cơ sở dữ liệu và người dùng trong PostgreSQL của bạn bằng lệnh sau - Bạn sẽ thấy cơ sở dữ liệu 'mattermost' và người dùng 'mmuser' là đã tạo.

\l
\du

Gõ 'quit' để thoát khỏi máy chủ PostgreSQL.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22393%22%3E%3C/svg%3E


Tiếp theo, chạy lệnh 'psql' bên dưới để đăng nhập vào máy chủ PostgreSQL bằng 'mmuser' vào cơ sở dữ liệu 'mattermost'. Nhập mật khẩu khi được nhắc.

sudo -u postgres psql --host=localhost --dbname=mattermost --username=mmuser --password

Nếu thành công, hãy kiểm tra trạng thái kết nối bằng truy vấn sau. Bạn sẽ thấy rằng bạn đã kết nối với cơ sở dữ liệu 'mattermost' bằng cách sử dụng 'mmuser'.

\conninfo

Cuối cùng, nhập 'quit' để thoát.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22146%22%3E%3C/svg%3E

Tải xuống Mattermost​

Bây giờ bạn đã cấu hình PostgreSQL, bạn sẽ tạo một người dùng mới, tải xuống mã nguồn Mattermost, sau đó cấu hình thư mục cài đặt Mattermost.

Trước khi tải xuống Mattermost, hãy chạy lệnh bên dưới để thêm người dùng mới 'mattermost' vào hệ thống của bạn.

sudo useradd --system --user-group mattermost

Tải xuống mã nguồn Mattermost bằng lệnh 'wget' và giải nén bằng lệnh 'tar' bên dưới. Mã nguồn Mattermost sẽ được giải nén vào thư mục 'mattermost'.

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

Di chuyển thư mục 'mattermost' đến '/opt' và tạo một thư mục 'data' mới ở trên cùng. Trong trường hợp này, Mattermost sẽ được cài đặt trong thư mục '/opt/mattermost'.

mv mattermost /opt/
mkdir -p /opt/mattermost/data

Cuối cùng, hãy chạy lệnh sau để thay đổi quyền sở hữu thư mục '/opt/mattermost' thành người dùng 'mattermost'. Ngoài ra, hãy đảm bảo rằng nhóm 'mattermost' có quyền truy cập đọc và ghi.

sudo chown -R mattermost:mattermost /opt/mattermost
sudo chmod g+rw /opt/mattermost

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22721%22%20height=%22180%22%3E%3C/svg%3E

Cấu hình Mattermost bằng PostgreSQL​

Trong phần này, bạn sẽ cấu hình Mattermost bằng PostgreSQL. Bạn sẽ chỉnh sửa tệp cấu hình Mattermost '/opt/mattermost/config/config.json', thiết lập tên miền cho Mattermost, sau đó thêm cơ sở dữ liệu PostgreSQL của bạn vào Mattermost.

Mở cấu hình Mattermost mặc định '/opt/mattermost/config/config.json' bằng trình chỉnh sửa 'nano'.

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

Thay đổi 'SiteURL' mặc định bằng tên miền Mattermost của bạn. Trong trường hợp này, chúng tôi sẽ sử dụng tên miền 'https://space.howtoforge.local'.

"ServiceSettings": {
 "SiteURL": "https://mattermost.howtoforge.local",

Di chuyển đến phần 'SqlSettings' và thay đổi cấu hình cơ sở dữ liệu như sau. Đảm bảo điều chỉnh tên cơ sở dữ liệu, người dùng và mật khẩu.

"SqlSettings": {
 "DriverName": "postgres",
 "DataSource": "postgres://mmuser:password@localhost/mattermost?sslmode=disable\u0026connect_timeout=10\u0026binary_parameters=yes",

Khi hoàn tất, hãy lưu tệp và thoát khỏi trình chỉnh sửa.

Chạy Mattermost dưới dạng dịch vụ systemd​

Bây giờ bạn đã tích hợp Mattermost với PostgreSQL, bạn sẽ tạo tệp dịch vụ mới cho Mattermost. Điều này cho phép bạn chạy Mattermost ở chế độ nền và quản lý Mattermost dễ dàng thông qua dòng lệnh 'systemctl'.

Tạo tệp dịch vụ systemd mới '/etc/systemd/system/mattermost.service' bằng trình soạn thảo 'nano'.

sudo nano /etc/systemd/system/mattermost.service

Chèn cấu hình sau để chạy Mattermost dưới dạng systemd dịch vụ.

[Unit]
Description=Mattermost
After=network.target
After=postgresql.service
BindsTo=postgresql.service

[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

Lưu và thoát khỏi tệp.

Bây giờ hãy chạy lệnh 'systemctl' bên dưới để tải lại trình quản lý systemd và áp dụng dịch vụ 'mattermost' mới.

sudo systemctl daemon-reload

Sau khi systemd được tải lại, hãy chạy lệnh 'systemctl' sau để bắt đầu và bật dịch vụ 'mattermost'. Sau đó, hãy xác minh để đảm bảo rằng dịch vụ đang chạy.

sudo systemctl enable --now mattermost
sudo systemctl status mattermost

Nếu mọi thứ diễn ra tốt đẹp, bạn sẽ thấy cấu hình cho thấy dịch vụ 'mattermost' đang chạy và được bật như sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22363%22%3E%3C/svg%3E

Thiết lập Nginx làm proxy ngược​

Lúc này, Mattermost đã hoạt động trên máy chủ Rocky Linux của bạn. Để có thể truy cập được, bạn sẽ thiết lập Nginx làm proxy ngược với HTTPS an toàn được bật.

Trước khi cấu hình máy chủ web Nginx, hãy chạy lệnh sau để dừng dịch vụ Nginx và tạo chứng chỉ SSL từ letsencrypt. Hãy đảm bảo thay đổi tên miền và địa chỉ email bằng thông tin của bạn.

sudo systemctl stop nginx
sudo certbot --certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m [emailprotected] -d space.howtoforge.local

Sau khi quá trình hoàn tất, chứng chỉ SSL của bạn sẽ có trong thư mục '/etc/letsencrypt/live/domain.com'.

Tiếp theo, tạo cấu hình Nginx mới '/etc/nginx/conf.d/mattermost.conf' bằng cách sử dụng 'nano' biên tập viên.

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

Chèn cấu hình sau và đảm bảo thay đổi tên miền và đường dẫn của chứng chỉ SSL bằng thông tin của bạn.

upstream backend {
server 127.0.0.1:8065;
keepalive 32;
}

server {
listen 80;
server_name space.howtoforge.local;
return 301 https://$server_name$request_uri;
}

server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name space.howtoforge.local;

http2_push_preload on; # Enable HTTP/2 Server Push

ssl_certificate /etc/letsencrypt/live/mattermost.howtoforge.local/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/mattermost.howtoforge.local/privkey.pem;
ssl_session_timeout 1d;

# Enable TLS versions (TLSv1.3 is required upcoming HTTP/3 QUIC).
ssl_protocols TLSv1.2 TLSv1.3;

# Enable TLSv1.3's 0-RTT. Use $ssl_early_data when reverse proxying to
# prevent replay attacks.
#
# @see: https://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_early_data
ssl_early_data on;

ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:50m;
# HSTS (ngx_http_headers_module is required) (15768000 seconds = six months)
add_header Strict-Transport-Security max-age=15768000;
# OCSP Stapling ---
# fetch OCSP records from URL in ssl_certificate and cache them
ssl_stapling on;
ssl_stapling_verify on;

add_header X-Early-Data $tls1_3_early_data;

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

location / {
client_max_body_size 100M;
proxy_set_header Connection "";
proxy_set_header Host $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_http_version 1.1;
proxy_pass http://backend;
}
}

# This block is useful for debugging TLS v1.3. Please feel free to remove this
# and use the '$ssl_early_data' variable exposed by NGINX directly should you
# wish to do so.
map $ssl_early_data $tls1_3_early_data {
"~." $ssl_early_data;
default "";
}

Lưu tệp và thoát khỏi trình chỉnh sửa khi bạn hoàn tất.

Tiếp theo, chạy lệnh 'nginx' bên dưới để xác minh cú pháp Nginx của bạn. Nếu bạn có cú pháp đúng, bạn sẽ thấy đầu ra 'cú pháp là ok - thử nghiệm là thành công'.

sudo nginx -t

Cuối cùng, hãy chạy lệnh 'systemctl' bên dưới để khởi động lại dịch vụ Nginx và áp dụng các thay đổi của bạn.

sudo systemctl restart nginx

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22691%22%20height=%22185%22%3E%3C/svg%3E

Tạo không gian làm việc đầu tiên với Mattermost​

Mở trình duyệt web của bạn và truy cập cài đặt Mattermost như 'https://space.howtoforge.local'. Nếu cài đặt thành công, bạn sẽ thấy trình hướng dẫn cài đặt.

Nhấp vào nút 'Xem trong trình duyệt' để thiết lập Mattermost thông qua trình duyệt web.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22345%22%3E%3C/svg%3E


Nhập tên người dùng quản trị mới, địa chỉ email và mật khẩu, sau đó nhấp vào 'Tạo tài khoản' để tiếp tục.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22451%22%3E%3C/svg%3E


Nhập tên tổ chức của bạn.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22288%22%3E%3C/svg%3E


Hiện tại, bạn có thể bỏ qua việc tích hợp với các ứng dụng của bên thứ ba.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22351%22%3E%3C/svg%3E


Bây giờ hãy nhấp vào 'Hoàn tất thiết lập' để hoàn tất cài đặt Mattermost.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22426%22%3E%3C/svg%3E


Sau khi hoàn tất, bạn sẽ được chuyển hướng đến không gian làm việc Mattermost đầu tiên của mình.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22366%22%3E%3C/svg%3E

Kết luận​

Xin chúc mừng! Bạn đã hoàn tất cài đặt Mattermost trên máy chủ Rocky Linux 9. Bạn đã chạy Mattermost ở chế độ nền như một dịch vụ systemd với PostgreSQL làm cơ sở dữ liệu và Nginx làm proxy ngược. Bạn cũng đã bảo mật Mattermost bằng HTTPS và tạo không gian làm việc đầu tiên của mình trong Mattermost. Từ đây, bạn có thể tích hợp Mattermost với các ứng dụng của bên thứ ba như GitHub, GitLab và Bitbucket.