Mailtrain er en åpen kildekode, selvdrevet nyhetsbrev-app bygget på Node.js og MySQL/MariaDB. Mailtrains kilde er på GitHub . Denne guiden viser deg hvordan du installerer Mailtrain på en fersk FreeBSD 12 Vultr-forekomst.
Krav
- Programvarekrav:
- Node.js v7 eller nyere
- MySQL v5.5
- Nginx
- Redis (valgfritt)
- Maskinvarekrav:
Før du begynner
Sjekk FreeBSD-versjonen.
uname -ro # FreeBSD 12.0-RELEASE
Sørg for at ditt FreeBSD-system er oppdatert.
freebsd-update fetch install pkg update && pkg upgrade -y
Installer de nødvendige pakkene.
pkg install -y sudo vim unzip wget git bash socat
Opprett en ny brukerkonto med ditt foretrukne brukernavn (vi bruker 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!
Kjør visudokommandoen og avkommenter for %wheel ALL=(ALL) ALLå la medlemmer av wheelgruppen utføre en hvilken som helst kommando.
visudo # Uncomment by removing hash (#) sign # %wheel ALL=(ALL) ALL
Bytt nå til den nyopprettede brukeren med sukommando.
su - johndoe
MERK: Erstatt johndoemed brukernavnet ditt.
Sett opp tidssonen.
sudo tzsetup
Installer Node.js og npm
Installer Node.js og npm.
sudo pkg install -y node10 npm-node10
Sjekk versjonene.
node -v && npm -v # v10.15.3 # 6.9.0
Installer MariaDB
Installer MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Sjekk versjonen.
mysql --version # mysql Ver 15.1 Distrib 10.2.24-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Start og aktiver MariaDB.
sudo sysrc mysql_enable="yes" sudo service mysql-server start
Kjør mysql_secure_installationskriptet for å forbedre sikkerheten til MariaDB-installasjonen.
sudo mysql_secure_installation
Logg inn på MariaDB som root-bruker.
mysql -u root -p # Enter password:
Opprett en ny MariaDB-database og bruker. Husk legitimasjonen for denne nye brukeren.
CREATE DATABASE dbname; GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password'; FLUSH PRIVILEGES; exit;
Installer Nginx
Installer Nginx.
sudo pkg install -y nginx
Sjekk versjonen.
nginx -v # nginx version: nginx/1.14.2
Aktiver og start Nginx.
sudo sysrc nginx_enable=yes sudo service nginx start
Kjør sudo vim /usr/local/etc/nginx/mailtrain.confog sett opp Nginx for 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; } }
Lagre filen og avslutt.
Nå må vi inkludere mailtrain.confi hovedfilen nginx.conf.
Kjør sudo vim /usr/local/etc/nginx/nginx.confog legg til følgende linje i http {}blokken.
include mailtrain.conf;
Test konfigurasjonen.
sudo nginx -t
Last inn Nginx på nytt.
sudo service nginx reload
Installer Mailtrain
Opprett en tom dokumentrotmappe der Mailtrain skal installeres.
sudo mkdir -p /usr/local/www/mailtrain
Naviger til dokumentrotmappen.
cd /usr/local/www/mailtrain
Endre eierskap av /usr/local/www/mailtrainmappen til bruker johndoe.
sudo chown -R johndoe:johndoe /usr/local/www/mailtrain
Last ned og pakk ut 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
Kjør npm install --productioni Mailtrain-mappen for å installere nødvendige avhengigheter.
Kopier config/default.tomlsom config/production.tomlog oppdater MySQL og eventuelle andre innstillinger i den.
cp config/default.toml config/production.toml vim config/production.toml
Kjør serveren.
NODE_ENV=production npm start
Installasjonen er fullført. Logg på med brukernavnet adminog passordet test. Når du er logget på, oppdater brukerinformasjonen og passordet via Mailtrain-nettgrensesnittet.