Comment installer le forum NodeBB sur Debian 9

NodeBB est unlogiciel de forum basé sur Node.js et conçu pour le Web moderne. Ilest construit sur une base de données MongoDB ou Redis.Il utilise des sockets Web pour des interactions instantanées et des notifications en temps réel. NodeBB possède de nombreuses fonctionnalités modernes prêtes à l’emploi, comme l’intégration des réseaux sociaux et les discussions en continu.Des fonctionnalités supplémentaires sont disponibles grâce à l’utilisation de plugins tiers.NodeBB est un projet open source qui se trouve sur Github. Dans ce guide, nous te guiderons pas à pas dans le processus d’installation de NodeBBB sur le système d’exploitation Debian 9 en utilisant Nginx comme proxy inverse, MongoDB comme base de données, et acme.sh et Let’s Encrypt pour HTTPS.

Exigences

NodeBB nécessite l’installation des logiciels suivants :

  • Node.js version 6 ou supérieure
  • MongoDB version 2.6 ou supérieure ouRedis version 2.8.9ou supérieure
  • Nginx version 1.3.13 ou supérieure
  • Git

REMARQUE: L’ installation des dépendances de NodeBB peut nécessiter plus de 512 mégaoctets de mémoire système. Il est recommandé d’activer une partition swap pour compenser si ton système Linux a une mémoire insuffisante.

Conditions préalables

  • Un système Debian 9 en fonctionnement avec au moins 1 Go de RAM.
  • Un nom de domaine avec des enregistrements A/AAAA configurés.
  • Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifie ta version de Debian :

lsb_release -ds

Configure le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mets à jour les paquets de ton système d’exploitation (logiciels). C’est une première étape importante car elle permet de s’assurer que tu disposes des dernières mises à jour et des derniers correctifs de sécurité pour les paquets logiciels par défaut de ton système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installe certains paquets essentiels qui sont nécessaires à l’administration de base du système d’exploitation Debian :

sudo apt install -y curl wget vim git unzip sudo socat bash-completion apt-transport-https

Étape 1 : Installe Node.js et npm

NodeBB est construit sur Node.js. Nous allons installer la versionrecommandée pour NodeBB qui est la version 8au moment où nous écrivons ces lignes. Sous Linux, tu as quelques options d’installation de Node.js : Les binaires Linux (x86/x64), le code source ou via les gestionnaires de paquets. Nous utiliserons l’option Gestionnaire de paquets qui fait de l’installation et de la mise à jour de Node.js un jeu d’enfant.

Télécharge et installe la dernière versionLong-Term Support (LTS) de Node.js depuis le repo NodeSource :

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

Pour compiler et installer les add-ons natifs de npm, tu devras peut-être aussi installer des outils de construction :

sudo apt install -y build-essential

NOTE: npm est distribué avec Node.js – ce qui signifie que lorsque tu télécharges Node.js, tu obtiens automatiquement npm installé sur ton système.

Vérifie les versions de Node.js et de npm sont installés :

node -v && npm -v
# v10.15.1
# 6.4.1

Npm est un projet distinct de Node.js et a tendance à se mettre à jour plus fréquemment. Par conséquent, même si tu viens de télécharger Node.js (et donc npm), tu auras probablement besoin de mettre à jour ton npm. Heureusement, npm sait comment se mettre à jour lui-même ! Pour mettre à jour ton npm, tape ceci dans ton terminal :

sudo npm install -g [email protected]

Cette commande mettra à jour npm à la dernière version stable.

Vérifie à nouveau la version de npm avec :

npm -v
# 6.7.0

Et il devrait renvoyer les derniers numéros de version.

Étape 2 : Installe et configure MongoDB

NodeBB a besoin d’une base de données pour stocker ses données, et il prend en charge MongoDB et Redis. Dans ce tutoriel, nous avons choisi MongoDB comme moteur de stockage de données. Donc, dans les prochaines étapes, nous allons télécharger et installer la base de données MongoDB à partir du dépôt rpm officiel de MongoDB :

Pour installer la version stable du paquet MongoDBdepuis le dépôt officiel MongoDB, lance la commande suivante :

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb https://repo.mongodb.org/apt/debian stretch/mongodb-org/4.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt update
sudo apt install -y mongodb-org

Vérifie la version de MongoDB :

mongo --version | head -n 1 && mongod --version | head -n 1

Démarre et active(configure-le pour qu’il démarre au redémarrage)le service MongoDB :

sudo systemctl start mongod.service
sudo systemctl enable mongod.service

Vérifie l’état du serveur de base de données MongoDB en l’exécutant :

sudo systemctl status mongod.service
# active (running)

Ensuite, crée une base de données MongoDB et un utilisateur pour NodeBB.

Connecte-toi d’abord au serveur MongoDB.

mongo

Passe à la base de données intégrée admin.

> use admin

Crée un utilisateur administratif.

> db.createUser( { user: "admin", pwd: "<Enter a secure password>", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )

REMARQUE : Remplace le caractère générique <Enter a secure password> par le mot de passe que tu as choisi.

Ajoute une nouvelle base de données appelée nodebb.

> use nodebb

La base de données sera créée et le contexte commuté sur nodebb. Ensuite, crée l’utilisateur nodebb avec les privilèges appropriés.

> db.createUser( { user: "nodebb", pwd: "<Enter a secure password>", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

REMARQUE : Encore une fois, remplace le placeholder <Enter a secure password> par le mot de passe que tu as choisi.

Quitte le shell Mongo.

> quit()

Redémarre MongoDB et vérifie que l’utilisateur administratif créé précédemment peut se connecter.

sudo systemctl restart mongodb.service
mongo -u admin -p your_password --authenticationDatabase=admin

Si tout s’est bien passé, ton MongoDB devrait être installé et préparé pour NodeBB. Dans l’étape suivante, nous nous occuperons de l’installation et de la configuration du serveur Web.

Étape 3 – Installe le client acme.sh et obtiens le certificat Lets Encrypt

Cette étape est facultative. Il n’est pas nécessaire de sécuriser ton forum NodeBB avec HTTPS, mais c’est une bonne pratique pour sécuriser le trafic de ton site. Pour obtenir le certificat TLS de Let’s Encrypt, nous allons utiliser le client acme.sh. Acme.sh est un logiciel shell Unix pur pour obtenir des certificats TLS de Let’s Encrypt avec zéro dépendance.

Télécharge et installe acme.sh :

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~

Vérifie la version d’acme.sh :

acme.sh --version
# v2.8.0

Obtiens des certificats RSA et ECC/ECDSA pour ton domaine/nom d’hôte :

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Si tu veux de faux certificats pour les tester, tu peux ajouter le drapeau --stagingaux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tescertificats et tesclés seront dans :

  • Pour RSA: /home/username/example.com répertoire.
  • Pour ECC/ECDSA: /home/username/example.com_ecc répertoire.

Pour répertorier tes certs émis, tu peux exécuter :

acme.sh --list

Crée un répertoire pour stocker tes certs. Nous utiliserons le répertoire/etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Installe/copie les certificats dans/etc/letsencryptrépertoire.

# RSA
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"
# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

Tous les certificats seront automatiquement renouvelés tous les 60 jours.

Après avoir obtenu les certificats, quitte l'utilisateur root et retourne à l'utilisateur normal sudo :

exit

Étape 4 : Installer et configurer Nginx

NodeBB peut fonctionner correctement avec de nombreux serveurs Web. Dans ce tutoriel, nous avons choisi Nginx.

Installe le paquet Nginx, en lançant la commande suivante :

sudo apt install -y nginx

Après l'installation, tu peux vérifier la version de Nginx en exécutant :

nginx -v

Démarre et active(configure-le pour qu'il démarre au redémarrage) le service Nginx :

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

Vérifie l'état du serveur Web Nginx en exécutant :

sudo systemctl status nginx.service
# active (running)

NodeBB fonctionne par défaut sur le port 4567. Pour éviter de taper http://example.com:4567nous allons configurer Nginx comme un proxy inverse pour l'application NodeBB. Chaque requête sur le port 80 ou 443 (si SSL est utilisé) sera transmise au port 4567.

Exécute sudo vim /etc/nginx/conf.d/nodebb.confet configure Nginx comme proxy inverse HTTPS.

server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
listen [::]:80;
listen 80;

server_name example.com;

client_max_body_size 50M;

# RSA
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
# ECDSA
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;

location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:4567;
proxy_redirect off;
# Socket.IO Support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}

}

Vérifie la configuration de Nginx :

sudo nginx -t

Enfin, pour que les changements prennent effet, nous devons recharger Nginx :

sudo systemctl reload nginx.service

Étape 5 : Installer et configurer NodeBB

Crée un répertoire racine de document dans lequel NodeBB doit résider :

sudo mkdir -p /var/www/nodebb

Accède au répertoire racine du document :

cd /var/www/nodebb

Change la propriété du /var/www/nodebbàton_utilisateur.

sudo chown -R [your_user]:[your_user] /var/www/nodebb

REMARQUE :Remplace ton_utilisateur dans la commande ci-dessus par ton utilisateur non racine que tu aurais dû créer comme prérequis pour ce tutoriel..

Clone le dernierdépôtNodeBB dans le dossier racine du document :

git clone -b v1.11.x https://github.com/NodeBB/NodeBB.git .

Lance le script d'installation en exécutant l'application avec l'option setup drapeau. Réponds à chacune des questions :

./nodebb setup

Une fois l'installation de NodeBB terminée, exécute ./nodebb start pour démarrer manuellement ton serveur NodeBB :

./nodebb start

Après avoir exécuté cette commande, tu devrais pouvoir accéder à ton tout nouveau forum dans ton navigateur Web :

NodeBB dans le navigateur

Étape 6 : Exécute NodeBB en tant que service système

Lorsqu'il est démarré via ./nodebb start, NodeBB ne redémarrera pas automatiquement lorsque le système redémarrera. Pour éviter cela, nous devons configurer NodeBB comme un service système.

S'il est en cours d'exécution, arrête NodeBB :

./nodebb stop

Crée un nouvel utilisateur nodebb:

sudo useradd nodebb

Change la propriété du répertoire /var/www/nodebb pour l'utilisateur nodebb:

sudo chown -R nodebb:nodebb /var/www/nodebb

Crée un fichier de configuration de l'unité systemd nodebb.service. Ce fichier d'unité gérera le démarrage du démon NodeBB. Exécute sudo vim /etc/systemd/system/nodebb.service et ajoute le contenu ci-dessous :

[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service

[Service]
Type=forking
User=nodebb

StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb

Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always

[Install]
WantedBy=multi-user.target

REMARQUE : Configure le nom d'utilisateur et les chemins du répertoire en fonction des noms que tu as choisis.

Active nodebb.service au redémarrage et démarre immédiatement nodebb.service:

sudo systemctl enable nodebb.service
sudo systemctl start nodebb.service

Vérifie le statut de nodebb.service:

sudo systemctl status nodebb.service
sudo systemctl is-enabled nodebb.service

Félicitations ! Tu as installé et déployé avec succès la plateforme de discussion NodeBB sur le système Debian 9.Tu devrais pouvoir accéder à ton forum sur ton domaine et interagir avec ton forum.

Liens

Vous aimerez aussi...