Comment installer Jupyter Notebook avec un proxy Nginx sur Debian 12

Jupyter est une application web gratuite et open-source pour le calcul interactif et la science des données. Jupyter prend en charge tous les langages de programmation et fournit plusieurs logiciels, tels que JupyterLab, qui offre un environnement d’édition multi-notebook riche en fonctionnalités et par onglets, Notebook en tant qu’outil d’édition de notebook léger et simplifié, Qtconsole, et bien d’autres.

Dans ce tutoriel, vous apprendrez à installer Jupyter et à configurer Jupyter Notebook sur le serveur Debian 12. Vous sécuriserez également Jupyter Notebook avec un mot de passe et exécuterez Jupyter Notebook en tant que service systemd. Enfin, vous installerez et configurerez Nginx en tant que proxy inverse pour l’installation de Jupyter Notebook.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12
• Un utilisateur non-root avec des privilèges d’administrateur
• Un nom de domaine pointant vers l’adresse IP du serveur

Installation des paquets Python

Avant d’installer Jupyter, vous devez installer Python, le gestionnaire de paquets Pip, venv pour créer un environnement virtuel Python, et git. Dans cette section, vous installerez ces paquets avec le gestionnaire de paquets APT.

Pour commencer, exécutez la commande ci-dessous pour mettre à jour votre index de paquets Debian.

sudo apt update

Maintenant, installez Python et les dépendances telles que Pip, venv, et le paquet Python Dev. Entrez ‘ Y ‘ pour confirmer l’installation.

sudo apt install python3 python3-pip python3-dev python3-venv git

Après la fin de l’installation, exécutez la commande ‘ pip3 ‘ ci-dessous pour mettre à niveau votre version de Pip.

pip3 install --break-system-package --upgrade pip

Maintenant, vérifiez la version de Python et de Pip avec la commande ci-dessous.

python3 --version  
pip3 --version

Vous pouvez voir ci-dessous que Python 3.11 et Pip 24.3 sont installés.

Configuration de l’environnement virtuel Python

Après avoir installé Python et d’autres dépendances, vous allez créer un nouvel environnement virtuel Python pour l’installation de Jupyter. Avec cela, votre installation de Jupyter sera isolée dans l’environnement virtuel. De plus, vous avez besoin d’un utilisateur Linux dédié, alors assurez-vous que votre utilisateur est prêt.

Connectez-vous à votre utilisateur avec la commande ci-dessous.

su - username

Exécutez la commande ‘ python3 ‘ ci-dessous pour créer un nouvel environnement virtuel Python ‘ venv ‘. Cela installera Python et Pip dans votre environnement virtuel, qui est séparé de votre système.

python3 -m venv venv

Activez l’environnement virtuel Python ‘ venv ‘. Une fois activé, votre invite de shell deviendra comme ‘ (venv) username@host … ‘.

source venv/bin/activate

Si vous souhaitez désactiver ‘ venv ‘, exécutez la commande ‘ deactivate ‘ ci-dessous.

deactivate

Installation de Jupyter

Maintenant que vous avez créé et activé l’environnement virtuel Python, vous pouvez commencer l’installation de Jupyter via le gestionnaire de paquets Pip.

Pour installer Jupyter, exécutez la commande ‘ pip3 ‘ ci-dessous.

pip3 install jupyter

Vous pouvez voir ci-dessous l’installation de Jupyter dans un environnement virtuel.

Une fois l’installation terminée, vérifiez la version de Jupyter avec la commande suivante.

jupyter --version

Dans la sortie suivante, vous pouvez voir la version de chaque composant Jupyter qui est installé.

Activer l’authentification dans Jupyter Notebook

Après avoir installé Jupyter, vous allez configurer l’installation de Jupyter Notebook en activant l’authentification par mot de passe.

Tout d’abord, exécutez la commande ci-dessous pour générer la configuration pour Jupyter Notebook. Cela générera une nouvelle configuration dans ‘ ~/.jupyter/jupyter_notebook_config.py ‘.

jupyter notebook --geenrate-config

Maintenant, configurez le mot de passe pour Jupyter Notebook en utilisant la commande ci-dessous. Entrez votre mot de passe lorsqu’on vous le demande et répétez.

jupyter notebook password

Enfin, exécutez la commande ‘ deactivate ‘ pour vous déconnecter de l’environnement virtuel ‘venv’.

deactivate

Exécution de Jupyter Notebook en tant que service Systemd

Dans cette section, vous allez créer un nouveau service systemd qui exécutera Jupyter Notebook. Avec cela, Jupyter Notebook sera exécuté en arrière-plan en tant que service systemd, et vous pourrez facilement le gérer avec l’utilitaire ‘ systemctl ‘.

Créez un nouveau fichier de service systemd ‘ /etc/systemd/system/jupyter.service ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/systemd/system/jupyter.service

Insérez la configuration ci-dessous pour exécuter Jupyter Notebook en tant que service systemd.

[Unit]  
Description=Jupyter Notebook  
  
[Service]  
Type=simple  
PIDFile=/run/jupyter.pid  
ExecStart=/home/alice/venv/bin/jupyter-notebook --config=/home/alice/.jupyter/jupyter_notebook_config.py --allow-root  
User=root  
Group=root  
WorkingDirectory=/home/alice/venv  
Restart=always  
RestartSec=10  
  
[Install]  
WantedBy=multi-user.target

Enregistrez le fichier et quittez l’éditeur.

Maintenant, exécutez la commande ‘ systemctl ‘ ci-dessous pour redémarrer le gestionnaire systemd et appliquer vos modifications.

sudo systemctl daemon-reload

Enfin, démarrez et activez le service ‘ jupyter ‘ avec la commande ci-dessous.

sudo systemctl enable --now jupyter  
sudo systemctl status jupyter

Dans la sortie suivante, vous pouvez voir que le service ‘ jupyter ‘ est en cours d’exécution sur votre système.

Autoriser l’accès à distance à Jupyter Notebook

Dans cette section, vous allez activer l’accès à distance à Jupyter. Cela doit être fait si vous souhaitez configurer un proxy inverse devant votre installation Jupyter.

Connectez-vous à votre utilisateur et ouvrez la configuration Jupyter ‘~/.jupyter/jupyter_notebook_config.py’ avec l’éditeur ‘nano’ suivant.

su - username  
nano ~/.jupyter/jupyter_notebook_config.py

Pour activer l’accès à distance, décommentez l’option ‘ c.ServerApp.allow_remote_access ‘ et changez la valeur en ‘ True ‘.

c.ServerApp.allow_remote_access = True

Enregistrez et quittez le fichier une fois terminé.

Ensuite, exécutez la commande ‘ systemctl ‘ ci-dessous pour redémarrer le service ‘ jupyter ‘ et appliquer vos modifications. Avec cela, le nouveau jeton sera généré et pourra être trouvé dans le fichier journal.

sudo systemctl restart jupyter

Enfin, vérifiez l’état du service ‘ jupyter ‘ avec la commande suivante.

sudo systemctl status jupyter

Jetez un œil au bas du message et copiez le jeton généré pour Jupyter Notebook.

Configuration de Nginx en tant que proxy inverse

Maintenant que Jupyter Notebook fonctionne en tant que service, l’étape suivante consiste à installer Nginx et à le configurer en tant que proxy inverse pour Jupyter Notebook. De cette façon, vous pouvez facilement sécuriser Jupyter Notebook avec HTTPS.

Installez le paquet ‘ nginx ‘ avec la commande ‘ apt ‘ ci-dessous.

sudo apt install nginx -y

Après la fin de l’installation, créez une nouvelle configuration de bloc de serveur Nginx ‘ /etc/nginx/sites-available/jupyter ‘ avec l’éditeur ‘ nano ‘.

sudo nano /etc/nginx/sites-available/jupyter

Insérez la configuration ci-dessous pour configurer Nginx en tant que proxy inverse pour Jupyter Notebook. Assurez-vous de changer le paramètre ‘ server_name ‘ avec votre nom de domaine.

server {  
listen 80;  
server_name lab.howtoforge.local;  
  
access_log /var/log/nginx/howtoforge.local.access.log;  
error_log /var/log/nginx/howtoforge.local.error.log;  
  
location / {  
proxy_pass http://127.0.0.1:8888;  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_set_header X-Real-IP $remote_addr;  
proxy_set_header Host $http_host;  
proxy_http_version 1.1;  
proxy_redirect off;  
proxy_buffering off;  
proxy_set_header Upgrade $http_upgrade;  
proxy_set_header Connection "upgrade";  
proxy_read_timeout 86400;  
}  
}

Enregistrez le fichier et quittez l’éditeur.

Ensuite, exécutez la commande ci-dessous pour activer le bloc de serveur ‘ jupyter ‘ et vérifier votre configuration Nginx.

sudo ln -s /etc/nginx/sites-available/jupyter /etc/nginx/sites-enabled/  
sudo nginx -t

Si vous avez des paramètres Nginx corrects, vous verrez une sortie telle que ‘ syntax is ok - test is successful ‘.

Enfin, exécutez la commande ‘ systemctl ‘ ci-dessous pour redémarrer le serveur web Nginx et vérifier votre statut Nginx.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx fonctionne, vous pouvez voir la sortie comme suit :

Accéder à Jupyter Notebook

Ouvrez votre navigateur web et visitez le nom de domaine de votre installation Jupyter Notebook tel que http://lab.howtoforge.local/. Si votre installation est réussie, vous serez invité à l’authentification par mot de passe Jupyter.

Entrez votre mot de passe et cliquez sur ‘ Log In ‘.

Maintenant, vous verrez le tableau de bord Jupyter Notebook comme suit :

Conclusion

Félicitations ! Vous avez terminé l’installation de Jupyter Notebook sur le serveur Debian 12. Vous avez installé Jupyter Notebook et sécurisé avec authentification. Vous avez également configuré Nginx en tant que proxy inverse pour Jupyter Notebook. Pour la prochaine étape, vous voudrez ajouter des certificats SSL pour sécuriser Jupyter Notebook et installer quelques extensions pour étendre la fonctionnalité de Jupyter Notebook.