Comment configurer un serveur Leanote sur CentOS 7

• Conditions préalables
• Étape 1: créer un fichier d'échange
• Étape 2: obtenir des fichiers binaires Leanote 2.6.1
• Étape 3: installer MongoDB Community Edition 4.0
• Étape 4: importez les données Leanote initiales dans MongoDB
• Étape 5: activer l'authentification MongoDB
• Étape 6: configurer Leanote
• Étape 7: démarrez Leanote
• Étape 8: activer l'accès HTTPS
• Étape 9: installez le programme wkhtmltopdf
• Étape 10: utilisez Supervisor pour maintenir le script Leanote opérationnel

Leanote est une alternative gratuite, légère et open source à Evernote, qui est écrite en Golang. En pensant à l'expérience utilisateur, Leanote offre aux utilisateurs de nombreuses fonctionnalités pratiques, notamment la prise en charge multiplateforme, l'écriture dans la syntaxe MarkDown, les blogs publics ou privés, la collecte et le partage de connaissances et la collaboration en équipe.

Dans cet article, je vais vous guider à travers la configuration d'un serveur Leanote sur une instance de serveur CentOS 7. Pour des raisons de sécurité, l'activation de l' HTTPS supportutilisation d'un certificat SSL Let's Encrypt et de Nginx sera également couverte.

Conditions préalables

• Une instance de serveur Vultr CentOS 7 récemment déployée. Supposons que son adresse IPv4 soit 203.0.113.1.
• Un utilisateur sudo nommé leanote.
• Tous les progiciels de la machine ont été mis à jour vers le dernier état stable à l'aide du référentiel EPEL YUM. Voir les détails ici .
• Un domaine leanote.example.compointé vers l'instance de serveur mentionnée ci-dessus.

Étape 1: créer un fichier d'échange

Lors du lancement d'une nouvelle instance de serveur Vultr CentOS 7, il est toujours recommandé de configurer un fichier d'échange afin de garantir le bon fonctionnement du système. Par exemple, la création d'un fichier d'échange de 2048 Mo est adaptée à une machine avec 2 Go de mémoire.

sudo dd if=/dev/zero of=/swapfile count=2048 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

Remarque: Si vous utilisez une taille de serveur différente, vous devrez peut-être modifier la taille du fichier d'échange.

Étape 2: obtenir des fichiers binaires Leanote 2.6.1

Téléchargez et extrayez la dernière version stable de Leanote pour système Linux 64 bits:

cd
wget https://sourceforge.net/projects/leanote-bin/files/2.6.1/leanote-linux-amd64-v2.6.1.bin.tar.gz
tar -zxvf leanote-linux-amd64-v2.6.1.bin.tar.gz

Étape 3: installer MongoDB Community Edition 4.0

Comme requis par Leanote, le SGBD MongoDB NoSQL doit être en place avant de pouvoir configurer avec succès un serveur Leanote.

Configurer le repo YUM de MongoDB 4.0

Créez le référentiel MongoDB 4.0 YUM comme suit:

cat <<EOF | sudo tee /etc/yum.repos.d/mongodb-org-4.0.repo
[mongodb-org-4.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/4.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc
EOF

Installer les packages MongoDB 4.0 à l'aide de YUM

Installez tous les composants et outils MongoDB à l'aide du référentiel YUM MongoDB 4.0 créé précédemment:

sudo yum install -y mongodb-org

Configurer SELinux pour MongoDB 4.0

Par défaut, MongoDB utiliserait le 27017port lors du travail, ce qui n'est pas autorisé si SELinux est en enforcingmode sur la machine CentOS 7. Utilisez la commande suivante pour confirmer le mode SELinux actuel:

sudo getenforce

Sur une instance de serveur Vultr CentOS 7, SELinux est désactivé par défaut. Ainsi, la sortie de la commande ci-dessus serait:

Disabled

Dans ce cas, vous pouvez vous sentir libre d'ignorer les instructions suivantes pour configurer SELinux et continuer.

Cependant, si vous exécutez une instance de serveur CentOS 7 d'origine, la sortie de la commande ci-dessus serait Enforcing. Vous devez exécuter l'une des trois options ci-dessous avant de pouvoir démarrer et activer le service MongoDB.

• Option 1: autoriser MongoDB à utiliser le 27017port

  sudo semanage port -a -t mongod_port_t -p tcp 27017
  

• Option 2: désactiver SELinux

  sudo sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
  sudo shutdown -r now
  

• Option 3: changer SELinux en permissivemode

  sudo sed -i 's/SELINUX=enforcing/SELINUX=permissive/' /etc/selinux/config
  sudo shutdown -r now
  

Démarrez le service MongoDB et faites-le démarrer après un redémarrage du système:

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

Étape 4: importez les données Leanote initiales dans MongoDB

Utilisez les commandes ci-dessous pour importer les données Leanote initiales dans MongoDB:

rm /home/leanote/leanote/mongodb_backup/leanote_install_data/.DS_Store
mongorestore --host localhost -d leanote --dir /home/leanote/leanote/mongodb_backup/leanote_install_data/

Étape 5: activer l'authentification MongoDB

Pour des raisons de sécurité, vous devez activer le contrôle d'accès à MongoDB juste après que le service MongoDB est opérationnel. À cette fin, vous devez créer au moins deux comptes d'utilisateurs MongoDB: un compte d'administrateur d'utilisateurs et un compte d'administrateur de base de données. Vous devrez également modifier la configuration de MongoDB.

Entrez dans le shell MongoDB:

mongo --host 127.0.0.1:27017

Basculez vers la adminbase de données:

use admin

Créez un administrateur utilisateur nommé useradminqui utilise un mot de passe useradminpassword:

db.createUser({ user: "useradmin", pwd: "useradminpassword", roles: [{ role: "userAdminAnyDatabase", db: "admin" }] })

Remarque: L'administrateur des utilisateurs useradminest censé gérer tous les utilisateurs de MongoDB, il est donc sage de choisir un mot de passe fort. Bien sûr, une astuce plus sûre consiste à remplacer useradminpar un nom d'utilisateur difficile à deviner.

Basculez vers la leanotebase de données:

use leanote

Créez un administrateur de base de données nommé leanoteadminqui utilise un mot de passe leanoteadminpassword:

db.createUser({ user: "leanoteadmin", pwd: "leanoteadminpassword", roles: [{ role: "dbOwner", db: "leanote" }] })

Remarque : Encore une fois, il est recommandé de choisir un nom d'utilisateur moins connu et un mot de passe difficile à deviner.

Une fois les utilisateurs MongoDB créés, vous pouvez confirmer les résultats:

use admin
db.auth("useradmin", "useradminpassword")

Confirmez l'administrateur de la base de données:

use leanote
db.auth("leanoteadmin", "leanoteadminpassword")

Les deux sortiront 1comme confirmation.

Quittez le shell MongoDB:

exit

Afin d'activer le contrôle d'accès à MongoDB, vous devez également ajouter deux lignes au fichier de configuration MongoDB /etc/mongod.conf, comme suit:

sudo bash -c "echo 'security:' >> /etc/mongod.conf"
sudo bash -c "echo '  authorization: enabled' >> /etc/mongod.conf"

Redémarrez le service MongoDB pour que les modifications prennent effet:

sudo systemctl restart mongod.service

Désormais, vous ne pouvez utiliser les deux comptes utilisateur que pour accéder à MongoDB et le gérer, useradminpour gérer tous les utilisateurs de MongoDB et leanoteadminpour gérer leanoteuniquement la base de données.

Étape 6: configurer Leanote

Sauvegardez le fichier de configuration Leanote /home/leanote/leanote/conf/app.conf:

cd /home/leanote/leanote/conf/
cp app.conf app.conf.bak

Utilisez l' viéditeur pour ouvrir le fichier de configuration Leanote:

vi app.conf

Trouvez les lignes suivantes une par une:

site.url=http://localhost:9000
db.username= # if not exists, please leave it blank
db.password= # if not exists, please leave it blank
app.secret=V85ZzBeTnzpsHyjQX4zukbQ8qqtju9y2aDM55VWxAH9Qop19poekx3xkcDVvrD0y

Remplacez-les, respectivement, comme indiqué ci-dessous:

site.url=http://leanote.example.com:9000
db.username=leanoteadmin
db.password=leanoteadminpassword
app.secret=E52tyCDBRk39HmhdGYJLBS3etXpnz7DymmxkgHBYxd7Y9muWVVJ5QZNdDEaHV2sA

Remarque: Pour des raisons de sécurité, la valeur du app.secretparamètre DOIT être une chaîne aléatoire de 64 bits différente de celle d'origine. Assurez-vous de remplacer la valeur E52tyCDBRk39HmhdGYJLBS3etXpnz7DymmxkgHBYxd7Y9muWVVJ5QZNdDEaHV2sApar votre propre valeur aléatoire 64 bits.

Sauvegarder et quitter:

:wq!

Étape 7: démarrez Leanote

Modifiez les règles de pare-feu afin d'autoriser le trafic TCP entrant sur le port 9000:

sudo firewall-cmd --permanent --add-port=9000/tcp
sudo systemctl reload firewalld.service

Démarrez Leanote en utilisant le script officiel:

cd /home/leanote/leanote/bin
bash run.sh

En voyant Listening on.. 0.0.0.0:9000, pointez votre navigateur Web préféré http://leanote.example.com:9000pour commencer à utiliser le site Leanote.

Utilisez le compte administrateur Leanote par défaut pour vous connecter:

• Nom d'utilisateur: admin
• Mot de passe: abc123

Pour des raisons de sécurité, vous devez modifier le mot de passe par défaut immédiatement après la connexion.

Étape 8: activer l' HTTPSaccès

Pour l'instant, vous pouvez déjà accéder au serveur Leanote en utilisant le protocole HTTP, un protocole moins sécurisé. Afin d'améliorer la sécurité du système, vous pouvez l'activer HTTPSen déployant à la fois un certificat SSL Let's Encrypt et le proxy inverse Nginx sur votre machine.

Configurer correctement un nom d'hôte et un nom de domaine complet (FQDN)

Avant d'obtenir le certificat SSL Let's Encrypt, vous devez configurer correctement le nom d'hôte et le nom de domaine complet sur votre ordinateur.

Tout d'abord, appuyez sur CTRL+ Cpour arrêter le script Leanote run.sh.

Ensuite, configurez le nom d'hôte et le nom de domaine complet comme suit:

sudo hostnamectl set-hostname leanote
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 leanote.example.com leanote
EOF

Vous pouvez également confirmer les résultats:

hostname
hostname -f

Modifier les règles du pare-feu

Bloquer le trafic entrant sur le port 9000et autoriser le trafic entrant sur les ports HTTPet les HTTPSservices:

sudo firewall-cmd --permanent --remove-port=9000/tcp
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

Demander un certificat SSL Let's Encrypt

Installez l'utilitaire Certbot:

sudo yum -y install yum-utils
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
sudo yum install -y certbot

Demandez un certificat SSL Let's Encrypt pour le domaine leanote.example.com:

sudo certbot certonly --standalone --agree-tos --no-eff-email -m [email protected] -d leanote.example.com

Le certificat et la chaîne seront enregistrés comme suit:

/etc/letsencrypt/live/leanote.example.com/fullchain.pem

Le fichier de clé privée sera enregistré comme suit:

/etc/letsencrypt/live/leanote.example.com/privkey.pem

Par défaut, le certificat SSL Let's Encrypt expirera dans trois mois. Vous pouvez configurer un travail cron, comme indiqué ci-dessous, pour renouveler automatiquement vos certificats Let's Encrypt:

sudo crontab -e

Appuyez sur Ipour accéder au insertmode, puis saisissez la ligne suivante:

0 0,12 * * * python -c 'import random; import time; time.sleep(random.random() * 3600)' && certbot renew

Sauvegarder et quitter:

:wq!

Ce travail cron tentera de renouveler le certificat Let's Encrypt tous les jours à midi.

Installer Nginx comme proxy inverse

Installez Nginx à l'aide du dépôt EPEL YUM:

sudo yum install -y nginx

Créez un fichier de configuration pour Leanote:

cat <<EOF | sudo tee /etc/nginx/conf.d/leanote.conf
# Redirect HTTP to HTTPS
server {
    listen      80;
    server_name leanote.example.com;
    return      301 https://\$server_name\$request_uri;
}

server {

    # Setup HTTPS certificates
    listen       443 default ssl;
    server_name  leanote.example.com;
    ssl_certificate      /etc/letsencrypt/live/leanote.example.com/fullchain.pem;
    ssl_certificate_key  /etc/letsencrypt/live/leanote.example.com/privkey.pem;

    # Proxy to the Leanote server
    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 https;
        proxy_set_header X-Forwarded-Host  \$http_host;
        proxy_set_header Host              \$http_host;
        proxy_max_temp_file_size           0;
        proxy_pass                         http://127.0.0.1:9000;
        proxy_redirect                     http:// https://;
    }
}
EOF

Redémarrez Nginx pour appliquer vos modifications:

sudo systemctl daemon-reload
sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

Modifiez le site.urlparamètre dans le fichier de configuration Leanote:

cd /home/leanote/leanote/conf/
vi app.conf

Trouvez la ligne suivante:

site.url=http://leanote.example.com:9000

Remplacer:

site.url=https://leanote.example.com

Sauvegarder et quitter:

:wq!

Exécutez à nouveau le script Leanote:

cd /home/leanote/leanote/bin
bash run.sh

Maintenant, pointez votre navigateur Web préféré sur http://leanote.example.com/et vous constaterez que le HTTPSprotocole est activé automatiquement. Connectez-vous simplement en tant adminqu'utilisateur avec le nouveau mot de passe que vous avez configuré plus tôt ou enregistrez de nouveaux comptes d'utilisateur pour la collaboration d'équipe.

Encore une fois, appuyez sur CTRL+ Cpour arrêter le script Leanote. Nous démoniserons ce script plus tard.

Étape 9: installez le wkhtmltopdfprogramme

Leanote choisit d'utiliser le wkhtmltopdfprogramme pour exporter des pages HTML sous forme de fichiers PDF. Installer wkhtmltopdf:

cd
wget https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm
sudo yum localinstall -y wkhtmltox-0.12.5-1.centos7.x86_64.rpm
which wkhtmltopdf

N'oubliez pas de soumettre le wkhtmltopdfchemin binaire /usr/local/bin/wkhtmltopdfdans la Export PDFsection du tableau de bord d'administration Web Leanote lorsque Leanote est de nouveau opérationnel.

Remarque: Si vous trouvez des caractères illisibles dans les fichiers PDF exportés, vous pouvez essayer de résoudre le problème en ajoutant les fichiers de police requis au /usr/share/fonts/répertoire.

Étape 10: utilisez Supervisor pour maintenir le script Leanote opérationnel

Afin de garder votre site Leanote en ligne, vous pouvez utiliser l'utilitaire Superviseur pour démarrer automatiquement le script Leanote s'il se bloque.

Installez Supervisor à l'aide de YUM:

sudo yum install -y supervisor

Créez un .inifichier Supervisor simple pour Leanote:

cat <<EOF | sudo tee /etc/supervisord.d/leanote.ini
[program:leanote]
command=bash /home/leanote/leanote/bin/run.sh
directory=/home/leanote/leanote/bin/
priority=999
autostart=true
autorestart=true
user=leanote
redirect_stderr=true
EOF

Démarrez le service Superviseur, ainsi que le service Leanote:

sudo supervisord -c /etc/supervisord.conf

Confirmez l'état du service Leanote:

sudo supervisorctl status leanote

La sortie ressemblera à ce qui suit:

leanote                          RUNNING   pid 3707, uptime 0:02:36