Come installare Jupyter Notebook con Nginx Proxy su Debian 12

Jupyter è un’applicazione web gratuita e open-source per il calcolo interattivo e la scienza dei dati. Jupyter supporta tutti i linguaggi di programmazione e fornisce diversi software, come JupyterLab, che offre un ambiente di editing multi-notebook ricco di funzionalità e a schede, Notebook come un’autore di notebook leggero e semplificato, Qtconsole e molti altri.

In questo tutorial, imparerai come installare Jupyter e configurare Jupyter Notebook sul server Debian 12. Imparerai anche a proteggere Jupyter Notebook con una password e a eseguire Jupyter Notebook come servizio systemd. Infine, installerai e configurerai Nginx come proxy inverso per l’installazione di Jupyter Notebook.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

• Un server Debian 12
• Un utente non root con privilegi di amministratore
• Un nome di dominio puntato all’indirizzo IP del server

Installazione dei pacchetti Python

Prima di installare Jupyter, devi installare Python, il gestore di pacchetti Python Pip, venv per creare un ambiente virtuale Python e git. In questa sezione, installerai questi pacchetti con il gestore di pacchetti APT.

Per iniziare, esegui il comando qui sotto per aggiornare l’indice dei pacchetti Debian.

sudo apt update

Ora installa Python e le dipendenze come Pip, venv e il pacchetto Python Dev. Inserisci ‘ Y ‘ per confermare l’installazione.

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

Dopo che l’installazione è terminata, esegui il comando ‘ pip3 ‘ qui sotto per aggiornare la tua versione di Pip.

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

Ora controlla la versione di Python e Pip con il comando qui sotto.

python3 --version  
pip3 --version

Puoi vedere qui sotto che Python 3.11 e Pip 24.3 sono installati.

Configurazione dell’ambiente virtuale Python

Dopo aver installato Python e altre dipendenze, creerai un nuovo ambiente virtuale Python per l’installazione di Jupyter. Con questo, la tua installazione di Jupyter sarà isolata nell’ambiente virtuale. Inoltre, hai bisogno di un utente Linux dedicato, quindi assicurati di avere il tuo utente pronto.

Accedi al tuo utente con il comando qui sotto.

su - username

Esegui il comando ‘ python3 ‘ qui sotto per creare un nuovo ambiente virtuale Python ‘ venv ‘. Questo installerà Python e Pip nel tuo ambiente virtuale, che è separato dal tuo sistema.

python3 -m venv venv

Attiva l’ambiente virtuale Python ‘ venv ‘. Una volta attivato, il tuo prompt della shell diventerà qualcosa come ‘ (venv) username@host … ‘.

source venv/bin/activate

Se vuoi disattivare ‘ venv ‘, esegui il comando ‘ deactivate ‘ qui sotto.

deactivate

Installazione di Jupyter

Ora che hai creato e attivato l’ambiente virtuale Python, puoi iniziare l’installazione di Jupyter tramite il gestore di pacchetti Python Pip.

Per installare Jupyter, esegui il comando ‘ pip3 ‘ qui sotto.

pip3 install jupyter

Puoi vedere qui sotto l’installazione di Jupyter in un ambiente virtuale.

Una volta completata l’installazione, controlla la versione di Jupyter con il seguente comando.

jupyter --version

Nell’output seguente, puoi vedere la versione di ciascun componente Jupyter che è installato.

Abilitare l’autenticazione in Jupyter Notebook

Dopo aver installato Jupyter, configurerai l’installazione di Jupyter Notebook abilitando l’autenticazione con password.

Per prima cosa, esegui il comando qui sotto per generare la configurazione per Jupyter Notebook. Questo genererà una nuova configurazione in ‘ ~/.jupyter/jupyter_notebook_config.py ‘.

jupyter notebook --geenrate-config

Ora imposta la password per Jupyter Notebook utilizzando il comando qui sotto. Inserisci la tua password quando richiesto e ripetila.

jupyter notebook password

Infine, esegui il comando ‘ deactivate ‘ per disconnetterti dall’ambiente virtuale ‘venv’.

deactivate

Esecuzione di Jupyter Notebook come servizio Systemd

In questa sezione, creerai un nuovo servizio systemd che eseguirà Jupyter Notebook. Con questo, Jupyter Notebook verrà eseguito in background come servizio systemd e potrai gestirlo facilmente con l’utilità ‘ systemctl ‘.

Crea un nuovo file di servizio systemd ‘ /etc/systemd/system/jupyter.service ‘ con il seguente editor ‘ nano ‘.

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

Inserisci la configurazione qui sotto per eseguire Jupyter Notebook come servizio 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

Salva il file ed esci dall’editor.

Ora esegui il comando ‘ systemctl ‘ qui sotto per riavviare il gestore systemd e applicare le tue modifiche.

sudo systemctl daemon-reload

Infine, avvia e abilita il servizio ‘ jupyter ‘ con il comando qui sotto.

sudo systemctl enable --now jupyter  
sudo systemctl status jupyter

Nell’output seguente, puoi vedere che il servizio ‘ jupyter ‘ è in esecuzione sul tuo sistema.

Abilitare l’accesso remoto a Jupyter Notebook

In questa sezione, abiliterai l’accesso remoto a Jupyter. Questo deve essere fatto se desideri impostare un proxy inverso davanti alla tua installazione di Jupyter.

Accedi al tuo utente e apri la configurazione di Jupyter ‘~/.jupyter/jupyter_notebook_config.py’ con il seguente editor ‘nano’.

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

Per abilitare l’accesso remoto, decommenta l’opzione ‘ c.ServerApp.allow_remote_access ‘ e cambia il valore in ‘ True ‘.

c.ServerApp.allow_remote_access = True

Salva ed esci dal file quando hai finito.

Successivamente, esegui il comando ‘ systemctl ‘ qui sotto per riavviare il servizio ‘ jupyter ‘ e applicare le tue modifiche. Con questo, verrà generato un nuovo token che può essere trovato nel file di log.

sudo systemctl restart jupyter

Infine, controlla lo stato del servizio ‘ jupyter ‘ con il seguente comando.

sudo systemctl status jupyter

Dai un’occhiata in fondo al messaggio e copia il token generato per Jupyter Notebook.

Impostare Nginx come proxy inverso

Ora che Jupyter Notebook è in esecuzione come servizio, il passo successivo è installare Nginx e configurarlo come proxy inverso per Jupyter Notebook. In questo modo, puoi facilmente proteggere Jupyter Notebook con HTTPS.

Installa il pacchetto ‘ nginx ‘ con il comando ‘ apt ‘ qui sotto.

sudo apt install nginx -y

Dopo che l’installazione è completata, crea una nuova configurazione del blocco server Nginx ‘ /etc/nginx/sites-available/jupyter ‘ con il seguente editor ‘ nano ‘.

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

Inserisci la configurazione qui sotto per impostare Nginx come proxy inverso per Jupyter Notebook. Assicurati di cambiare il parametro ‘ server_name ‘ con il tuo nome di dominio.

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;  
}  
}

Salva il file ed esci dall’editor.

Successivamente, esegui il comando qui sotto per attivare il blocco server ‘ jupyter ‘ e verificare la tua configurazione Nginx.

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

Se hai impostazioni Nginx corrette, vedrai un output come ‘ syntax is ok - test is successful ‘.

Infine, esegui il comando ‘ systemctl ‘ qui sotto per riavviare il server web Nginx e controllare il tuo stato Nginx.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se Nginx è in esecuzione, puoi vedere l’output come il seguente:

Accesso a Jupyter Notebook

Apri il tuo browser web e visita il nome di dominio della tua installazione di Jupyter Notebook come http://lab.howtoforge.local/. Se la tua installazione ha avuto successo, ti verrà richiesta l’autenticazione della password di Jupyter.

Inserisci la tua password e fai clic su ‘ Accedi ‘.

Ora vedrai il dashboard di Jupyter Notebook come il seguente:

Conclusione

Congratulazioni! Hai completato l’installazione di Jupyter Notebook sul server Debian 12. Hai installato Jupyter Notebook e lo hai protetto con autenticazione. Hai anche configurato Nginx come proxy inverso per Jupyter Notebook. Per il prossimo passo, vuoi aggiungere certificati SSL per proteggere Jupyter Notebook e installare alcune estensioni per estendere la funzionalità di Jupyter Notebook.