Mailtrain és una aplicació de butlletins autoallotjada de codi obert construïda a Node.js i MySQL/MariaDB. La font de Mailtrain és a GitHub . Aquesta guia us mostrarà com instal·lar Mailtrain en una nova instància de FreeBSD 12 Vultr.
Requisits
- Requisits de programari:
- Node.js v7 o superior
- MySQL v5.5
- Nginx
- Redis (opcional)
- Requisits de maquinari:
Abans que comencis
Comproveu la versió de FreeBSD.
uname -ro # FreeBSD 12.0-RELEASE
Assegureu-vos que el vostre sistema FreeBSD estigui actualitzat.
freebsd-update fetch install pkg update && pkg upgrade -y
Instal·leu els paquets necessaris.
pkg install -y sudo vim unzip wget git bash socat
Creeu un compte d'usuari nou amb el vostre nom d'usuari preferit (farem servir johndoe).
adduser # Username: johndoe # Full name: John Doe # Uid (Leave empty for default): <Enter> # Login group [johndoe]: <Enter> # Login group is johndoe. Invite johndoe into other groups? []: wheel # Login class [default]: <Enter> # Shell (sh csh tcsh nologin) [sh]: bash # Home directory [/home/johndoe]: <Enter> # Home directory permissions (Leave empty for default): <Enter> # Use password-based authentication? [yes]: <Enter> # Use an empty password? (yes/no) [no]: <Enter> # Use a random password? (yes/no) [no]: <Enter> # Enter password: your_secure_password # Enter password again: your_secure_password # Lock out the account after creation? [no]: <Enter> # OK? (yes/no): yes # Add another user? (yes/no): no # Goodbye!
Executeu l' visudoordre i descomentau %wheel ALL=(ALL) ALL, per permetre que els membres del wheelgrup executin qualsevol ordre.
visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL
Ara, canvieu al vostre usuari acabat de crear amb l' suordre.
su - johndoe
NOTA: Substituïu-lo johndoepel vostre nom d'usuari.
Configura la zona horària.
sudo tzsetup
Instal·leu Node.js i npm
Instal·leu Node.js i npm.
sudo pkg install -y node10 npm-node10
Comproveu les versions.
node -v && npm -v # v10.15.3 # 6.9.0
Instal·leu MariaDB
Instal·leu MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Comproveu la versió.
mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Inicieu i activeu MariaDB.
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Executeu l' mysql_secure_installationscript per millorar la seguretat de la vostra instal·lació de MariaDB.
sudo mysql_secure_installation
Inicieu sessió a MariaDB com a usuari root.
mysql -u root -p # Enter password:
Creeu una nova base de dades i un usuari MariaDB. Recordeu les credencials d'aquest nou usuari.
CREATE DATABASE dbname; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; exit;
Instal·leu Nginx
Instal·leu Nginx.
sudo pkg install -y nginx
Comproveu la versió.
nginx -v # nginx version: nginx/1.14.2
Activeu i inicieu Nginx.
sudo sysrc nginx_enable=yes sudo service nginx start
Executeu sudo vim /usr/local/etc/nginx/mailtrain.confi configureu Nginx per a Mailtrain.
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; } }
Desa el fitxer i surt.
Ara hem d'incloure mailtrain.confal nginx.conffitxer principal .
Executeu sudo vim /usr/local/etc/nginx/nginx.confi afegiu la línia següent al http {}bloc.
include mailtrain.conf;
Proveu la configuració.
sudo nginx -t
Torna a carregar Nginx.
sudo service nginx reload
Instal·leu Mailtrain
Creeu una carpeta arrel del document buida on s'hauria d'instal·lar Mailtrain.
sudo mkdir -p /usr/local/www/mailtrain
Navegueu a la carpeta arrel del document.
cd /usr/local/www/mailtrain
Canvia la propietat de la /usr/local/www/mailtraincarpeta a usuari johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/mailtrain
Baixeu i descomprimiu 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
Executeu npm install --productiona la carpeta Mailtrain per instal·lar les dependències necessàries.
Copieu config/default.tomlcom config/production.tomli actualitzeu MySQL i qualsevol altra configuració que hi hagi.
cp config/default.toml config/production.toml vim config/production.toml
Executeu el servidor.
NODE_ENV=production npm start
La instal·lació s'ha completat. Inicieu sessió amb el nom d'usuari admini la contrasenya test. Un cop iniciat sessió, actualitzeu la informació de l'usuari i la contrasenya mitjançant la interfície web de Mailtrain.