Cómo instalar Jupyter Notebook con Nginx Proxy en Debian 12
Jupyter es una aplicación web gratuita y de código abierto para la informática interactiva y la ciencia de datos. Jupyter es compatible con todos los lenguajes de programación y proporciona múltiples programas, como JupyetrLab, que proporciona un entorno de edición multi-notebook rico en funciones y con pestañas, Notebook como creación de cuadernos ligera y simplificada, Qtconsole, y muchos más.
En este tutorial, aprenderás a instalar Jupyter y a configurar Jupyter Notebook en el servidor Debian 12. También protegerá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 proxy inverso para la instalación de Jupyter Notebook.
Requisitos previos
Antes de empezar, asegúrate de que tienes lo siguiente
- Un servidor Debian 12
- Un usuario no root con privilegios de administrador
- Un nombre de dominio apuntando a la dirección IP del servidor
Instalación de paquetes Python
Antes de instalar Jupyter, debes instalar Python, el gestor de paquetes Pip Python, venv para crear un entorno virtual Python, y git. En esta sección, instalarás esos paquetes con el gestor de paquetes APT.
Para empezar, ejecuta el siguiente comando para actualizar el índice de paquetes de Debian.
sudo apt update
Ahora instala Python y sus dependencias, como Pip, venv y el paquete Python Dev. Introduce«Y» para confirmar la instalación.
sudo apt install python3 python3-pip python3-dev python3-venv git
Una vez finalizada la instalación, ejecuta el siguiente comando‘pip3‘ para actualizar tu versión de Pip.
pip3 install --break-system-package --upgrade pip
Ahora comprueba la versión de Python y Pip con el comando que aparece a continuación.
python3 --version pip3 --version
Puedes ver a continuación que Python 3.11 y Pip 24.3 están instalados.
Configurar el entorno virtual de Python
Después de haber instalado Python y otras dependencias, crearás un nuevo entorno virtual 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 Linux dedicado, así que asegúrate de que tienes tu usuario preparado.
Accede a tu usuario con el siguiente comando.
su - username
Ejecuta el comando‘python3‘ que aparece a continuación para crear un nuevo Entorno Virtual Python‘venv‘. Esto instalará Python y Pip en tu entorno virtual, que está separado de tu sistema.
python3 -m venv venv
Activa el entorno virtual Python‘venv‘. Una vez activado, tu intérprete de comandos será como ‘(venv) nombreusuario@host …‘.
source venv/bin/activate
Si quieres desactivar‘venv‘, ejecuta el comando‘desactivar‘ que aparece a continuación.
deactivate
Instalar Jupyter
Ahora que has creado y activado el entorno virtual Python, puedes iniciar la instalación de Jupyter a través del gestor de paquetes Pip Python.
Para instalar Jupyter, ejecuta el comando‘pip3‘ que aparece a continuación.
pip3 install jupyter
A continuación puedes ver la instalación de Jupyter en un entorno virtual.
Una vez finalizada la instalación, comprueba la versión de Jupyter con el siguiente comando.
jupyter --version
En la siguiente salida, puedes ver la versión de cada componente de Jupyter que está instalado.
Habilitar la autenticación en Jupyter Notebook
Una vez que hayas instalado Jupyter, configurarás la instalación de Jupyter Notebook habilitando la autenticación por contraseña.
En primer lugar, ejecuta el siguiente comando para generar la configuración de 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 utilizando el comando que aparece a continuación. Introduce la contraseña cuando se te pida y repite la operación.
jupyter notebook password
Por último, ejecuta el comando«desactivar» para desconectarte del entorno virtual «venv».
deactivate
Ejecutar 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
Introduce la siguiente configuració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‘ que aparece a continuación para reiniciar el gestor systemd y aplicar tus cambios.
sudo systemctl daemon-reload
Por último, inicia y activa el servicio«jupyter» con el comando que aparece a continuación.
sudo systemctl enable --now jupyter sudo systemctl status jupyter
En la siguiente salida, puedes ver que el servicio«jupyter» se está ejecutando en tu sistema.
Permitir el acceso remoto a Jupyter Notebook
En esta sección, habilitarás el acceso remoto a Jupyter. Esto debes hacerlo si quieres configurar un proxy inverso delante de tu instalación de Jupyter.
Accede con 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 el archivo y sal de él cuando hayas terminado.
A continuación, ejecuta el siguiente comando«systemctl» para reiniciar el servicio«jupyter» y aplicar los cambios. Con esto, se generará el nuevo token y podrás encontrarlo en el archivo de registro.
sudo systemctl restart jupyter
Por último, comprueba el estado del servicio«jupyter» con el siguiente comando.
sudo systemctl status jupyter
Echa un vistazo a la parte inferior del mensaje, y copia el token generado para Jupyter Notebook.
Configurar Nginx como proxy inverso
Ahora que Jupyter Notebook se está ejecutando como servicio, el siguiente paso es instalar Nginx y configurarlo como proxy inverso para Jupyter Notebook. De esta forma, podrás asegurar fácilmente Jupyter Notebook con HTTPS.
Instala el paquete‘nginx‘ con el siguiente comando‘apt‘.
sudo apt install nginx -y
Una vez completada la instalación, 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
Introduce la configuración que aparece a continuación para configurar Nginx como proxy inverso para Jupyter Notebook. Asegúrate de cambiar el parámetro‘nombre_servidor‘ por 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 siguiente comando 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 la configuración de Nginx es correcta, verás una salida como‘syntax is ok – test is successful‘.
Por último, ejecuta el siguiente comando‘systemctl‘ para reiniciar el servidor web Nginx y comprobar su estado.
sudo systemctl restart nginx sudo systemctl status nginx
Si Nginx se está ejecutando, podrás ver una salida como la siguiente:
Acceder 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 la instalación se ha realizado correctamente, se te solicitará la autenticación de la contraseña de Jupyter.
Introduce tu contraseña y haz clic en«Iniciar sesión«.
Ahora verás el panel de Jupyter Notebook como el siguiente:
Conclusión
¡Enhorabuena! Has completado la instalación de Jupyter Notebook en el servidor Debian 12. Has instalado Jupyter Notebook y asegurado con autenticación. También has configurado Nginx como proxy inverso para Jupyter Notebook. Para el siguiente paso, quieres añadir certificados SSL para asegurar Jupyter Notebook e instalar algunas extensiones para ampliar la funcionalidad de Jupyter Notebook.