Как установить JupyterLab на Ubuntu 24.04

JupyterLab — это интерактивная среда разработки с открытым исходным кодом, основанная на веб-технологиях, которая расширяет классический опыт работы с Jupyter Notebook, предоставляя более гибкий и мощный интерфейс для задач в области науки о данных и научных вычислений. Она поддерживает различные языки программирования, с акцентом на Python, и предлагает такие функции, как редактирование кода, визуализация данных и интерактивный вывод в одном интегрированном рабочем пространстве. JupyterLab позволяет пользователям создавать и управлять блокнотами, текстовыми редакторами, терминалами и другими пользовательскими компонентами в виде вкладок, что повышает продуктивность и сотрудничество. На Ubuntu его можно легко установить через менеджеры пакетов, такие как apt, или через установщик пакетов Python pip, что делает его доступным инструментом для разработчиков и исследователей, использующих эту популярную дистрибуцию Linux.

В этом руководстве вы узнаете, как установить Jupyter на Ubuntu 24.04. Вы установите и защитите Jupyter с помощью аутентификации по паролю. Затем вы установите Nginx и настроите его как обратный прокси.

Предварительные требования

Перед тем как начать, убедитесь, что у вас есть следующие требования:

Ubuntu 24.04.
Пользователь, не являющийся root, с правами администратора.
Доменное имя, указывающее на IP-адрес сервера (публичный или частный домен).

Установка зависимостей

В этом разделе вы установите зависимости для Jupyter, которые включают Python, Pip, venv и Node.js. Эти пакеты доступны по умолчанию в репозитории Ubuntu, и вы установите их через менеджер пакетов APT.

Для начала выполните команду ниже, чтобы обновить индекс пакетов Ubuntu.

sudo apt update

Теперь установите Python3 и Node.js через репозиторий Ubuntu с помощью следующей команды - введите Y, чтобы подтвердить установку:

sudo apt install python3-dev python3-pip python3-venv nodejs npm

установка зависимостей

После завершения установки проверьте версии Python, Node.js и Pip с помощью следующих команд:

python3 -v
pip3 -v
node -v

Вы можете увидеть ниже установленные версии Python 3.12, Node.js 18 и Pip 24.

проверка версии

Установка Jupyter

После установки зависимостей вы установите Jupyter через Pip в виртуальной среде Python. Вы будете запускать Jupyter как пользователь, не являющийся root, поэтому убедитесь, что вы его создали.

Войдите в свою учетную запись с помощью команды ниже - в следующем примере будет использоваться пользователь alice:

su - alice

Выполните команду ниже, чтобы создать новый каталог ~/Dev и перейти в него. Затем создайте новую виртуальную среду Python venv.

mkdir -p ~/Dev; cd ~/Dev
python3 -v venv venv

Теперь активируйте виртуальную среду venv с помощью следующей команды. После активации ваша оболочка станет похожей на (venv) user@hostname.

source venv/bin/activate

Далее выполните команду pip3 ниже, чтобы установить Jupyter через репозиторий PyPi:

pip3 install jupyter

Ниже вы можете увидеть установку jupyter через команду pip3:

установка jupyter

После завершения процесса проверьте версию Jupyter с помощью следующей команды:

jupyter –version

Вы увидите версию каждого компонента Jupyter, такого как jupyterlab, jupyter_server, jupyter_client, jupyter_core и iPython.

Настройка Jupyter

В этом разделе вы настроите два основных компонента Jupyter, а именно jupyter_server и jupyterlab. Вы сгенерируете конфигурацию и настроите аутентификацию по паролю для обоих компонентов. Затем вы запустите Jupyter через командную строку.

Сначала выполните команду jupyter ниже, чтобы сгенерировать конфигурацию jupyter_server и пароль. Введите свой пароль, когда будет предложено, и повторите его.

jupyter server –generate-config
jupyter server password

Вы можете увидеть ниже, что конфигурация jupyter_server сгенерирована в ~/.jupyter/jupyter_server_config.py, а файл пароля записан в ~/.jupyter/jupyter_server_config.json.

генерация конфигурации сервера и пароля

Проверьте конфигурацию jupyter_server с помощью команды ниже.

jupyter server –show-config

И вы увидите аналогичный вывод, как на следующем изображении:

показать конфигурацию сервера

Затем выполните команду jupyter ниже, чтобы сгенерировать конфигурацию jupyterlab в ~/.jupyter/jupyter_lab_config.py. Затем проверьте конфигурацию jupyterlab.

jupyter lab –generate-config
jupyter lab –show-config

В следующем выводе путь URL по умолчанию для jupyterlab - /lab.

генерация конфигурации jupyterlab

Теперь выполните команду jupyter ниже, чтобы запустить jupyterlab из командной строки. jupyterlab должен работать на порту 8888 и по пути URL lab.

jupyter lab –ip 0.0.0.0

запуск jupyter из командной строки

Перейдите по адресу http://server-ip:8888/lab, чтобы получить доступ к вашей установке jupyterlab. Вы увидите следующую панель управления Jupyter.

тест jupyter

Теперь нажмите Ctrl+c и введите yes, чтобы завершить процесс jupyterlab.

Запуск JupyterLab как службы

В этом руководстве вы будете запускать Jupyter в фоновом режиме как службу. Теперь вам нужно создать новый файл службы systemd для Jupyter.

Создайте новый файл службы systemd /etc/systemd/system/jupyterlab.service с помощью следующей команды редактора nano.

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

Введите следующую конфигурацию и убедитесь, что вы изменили пользователя alice на ваше имя пользователя.

[Unit]
Description=JupyterLab Service

[Service]
Type=simple
PIDFile=/run/jupyter.pid
ExecStart=/home/alice/Dev/venv/bin/jupyter lab --config=/home/alice/.jupyter/jupyter_lab_config.py
User=alice
Group=alice
WorkingDirectory=/home/alice/Dev
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Сохраните файл и выйдите из редактора, когда закончите.

Теперь выполните команду ниже, чтобы перезагрузить менеджер systemd и активировать ваш новый файл службы.

sudo systemctl daemon-reload

Затем запустите и активируйте службу jupyterlab с помощью команды ниже.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

jupyter systemd

Наконец, выполните команду ниже, чтобы проверить статус службы jupyterlab. Вы увидите, что служба jupyterlab работает и включена в вашей системе.

sudo systemctl status jupyterlab

проверка статуса jupyter

Разрешение удаленного доступа к Jupyter

Перед настройкой Nginx как обратного прокси вам нужно разрешить удаленный доступ к jupyterlab. Теперь вы измените файл ~/.jupyter/jupyter_lab_config.py и включите удаленный доступ.

Сначала откройте конфигурацию jupyterlab ~/.jupyter/jupyter_lab_config.py с помощью следующей команды редактора nano.

nano ~/.jupyter/jupyter_lab_config.py

Распакуйте опцию c.ServerApp.allow_remote_access и измените ее на True. Это позволит включить удаленный доступ для jupyterlab.

c.ServerApp.allow_remote_access = True

Сохраните и выйдите из файла, когда закончите.

Теперь выполните команду ниже, чтобы перезапустить службу jupyterlab и применить ваши изменения. После включения удаленного доступа в Jupyter будет сгенерирован новый токен для настройки пароля.

sudo systemctl restart jupyterlab

Обратите внимание на нижнюю часть сообщения и скопируйте сгенерированный токен для Jupyter.

Настройка Nginx как обратного прокси

В этом разделе вы установите и настроите Nginx как обратный прокси для вашей установки Jupyter. Убедитесь, что у вас есть ваше доменное имя, будь то публичное или частное доменное имя.

Установите веб-сервер Nginx с помощью команды ниже - введите Y, чтобы продолжить установку.

sudo apt install nginx

установка nginx

После завершения установки создайте новую конфигурацию блока сервера Nginx /etc/nginx/sites-available/jupyterlab с помощью следующей команды редактора nano.

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

Добавьте следующую конфигурацию в файл и убедитесь, что вы изменили доменное имя в опции server_name.

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

Когда закончите, сохраните и выйдите из файла.

Теперь выполните команду ниже, чтобы активировать блок сервера jupyterlab и проверить синтаксис вашего Nginx. Если у вас правильная конфигурация, вы получите вывод syntax is ok ... test is successful.

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

Наконец, выполните команду ниже, чтобы перезапустить Nginx и применить вашу новую конфигурацию блока сервера jupyterlab. После выполнения команды ваш Jupyter будет работать под обратным прокси Nginx.

sudo systemctl restart nginx

настройка обратного прокси nginx

Доступ к Jupyter

Если вы используете Linux или MacOS, отредактируйте файл /etc/hosts. Для пользователей Windows отредактируйте файл C:\System32\drivers\etc\hosts от имени администратора.

Добавьте ваш IP-адрес сервера и доменное имя Jupyter следующим образом:

192.168.5.65 lab.howtoforge.local

Сохраните и выйдите из файла.

Теперь откройте веб-браузер и перейдите на ваше доменное имя Jupyter, например http://lab.howtoforge.local/. Если ваша конфигурация успешна, вы увидите страницу входа Jupyter.

Прокрутите вниз и вставьте токен для вашей установки Jupyter. Затем введите новый пароль для Jupyter и нажмите Войти и установить новый пароль.

входной токен и изменение пароля

Если все прошло успешно, вы увидите панель управления Jupyter, как на следующем изображении - и ваш пароль для Jupyter также изменится.

панель управления

Заключение

Поздравляем! Вы завершили установку Jupyter на Ubuntu 24.04. Теперь у вас есть Jupyter, работающий с Nginx в качестве обратного прокси и защищенный аутентификацией по паролю. Если вы запускаете Jupyter на публичном сервере или VPS (виртуальном частном сервере), вам необходимо реализовать HTTPS поверх вашего обратного прокси Nginx. Вы можете достичь этого с помощью Certbot и Letsencrypt.