如何在FreeBSD 12上安装Mailtrain Newsletter应用程序

注:本教程在Vultr VPS上测试通过,如需部署请前往Vultr.com

Mailtrain 是一个基于Node.js和MySQL / MariaDB构建的开源自托管新闻通讯应用程序。 Mailtrain的来源已开启 的GitHub。本指南将向您展示如何在新的FreeBSD 12 Vultr实例上安装Mailtrain。

要求

软件要求:

Node.js v7或更高版本
MySQL v5.5
Nginx的
Redis(可选)

硬件要求:

1个vCPU
1024 MB RAM

在你开始之前

检查FreeBSD版本。

uname -ro
# FreeBSD 12.0-RELEASE

确保您的FreeBSD系统是最新的。

freebsd-update fetch install
pkg update && pkg upgrade -y

安装必要的软件包。

pkg install -y sudo vim unzip wget git bash socat

使用您的首选用户名创建一个新用户帐户(我们将使用 johndoe)。

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): 
# Login group [johndoe]: 
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: 
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: 
# Home directory permissions (Leave empty for default): 
# Use password-based authentication? [yes]: 
# Use an empty password? (yes/no) [no]: 
# Use a random password? (yes/no) [no]: 
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: 
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

跑过 visudo 命令与注释 %wheel ALL=(ALL) ALL,以允许 wheel 组以执行任何命令。

visudo

# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL

现在,使用以下命令切换到新创建的用户 su 命令。

su - johndoe

注意: 更换 johndoe 使用您的用户名。

设置时区。

sudo tzsetup

安装Node.js和npm

安装Node.js和npm。

sudo pkg install -y node10 npm-node10

检查版本。

node -v && npm -v
# v10.15.3
# 6.9.0

安装MariaDB

安装MariaDB。

sudo pkg install -y mariadb102-client mariadb102-server

检查版本。

mysql --version
# mysql  Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1

启动并启用MariaDB。

sudo sysrc mysql_enable="yes" 
sudo service mysql-server start

跑过 mysql_secure_installation 脚本来提高您的MariaDB安装的安全性。

sudo mysql_secure_installation

以root用户身份登录MariaDB。

mysql -u root -p
# Enter password:

创建一个新的MariaDB数据库和用户。记住该新用户的凭据。

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;

安装Nginx

安装Nginx。

sudo pkg install -y nginx

检查版本。

nginx -v
# nginx version: nginx/1.14.2

启用并启动Nginx。

sudo sysrc nginx_enable=yes
sudo service nginx start

sudo vim /usr/local/etc/nginx/mailtrain.conf 并为Mailtrain设置Nginx。

server {

  listen [::]:80;
  listen 80;

  server_name example.com;

  charset utf-8;
  client_max_body_size 50M;


  location / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_next_upstream error timeout http_502 http_503 http_504;
  }

}

保存文件并退出。

现在我们需要包括 mailtrain.conf 在主要 nginx.conf 文件。

sudo vim /usr/local/etc/nginx/nginx.conf 并将以下行添加到 http {} 块。

include mailtrain.conf;

测试配置。

sudo nginx -t

重新加载Nginx。

sudo service nginx reload

安装Mailtrain

创建一个应在其中安装Mailtrain的空文档根文件夹。

sudo mkdir -p /usr/local/www/mailtrain

导航到文档根文件夹。

cd /usr/local/www/mailtrain

更改所有权 /usr/local/www/mailtrain 给用户的文件夹 johndoe

sudo chown -R johndoe:johndoe /usr/local/www/mailtrain

下载并解压缩Mailtrain。

wget https://github.com/Mailtrain-org/mailtrain/archive/master.zip
unzip master.zip
rm master.zip
mv mailtrain-master/* . && mv mailtrain-master/.* .
rmdir mailtrain-master

npm install --production 在Mailtrain文件夹中安装所需的依赖项。

复制 config/default.tomlconfig/production.toml 并更新MySQL及其中的其他设置。

cp config/default.toml config/production.toml
vim config/production.toml

运行服务器。

NODE_ENV=production npm start

安装完成。使用用户名登录 admin 和密码 test。登录后,通过Mailtrain Web界面更新用户信息和密码。

注:本教程在Vultr VPS上测试通过,如需部署请前往Vultr.com