Mailtrain è un'app di newsletter self-hosted open source costruita su Node.js e MySQL / MariaDB. La fonte di Mailtrain è su GitHub . Questa guida ti mostrerà come installare Mailtrain su una nuova istanza di FreeBSD 12 Vultr.
Requisiti
- Requisiti software:
- Node.js v7 o versioni successive
- MySQL v5.5
- nginx
- Redis (opzionale)
- Requisiti hardware:
Prima di iniziare
Controlla la versione di FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE
Assicurati che il tuo sistema FreeBSD sia aggiornato.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installa i pacchetti necessari.
pkg install -y sudo vim unzip wget git bash socat
Crea un nuovo account utente con il tuo nome utente preferito (useremo 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!
Esegui il visudo
comando e il commento %wheel ALL=(ALL) ALL
, per consentire ai membri del wheel
gruppo di eseguire qualsiasi comando.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Ora passa al nuovo utente creato con su
comando.
su - johndoe
NOTA: sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo tzsetup
Installa Node.js e npm
Installa Node.js e npm.
sudo pkg install -y node10 npm-node10
Controlla le versioni.
node -v && npm -v
# v10.15.3
# 6.9.0
Installa MariaDB
Installa MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Controlla la versione
mysql --version
# mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Avviare e abilitare MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Esegui lo mysql_secure_installation
script per migliorare la sicurezza dell'installazione di MariaDB.
sudo mysql_secure_installation
Accedi a MariaDB come utente root.
mysql -u root -p
# Enter password:
Creare un nuovo database e utente MariaDB. Ricorda le credenziali per questo nuovo utente.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;
Installa Nginx
Installa Nginx.
sudo pkg install -y nginx
Controlla la versione
nginx -v
# nginx version: nginx/1.14.2
Abilita e avvia Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Esegui sudo vim /usr/local/etc/nginx/mailtrain.conf
e configura Nginx per 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;
}
}
Salva il file ed esci.
Ora dobbiamo includere mailtrain.conf
nel nginx.conf
file principale .
Esegui sudo vim /usr/local/etc/nginx/nginx.conf
e aggiungi la seguente riga al http {}
blocco.
include mailtrain.conf;
Prova la configurazione.
sudo nginx -t
Ricarica Nginx.
sudo service nginx reload
Installa Mailtrain
Creare una cartella radice dei documenti vuota in cui installare Mailtrain.
sudo mkdir -p /usr/local/www/mailtrain
Passare alla cartella principale del documento.
cd /usr/local/www/mailtrain
Cambia la proprietà della /usr/local/www/mailtrain
cartella in utente johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/mailtrain
Scarica e decomprimi 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
Esegui npm install --production
nella cartella Mailtrain per installare le dipendenze richieste.
Copia config/default.toml
come config/production.toml
e aggiorna MySQL e qualsiasi altra impostazione al suo interno.
cp config/default.toml config/production.toml
vim config/production.toml
Esegui il server.
NODE_ENV=production npm start
L'installazione è completa. Accedi con il nome utente admin
e la password test
. Una volta effettuato l'accesso, aggiorna le informazioni utente e la password tramite l'interfaccia web di Mailtrain.