注:本教程在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 https://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.toml
如 config/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