Como Instalar o Jupyter Notebook com Proxy Nginx no Debian 12

Jupyter é uma aplicação web gratuita e de código aberto para computação interativa e ciência de dados. O Jupyter suporta todas as linguagens de programação e fornece múltiplos softwares, como o JupyterLab, que oferece um ambiente de edição multi-notebook rico em recursos e com abas, Notebook como uma autoria de notebook leve e simplificada, Qtconsole, e muitos mais.

Neste tutorial, você aprenderá como instalar o Jupyter e configurar o Jupyter Notebook no servidor Debian 12. Você também irá proteger o Jupyter Notebook com uma senha e executar o Jupyter Notebook como um serviço systemd. Por fim, você instalará e configurará o Nginx como um proxy reverso para a instalação do Jupyter Notebook.

Pré-requisitos

Antes de começar, certifique-se de que você possui o seguinte:

• Um servidor Debian 12
• Um usuário não-root com privilégios de administrador
• Um nome de domínio apontado para o endereço IP do servidor

Instalando Pacotes Python

Antes de instalar o Jupyter, você deve instalar o Python, o gerenciador de pacotes Pip, o venv para criar um ambiente virtual Python e o git. Nesta seção, você instalará esses pacotes com o gerenciador de pacotes APT.

Para começar, execute o comando abaixo para atualizar o índice de pacotes do Debian.

sudo apt update

Agora instale o Python e dependências como Pip, venv e o pacote Python Dev. Digite ‘ Y ‘ para confirmar a instalação.

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

Após a instalação ser concluída, execute o comando ‘ pip3 ‘ abaixo para atualizar sua versão do Pip.

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

Agora verifique a versão do Python e do Pip com o comando abaixo.

python3 --version  
pip3 --version

Você pode ver abaixo que o Python 3.11 e o Pip 24.3 estão instalados.

Configurando o Ambiente Virtual Python

Depois de instalar o Python e outras dependências, você criará um novo ambiente virtual Python para a instalação do Jupyter. Com isso, sua instalação do Jupyter ficará isolada no ambiente virtual. Além disso, você precisa de um usuário Linux dedicado, então certifique-se de que seu usuário está pronto.

Faça login no seu usuário com o comando abaixo.

su - username

Execute o comando ‘ python3 ‘ abaixo para criar um novo Ambiente Virtual Python ‘ venv ‘. Isso instalará o Python e o Pip no seu ambiente virtual, que é separado do seu sistema.

python3 -m venv venv

Ative o ambiente virtual Python ‘ venv ‘. Uma vez ativado, seu prompt de shell se tornará algo como ‘ (venv) username@host … ‘.

source venv/bin/activate

Se você quiser desativar ‘ venv ‘, execute o comando ‘ deactivate ‘ abaixo.

deactivate

Instalando Jupyter

Agora que você criou e ativou o ambiente virtual Python, pode iniciar a instalação do Jupyter através do gerenciador de pacotes Pip Python.

Para instalar o Jupyter, execute o comando ‘ pip3 ‘ abaixo.

pip3 install jupyter

Você pode ver abaixo a instalação do Jupyter em um ambiente virtual.

Uma vez que a instalação esteja completa, verifique a versão do Jupyter com o seguinte comando.

jupyter --version

Na saída a seguir, você pode ver a versão de cada componente do Jupyter que está instalado.

Habilitando Autenticação no Jupyter Notebook

Após instalar o Jupyter, você configurará a instalação do Jupyter Notebook habilitando a autenticação por senha.

Primeiro, execute o comando abaixo para gerar a configuração para o Jupyter Notebook. Isso gerará uma nova configuração para ‘ ~/.jupyter/jupyter_notebook_config.py ‘.

jupyter notebook --geenrate-config

Agora configure a senha para o Jupyter Notebook usando o comando abaixo. Digite sua senha quando solicitado e repita.

jupyter notebook password

Por fim, execute o comando ‘ deactivate ‘ para sair do ambiente virtual ‘venv’.

deactivate

Executando o Jupyter Notebook como um Serviço Systemd

Nesta seção, você criará um novo serviço systemd que executará o Jupyter Notebook. Com isso, o Jupyter Notebook estará rodando em segundo plano como um serviço systemd, e você poderá gerenciá-lo facilmente com a utilidade ‘ systemctl ‘.

Crie um novo arquivo de serviço systemd ‘ /etc/systemd/system/jupyter.service ‘ com o seguinte editor ‘ nano ‘.

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

Insira a configuração abaixo para executar o Jupyter Notebook como um serviço 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

Salve o arquivo e saia do editor.

Agora execute o comando ‘ systemctl ‘ abaixo para reiniciar o gerenciador systemd e aplicar suas alterações.

sudo systemctl daemon-reload

Por fim, inicie e habilite o serviço ‘ jupyter ‘ com o comando abaixo.

sudo systemctl enable --now jupyter  
sudo systemctl status jupyter

Na saída a seguir, você pode ver que o serviço ‘ jupyter ‘ está rodando no seu sistema.

Permitindo acesso remoto ao Jupyter Notebook

Nesta seção, você habilitará o acesso remoto ao Jupyter. Isso deve ser feito se você quiser configurar um proxy reverso na frente da sua instalação do Jupyter.

Faça login no seu usuário e abra a configuração do Jupyter ‘~/.jupyter/jupyter_notebook_config.py’ com o seguinte editor ‘nano’.

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

Para habilitar o acesso remoto, descomente a opção ‘ c.ServerApp.allow_remote_access ‘ e altere o valor para ‘ True ‘.

c.ServerApp.allow_remote_access = True

Salve e saia do arquivo quando terminar.

Em seguida, execute o comando ‘ systemctl ‘ abaixo para reiniciar o serviço ‘ jupyter ‘ e aplicar suas alterações. Com isso, um novo token será gerado e pode ser encontrado no arquivo de log.

sudo systemctl restart jupyter

Por fim, verifique o status do serviço ‘ jupyter ‘ com o seguinte comando.

sudo systemctl status jupyter

Dê uma olhada na parte inferior da mensagem e copie o token gerado para o Jupyter Notebook.

Configurando o Nginx como um proxy reverso

Agora que o Jupyter Notebook está rodando como um serviço, o próximo passo é instalar o Nginx e configurá-lo como um proxy reverso para o Jupyter Notebook. Dessa forma, você pode facilmente proteger o Jupyter Notebook com HTTPS.

Instale o pacote ‘ nginx ‘ com o comando ‘ apt ‘ abaixo.

sudo apt install nginx -y

Após a instalação ser concluída, crie uma nova configuração de bloco de servidor Nginx ‘ /etc/nginx/sites-available/jupyter ‘ com o seguinte editor ‘ nano ‘.

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

Insira a configuração abaixo para configurar o Nginx como um proxy reverso para o Jupyter Notebook. Certifique-se de alterar o parâmetro ‘ server_name ‘ com seu nome de domínio.

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

Salve o arquivo e saia do editor.

Em seguida, execute o comando abaixo para ativar o bloco de servidor ‘ jupyter ‘ e verificar sua configuração do Nginx.

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

Se você tiver configurações adequadas do Nginx, verá uma saída como ‘ syntax is ok - test is successful ‘.

Por fim, execute o comando ‘ systemctl ‘ abaixo para reiniciar o servidor web Nginx e verificar seu status.

sudo systemctl restart nginx  
sudo systemctl status nginx

Se o Nginx estiver rodando, você verá uma saída como a seguinte:

Acessando o Jupyter Notebook

Abra seu navegador web e visite o nome de domínio da sua instalação do Jupyter Notebook, como http://lab.howtoforge.local/. Se sua instalação for bem-sucedida, você será solicitado a autenticação por senha do Jupyter.

Digite sua senha e clique em ‘ Log In ‘.

Agora você verá o painel do Jupyter Notebook como o seguinte:

Conclusão

Parabéns! Você completou a instalação do Jupyter Notebook no servidor Debian 12. Você instalou o Jupyter Notebook e o protegeu com autenticação. Você também configurou o Nginx como um proxy reverso para o Jupyter Notebook. Para o próximo passo, você desejará adicionar certificados SSL para proteger o Jupyter Notebook e instalar algumas extensões para ampliar a funcionalidade do Jupyter Notebook.