Cómo instalar Jupyter Notebook con proxy Nginx en Debian 12

Jupyter es una aplicación web gratuita y de código abierto para la computación interactiva y la ciencia de datos. Jupyter admite todos los lenguajes de programación y proporciona múltiples software, como JupyterLab, que ofrece un entorno de edición de múltiples cuadernos con muchas funciones y pestañas, Notebook como una autoría de cuadernos ligera y simplificada, Qtconsole, y muchos más.

En este tutorial, aprenderás a instalar Jupyter y configurar Jupyter Notebook en el servidor Debian 12. También asegurarás Jupyter Notebook con una contraseña y ejecutarás Jupyter Notebook como un servicio systemd. Por último, instalarás y configurarás Nginx como un proxy inverso para la instalación de Jupyter Notebook.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Debian 12
• Un usuario no root con privilegios de administrador
• Un nombre de dominio apuntado a la dirección IP del servidor

Instalando paquetes de Python

Antes de instalar Jupyter, debes instalar Python, el gestor de paquetes Pip de Python, venv para crear un entorno virtual de Python, y git. En esta sección, instalarás esos paquetes con el gestor de paquetes APT.

Para comenzar, ejecuta el siguiente comando para actualizar tu índice de paquetes de Debian.

sudo apt update

Ahora instala Python y dependencias como Pip, venv y el paquete Python Dev. Ingresa ‘ Y ‘ para confirmar la instalación.

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

Después de que la instalación haya finalizado, ejecuta el comando ‘ pip3 ‘ a continuación para actualizar tu versión de Pip.

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

Ahora verifica la versión de Python y Pip con el siguiente comando.

python3 --version  
pip3 --version

Puedes ver a continuación que Python 3.11 y Pip 24.3 están instalados.

Configurando el entorno virtual de Python

Después de haber instalado Python y otras dependencias, crearás un nuevo entorno virtual de Python para la instalación de Jupyter. Con esto, tu instalación de Jupyter estará aislada en el entorno virtual. Además, necesitas un usuario de Linux dedicado, así que asegúrate de tener tu usuario listo.

Inicia sesión en tu usuario con el siguiente comando.

su - username

Ejecuta el comando ‘ python3 ‘ a continuación para crear un nuevo entorno virtual de Python ‘ venv ‘. Esto instalará Python y Pip en tu entorno virtual, que es separado de tu sistema.

python3 -m venv venv

Activa el entorno virtual de Python ‘ venv ‘. Una vez activado, tu símbolo del sistema se convertirá en ‘ (venv) username@host … ‘.

source venv/bin/activate

Si deseas desactivar ‘ venv ‘, ejecuta el comando ‘ deactivate ‘ a continuación.

deactivate

Instalando Jupyter

Ahora que has creado y activado el entorno virtual de Python, puedes comenzar la instalación de Jupyter a través del gestor de paquetes Pip de Python.

Para instalar Jupyter, ejecuta el comando ‘ pip3 ‘ a continuación.

pip3 install jupyter

Puedes ver a continuación la instalación de Jupyter en un entorno virtual.

Una vez que la instalación esté completa, verifica la versión de Jupyter con el siguiente comando.

jupyter --version

En la salida siguiente, puedes ver la versión de cada componente de Jupyter que está instalado.

Habilitar autenticación en Jupyter Notebook

Después de haber instalado Jupyter, configurarás la instalación de Jupyter Notebook habilitando la autenticación por contraseña.

Primero, ejecuta el siguiente comando para generar la configuración para Jupyter Notebook. Esto generará una nueva configuración en ‘ ~/.jupyter/jupyter_notebook_config.py ‘.

jupyter notebook --geenrate-config

Ahora configura la contraseña para Jupyter Notebook usando el siguiente comando. Ingresa tu contraseña cuando se te pida y repítela.

jupyter notebook password

Por último, ejecuta el comando ‘ deactivate ‘ para cerrar sesión en el entorno virtual ‘venv’.

deactivate

Ejecutando Jupyter Notebook como un servicio Systemd

En esta sección, crearás un nuevo servicio systemd que ejecutará Jupyter Notebook. Con esto, Jupyter Notebook se ejecutará en segundo plano como un servicio systemd, y podrás gestionarlo fácilmente con la utilidad ‘ systemctl ‘.

Crea un nuevo archivo de servicio systemd ‘ /etc/systemd/system/jupyter.service ‘ con el siguiente editor ‘ nano ‘.

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

Inserta la configuración a continuación para ejecutar Jupyter Notebook como un servicio 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

Guarda el archivo y sal del editor.

Ahora ejecuta el comando ‘ systemctl ‘ a continuación para reiniciar el gestor systemd y aplicar tus cambios.

sudo systemctl daemon-reload

Por último, inicia y habilita el servicio ‘ jupyter ‘ con el siguiente comando.

sudo systemctl enable --now jupyter  
sudo systemctl status jupyter

En la salida siguiente, puedes ver que el servicio ‘ jupyter ‘ se está ejecutando en tu sistema.

Permitiendo acceso remoto a Jupyter Notebook

En esta sección, habilitarás el acceso remoto a Jupyter. Esto debe hacerse si deseas configurar un proxy inverso frente a tu instalación de Jupyter.

Inicia sesión en tu usuario y abre la configuración de Jupyter ‘~/.jupyter/jupyter_notebook_config.py’ con el siguiente editor ‘nano’.

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

Para habilitar el acceso remoto, descomenta la opción ‘ c.ServerApp.allow_remote_access ‘ y cambia el valor a ‘ True ‘.

c.ServerApp.allow_remote_access = True

Guarda y sal del archivo cuando termines.

A continuación, ejecuta el comando ‘ systemctl ‘ a continuación para reiniciar el servicio ‘ jupyter ‘ y aplicar tus cambios. Con esto, se generará un nuevo token que se puede encontrar en el archivo de registro.

sudo systemctl restart jupyter

Por último, verifica el estado del servicio ‘ jupyter ‘ con el siguiente comando.

sudo systemctl status jupyter

Mira la parte inferior del mensaje y copia el token generado para Jupyter Notebook.

Configurando Nginx como un proxy inverso

Ahora que Jupyter Notebook se está ejecutando como un servicio, el siguiente paso es instalar Nginx y configurarlo como un proxy inverso para Jupyter Notebook. De esta manera, puedes asegurar fácilmente Jupyter Notebook con HTTPS.

Instala el paquete ‘ nginx ‘ con el comando ‘ apt ‘ a continuación.

sudo apt install nginx -y

Después de que la instalación esté completa, crea una nueva configuración de bloque de servidor Nginx ‘ /etc/nginx/sites-available/jupyter ‘ con el siguiente editor ‘ nano ‘.

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

Inserta la configuración a continuación para configurar Nginx como un proxy inverso para Jupyter Notebook. Asegúrate de cambiar el parámetro ‘ server_name ‘ con tu nombre de 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;  
}  
}

Guarda el archivo y sal del editor.

A continuación, ejecuta el comando a continuación para activar el bloque de servidor ‘ jupyter ‘ y verificar tu configuración de Nginx.

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

Si tienes configuraciones de Nginx adecuadas, verás una salida como ‘ syntax is ok - test is successful ‘.

Por último, ejecuta el comando ‘ systemctl ‘ a continuación para reiniciar el servidor web Nginx y verificar tu estado de Nginx.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx está en ejecución, puedes ver la salida como la siguiente:

Accediendo a Jupyter Notebook

Abre tu navegador web y visita el nombre de dominio de tu instalación de Jupyter Notebook, como http://lab.howtoforge.local/. Si tu instalación es exitosa, se te pedirá la autenticación por contraseña de Jupyter.

Ingresa tu contraseña y haz clic en ‘ Iniciar sesión ‘.

Ahora verás el panel de control de Jupyter Notebook como el siguiente:

Conclusión

¡Felicidades! Has completado la instalación de Jupyter Notebook en el servidor Debian 12. Has instalado Jupyter Notebook y lo has asegurado con autenticación. También has configurado Nginx como un proxy inverso para Jupyter Notebook. Para el siguiente paso, querrás agregar certificados SSL para asegurar Jupyter Notebook e instalar algunas extensiones para ampliar la funcionalidad de Jupyter Notebook.