如何在Ubuntu 18.04上部署Mattermost
Mattermost是企业级即时消息传递平台,它是开源的自托管Slack替代产品。
它是用Golang和React编写的,可以将MySQL或者PostgreSQL用作数据库后端。
Mattermost将我们所有团队的沟通融合到一处,并提供各种功能,包括文件共享,一对一和群组消息传递,自定义表情符号,视频通话等。
在本教程中,我们将在Mattermost 18.04服务器上安装Mattermost并将Nginx配置为SSL反向代理。
准备工作
在继续本教程之前,请确保我们已满足以下准备工作:
- 我们以具有sudo特权的用户身份登录。
- 我们有一个指向服务器IP地址的域名。在本文中,我们将使用'example.com'。
- 我们已经安装了Nginx,如果没有,请查看本教程。
- 我们已经为域安装了SSL证书。我们可以按照本教程安装免费的Let's Encrypt SSL证书。
创建MySQL数据库
我们将使用MySQL作为Mattermost的数据库。
如果服务器上未安装MySQL或者MariaDB,则可以按照以下说明进行安装。
登录到MySQL Shell:
mysql -u root
使用以下内容为我们的Mattermost安装创建新的数据库和用户:
CREATE DATABASE mattermost;GRANT ALL ON mattermost.* TO mattermost@localhost IDENTIFIED BY 'P4ssvv0rD';
确保我们使用的密码比'P4ssvv0rD'更安全。
创建新的系统用户
创建一个将运行我们的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
将目录所有权更改为“最”用户:
sudo chown -R mattermost: /opt/mattermost
打开“ /opt/mattermost/config/config.json”文件,将数据库驱动程序设置为“ mysql”,然后输入数据库信息:
/opt/mattermost/config/config.json
"SqlSettings": { "DriverName": "mysql", "DataSource": "mattermost:P4ssvv0rD@tcp(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"}
现在,我们可以使用'CTRL + C'停止Mattermost服务器,然后继续下一步。
创建一个系统单位
为了将Mattermost实例作为服务运行,我们将在'/etc/systemd/system /'目录中创建一个'mattermost.service'单元文件。
打开文本编辑器并创建以下文件:
/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 2016-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
配置最重要的
打开浏览器,输入域,我们将被重定向到sugnup页面。
输入电子邮件,选择用户名和密码,然后单击“创建帐户”按钮以创建第一个帐户。
系统中第一个创建的用户将具有管理员权限。
在下一步中,配置向导将要求我们创建一个新团队。
单击“创建新团队”链接,输入第一个团队,然后单击“下一步”按钮。
在下一步中,系统会要求我们选择新团队的网址:
单击“完成”按钮,我们将被重定向到Mattermost仪表板,以管理员身份登录。
打开系统控制台,方法是单击导航面板顶部的用户名,然后在打开的新菜单中单击“系统控制台”链接。
通过转到设置常规→配置来设置站点URL。
要启用电子邮件通知,请转到“通知”→“电子邮件”,将“启用电子邮件通知”的值从“ false”更改为“ true”,然后输入SMTP参数。
我们可以使用任何流行的事务性电子邮件服务,例如SendinBlue,SendGrid,Amazon SES,Mandrill,Mailgun,Mailjet和Postmark,也可以按照本教程设置自己的邮件服务器。
最后,我们需要重新启动Mattermost服务,以使更改生效:
sudo systemctl restart mattermost