wiki.js sur Debian
Un moteur de Wiki moderne qui supporte le markdown ...
Node.js + Yarn
Node.js
Mise à jour dépôt debian pour la version 12 de node
1
2
sudo apt-get install curl software-properties-common
curl -sL https://deb.nodesource.com/setup_12.x | sudo bash -
Installez Node.js sur Debian
1
sudo apt install -y nodejs
outils de développement pour créer des addons natifs
1
sudo apt install gcc g++ make
Versions
1
2
3
node -v && npm -v
v12.10.0
6.10.3
Installer la dernière version npm
1
2
sudo npm install -g npm@latest
npm -v # affiche la version : 6.11.3
Yarn
Installer yarn sur debian
Exécutez les commandes suivantes pour importer la clé gpg et configurer le référentiel yarn apt.
1
2
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
Tapez ensuite les commandes suivantes pour installer yarn sur Ubuntu Debian et Linux.
1
sudo apt-get update && sudo apt-get install yarn
Wiki.js
Configuration requise pour le serveur
Wiki.js fonctionne sur pratiquement tous les systèmes où Node.js est supporté. Cela signifie qu’il fonctionne sous Linux, macOS, Windows ainsi que sur des solutions de conteneurs telles que Docker / Kubernetes et Heroku.
- UNITÉ CENTRALE : Wiki.js fonctionne parfaitement bien sur un seul noyau CPU. Cependant, 2 noyaux ou plus sont recommandés pour utiliser pleinement les travailleurs de fond.
- MÉMOIRE VIVE : Les systèmes Linux doivent avoir au moins 1 Go de RAM pour exécuter Wiki.js. Les systèmes Windows et MacOS nécessitent généralement un peu plus de RAM.
- Stockage : Les exigences de stockage sont basées sur le contenu que vous allez saisir. Les wikis qui se composent presque exclusivement de texte ne sont pas susceptibles de dépasser quelques mégaoctets. Toutefois, dès que vous téléchargez des images, des vidéos ou d’autres fichiers, vous devez planifier vos besoins de stockage en conséquence.
- Accès Internet : Wiki.js vérifiera automatiquement les nouvelles mises à jour, langues, thèmes, etc. de temps en temps. Vous pouvez en savoir plus sur les données téléchargées.
Une autre méthode de chargement latéral des fichiers est également disponible si votre environnement est coupé d’Internet. - Applications
- node.js 10.12 ou supérieure
- Database MariaDB 10.2.7 ou supérieure
Configuration nginx
Créer le fichier
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
server {
listen 80;
listen [::]:80;
## redirect http to https ##
server_name wiki.xoyize.xyz;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name wiki.xoyize.xyz;
charset utf-8;
client_max_body_size 50M;
include ssl_params;
include header_params;
# Diffie-Hellmann
ssl_dhparam /etc/ssl/private/dh2048.pem;
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;
}
access_log /var/log/nginx/wiki.xoyize.xyz-access.log;
error_log /var/log/nginx/wiki.xoyize.xyz-error.log;
}
Vérifier et relancer nginx
1
2
sudo nginx-t
sudo systemctl reload nginx
Installation wiki.js
Téléchargez la dernière version de Wiki.js
1
wget https://github.com/Requarks/wiki/releases/download/2.0.0-beta.303/wiki-js.tar.gz
Extraire le paquet dans un dossier
1
2
3
mkdir ~/wikijs
tar xzf wiki-js.tar.gz -C ~/wikijs
cd ~/wikijs
Renommer l’exemple de fichier de configuration en config.yml
1
mv config.sample.yml config.yml
Editez le fichier de configuration et remplissez les paramètres de votre base de données, redis et port
1
nano config.yml
Créer la base wikijs/mariadb avec un utilisateur et mot de passe
1
mysql -u root -p$(cat /etc/mysql/mdp) < "CREATE DATABASE wikijs; GRANT ALL PRIVILEGES ON wikijs.* TO 'wikijs' IDENTIFIED BY 'Mot-de-passe'; FLUSH PRIVILEGES; quit"
Exécutez Wiki.js
1
node server
Attendez d’être invité à ouvrir la page de configuration de votre navigateur.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Loading configuration from /home/admbust/wikijs/config.yml... OK
2019-09-18T08:54:45.123Z [MASTER] info: =======================================
2019-09-18T08:54:45.129Z [MASTER] info: = Wiki.js 2.0.0-beta.303 ==============
2019-09-18T08:54:45.129Z [MASTER] info: =======================================
2019-09-18T08:54:45.129Z [MASTER] info: Initializing...
2019-09-18T08:54:45.760Z [MASTER] info: Connecting to database...
2019-09-18T08:54:45.856Z [MASTER] info: Database Connection Successful [ OK ]
2019-09-18T08:54:50.792Z [MASTER] warn: DB Configuration is empty or incomplete. Switching to Setup mode...
2019-09-18T08:54:50.793Z [MASTER] info: Starting setup wizard...
2019-09-18T08:54:51.138Z [MASTER] info: Starting HTTP server on port 3000...
2019-09-18T08:54:51.138Z [MASTER] info: HTTP Server on port: [ 3000 ]
2019-09-18T08:54:51.147Z [MASTER] info: HTTP Server: [ RUNNING ]
2019-09-18T08:54:51.148Z [MASTER] info: 🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻
2019-09-18T08:54:51.148Z [MASTER] info:
2019-09-18T08:54:51.148Z [MASTER] info: Browse to http://localhost:3000/ to complete setup!
2019-09-18T08:54:51.148Z [MASTER] info:
2019-09-18T08:54:51.148Z [MASTER] info: 🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺
Terminez l’installation sur le lien https://wiki.xoyize.xyz avec utilisateur et mot de passe
Pour arriver sur la page de login https://wiki.xoyize.xyz/login
Page de création
Il faut modifier la langue qui est uniquement en en téléchargeant le module langue fr puis ensuite sélectionner fr comme “locale” (em mode admin sur https://wiki.xoyize.xyz/a/locale)
Exécuter wiki.js comme un service
Nous utilisons systemd car il est disponible dans presque toutes les distributions linux.
- Utilisateur pour le service ,dans notre cas
echo $USER→ admbust - wikijs est installé dans /home/admbust/wikijs
Créer un nouveau fichier nommé wiki.service dans le répertoire /etc/systemd/system
1
sudo nano /etc/systemd/system/wikijs.service
Collez le contenu suivant (en supposant que votre wiki est installé dans /home/admbust/wikijs a vec un utilisateur nommé admbust)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=admbust
Environment=NODE_ENV=production
WorkingDirectory=/home/admbust/wikijs
[Install]
WantedBy=multi-user.target
Sauvegarder le fichier de service (CTRL+X, suivi de Y).
Recharger le système :
1
sudo systemctl daemon-reload
Exécuter le service:
1
sudo systemctl start wikijs
Activer le service au démarrage du système si aucune erreur
1
sudo systemctl enable wikijs
Note : Vous pouvez voir les logs du service en utilisant
journalctl -f -u wikijs