Comment installer DokuWiki avec Nginx et Let’s encrypt SSL sur Debian 10

DokuWiki est un logiciel wikiOpen Source simple à utiliser et très polyvalent qui ne nécessite pas de base de données. Il est adoré par les utilisateurs pour sa syntaxe propre et lisible . La facilité de maintenance, de sauvegarde et d’intégration en fait le favori des administrateurs. Les contrôles d’accès et les connecteurs d’authentification intégrés rendent DokuWiki particulièrement utile dans le contexte de l’entreprise et un grand nombre de plugins fournis par sa communauté dynamique permettent un large éventail de cas d’utilisation au-delà d’un wiki traditionnel. Ce tutoriel te montrera comment installer DokuWiki sur un serveur Debian 10 (buster) récent.

Configuration requise

Assure-toi que ton serveur répond aux exigences suivantes.

  • Logiciel de serveur Web prenant en charge PHP (Apache, NGINX, IIS, Lighttpd, LiteSpeed)
  • PHP version 5.6 ou ultérieure, les versions plus récentes sont fortement recommandées.

Conditions préalables

  • Un système d’exploitation Debian 10 (buster).
  • Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifie ta version de Debian :

lsb_release -ds
# Debian GNU/Linux 10 (buster)

Configure le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mets à jour les paquets (logiciels) de ton système d’exploitation. C’est une première étape essentielle car elle garantit 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 socat bash-completion apt-transport-https

Étape 1 – Installer PHP et les extensions PHP

Installe PHP et les extensions PHP nécessaires :

sudo apt install -y php7.3 php7.3-cli php7.3-fpm php7.3-gd php7.3-xml php7.3-zip

Pour afficher PHP compilé dans des modules, tu peux exécuter :

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifie la version de PHP :

php --version

# PHP 7.3.9-1 (cli) (built: Apr 13 2019 19:05:48) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.3.4, Copyright (c) 1998-2018 Zend Technologies
# with Zend OPcache v7.3.4-2, Copyright (c) 1999-2018, by Zend Technologies

Le service PHP-FPM est automatiquement lancé et activé au redémarrage sur le système Debian 10, il n’est donc pas nécessaire de le lancer et de l’activer manuellement. Nous pouvons passer à l’étape suivante où nous installerons le client acme.sh et obtiendrons les certs SSL.

Étape 2 – Installe le client acme.sh et obtiens le certificat Let’s Encrypt ( facultatif )

Il n’est pas nécessaire de sécuriser ton site avec HTTPS, mais c’est une bonne pratique pour sécuriser le trafic de ton site. Pour obtenir un certificat TLS de Let’s Encrypt, nous allons utiliser le client acme.sh. Acme.sh est un simple logiciel shell UNIX permettant d’obtenir des certificats TLS auprès de Let’s Encrypt sans aucune 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.2

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 --staging aux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tes certificats et tes clés seront dans :

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

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 sur /etc/letsencrypt ré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 certs, quitte l'utilisateur root et retourne à l'utilisateur sudo habituel :

exit

Étape 3 - Installe et configure Nginx

DokuWiki fonctionnera sur tout serveur Web prenant en charge PHP. Dans ce tutoriel, nous utiliserons Nginx. Si tu préfères Apache ou un autre serveur Web, tu peux l'utiliser à la place de Nginx.

Télécharge et installe NGINX à partir du référentiel Debian :

sudo apt install -y nginx

Vérifie la version de Nginx :

sudo nginx -v
# nginx version: nginx/1.14.2

Configure Nginx :

sudo vim /etc/nginx/sites-available/dokuwiki.conf

Copie/colle la configuration Nginx suivante et enregistre-la :

server {

listen [::]:443 ssl;
listen 443 ssl; listen [::]:80; listen 80; # RSA
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
# ECC
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
server_name wiki.example.com; root /var/www/dokuwiki; index index.html index.htm index.php doku.php; client_max_body_size 15M; client_body_buffer_size 128K; location / { try_files $uri $uri/ @dokuwiki; } location ^~ /conf/ { return 403; } location ^~ /data/ { return 403; } location ~ /\.ht { deny all; } location @dokuwiki { rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last; rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last; rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last; rewrite ^/(.*) /doku.php?id=$1 last; } location ~ \.php$ { try_files $uri =404; fastcgi_pass unix:/var/run/php/php7.3-fpm.sock; fastcgi_index index.php; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } }

Active la nouvelle configuration dokuwiki.conf en liant le fichier au répertoire sites-enabled:

sudo ln -s /etc/nginx/sites-available/dokuwiki.conf /etc/nginx/sites-enabled/

Vérifie la configuration de Nginx :

sudo nginx -t

Recharge Nginx :

sudo systemctl reload nginx.service

Étape 4 - Installer DokuWiki

Crée un répertoire racine du document :

sudo mkdir -p /var/www/dokuwiki

Navigue jusqu'à la racine du document :

cd /var/www/dokuwiki

Télécharge la dernière version stable de DokuWiki depuis la page de téléchargement de DokuWiki :

sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Décompresse l'archive de DokuWiki :

sudo tar xvf dokuwiki-stable.tgz
sudo rm dokuwiki-stable.tgz
sudo mv dokuwiki-2018-04-22b/* . && mv dokuwiki-2018-04-22b/.* .
sudo rmdir dokuwiki-2018-04-22b/

Change la propriété du répertoire /var/www/dokuwiki pour www-data:

sudo chown -R www-data:www-data /var/www/dokuwiki

Redémarre php7.3-fpm.service:

sudo systemctl restart php7.3-fpm.service

Ouvre le script d'installation de DokuWiki, install.php, dans ton navigateur et installe DokuWiki. Le script d'installation vérifie la disponibilité des fonctions PHP requises et vérifie les autorisations de fichiers nécessaires. Il crée également un compte administrateur initial et une politique ACL initiale. Pour exécuter le programme d'installation, ouvre http://wiki.example.com/install.php dans le navigateur et suis les instructions.

Étape 5 - Accéder à l'interface Web de DokuWiki

Ouvre ton navigateur Web et tape l'URL http://example.com/install.php. Tu seras redirigé vers la page suivante :

Installateur de DikuWiki

Fournis toutes les informations requises comme le nom du superutilisateur, l'email et le mot de passe. Ensuite, clique sur le bouton Enregistrer. Une fois l'installation terminée avec succès, tu devrais voir la page suivante :

Définir le nom d'utilisateur et le mot de passe

Maintenant, clique sur tonnouveau DokuWiki. Tu devrais voir la page suivante :

DokuWiki a été installé avec succès

Maintenant, clique sur le bouton de connexion. Tu seras redirigé vers la page suivante :

Connexion

Maintenant, indique ton nom d'utilisateur et ton mot de passe Admin. Ensuite, clique sur le bouton Connexion. Tu devrais voir le tableau de bord de DokuWiki sur la page suivante :

Bienvenue sur DokuWiki

Après une configuration réussie, supprime le fichier install.php du répertoire racine de DokuWiki :

sudo rm /var/www/dokuwiki/install.php

Félicitations ! Tu as réussi à installer et à configurer DokuWiki sur le serveur Debian 10. Tu peux maintenant créer ton propre site wiki facilement en utilisant DokuWiki.

Vous aimerez aussi...