So installieren Sie JupyterLab auf Ubuntu 24.04

JupyterLab ist eine Open-Source-Web-basierte interaktive Entwicklungsumgebung, die die klassische Jupyter-Notebook-Erfahrung erweitert und eine flexiblere und leistungsstärkere Schnittstelle für Datenwissenschafts- und wissenschaftliche Rechenaufgaben bietet. Es unterstützt verschiedene Programmiersprachen, mit einem starken Fokus auf Python, und bietet Funktionen wie Codebearbeitung, Datenvisualisierung und interaktive Ausgaben in einem einzigen, integrierten Arbeitsbereich. JupyterLab ermöglicht es Benutzern, Notebooks, Texteditoren, Terminals und andere benutzerdefinierte Komponenten in einem Registerkartenlayout zu erstellen und zu verwalten, was die Produktivität und Zusammenarbeit verbessert. Auf Ubuntu kann es einfach über Paketmanager wie apt oder über den Paketinstaller pip von Python installiert werden, was es zu einem zugänglichen Werkzeug für Entwickler und Forscher macht, die diese beliebte Linux-Distribution verwenden.

In diesem Leitfaden erfahren Sie, wie Sie Jupyter auf Ubuntu 24.04 installieren. Sie installieren und sichern Jupyter mit Passwortauthentifizierung. Dann installieren Sie Nginx und konfigurieren es als Reverse-Proxy.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen haben:

• Ein Ubuntu 24.04.
• Ein Nicht-Root-Benutzer mit Administratorrechten.
• Ein Domainname, der auf eine Server-IP-Adresse zeigt (öffentliche oder private Domain).

Abhängigkeiten installieren

In diesem Abschnitt installieren Sie die Abhängigkeiten für Jupyter, die Python, Pip, venv und Node.js umfassen. Diese Pakete sind standardmäßig im Ubuntu-Repository verfügbar, und Sie installieren sie über den APT-Paketmanager.

Um zu beginnen, führen Sie den folgenden Befehl aus, um Ihren Ubuntu-Paketindex zu aktualisieren.

sudo apt update

Jetzt installieren Sie Python3 und Node.js über das Ubuntu-Repository mit folgendem - Geben Sie Y ein, um die Installation zu bestätigen:

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

Nachdem die Installation abgeschlossen ist, überprüfen Sie die Version von Python, Node.js und Pip mit folgendem:

python3 -v
pip3 -v
node -v

Sie können unten sehen, dass Python 3.12, Node.js 18 und Pip 24 installiert sind.

Jupyter installieren

Nachdem Sie die Abhängigkeiten installiert haben, installieren Sie Jupyter über Pip in der Python-virtuellen Umgebung. Sie führen Jupyter als Nicht-Root-Benutzer aus, also stellen Sie sicher, dass Sie es erstellt haben.

Melden Sie sich mit dem folgenden Befehl bei Ihrem Benutzer an - Das folgende Beispiel verwendet den Benutzer alice:

su - alice

Führen Sie den folgenden Befehl aus, um ein neues Verzeichnis ~/Dev zu erstellen und in dieses zu wechseln. Erstellen Sie dann eine neue Python venv-virtuelle Umgebung.

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

Aktivieren Sie jetzt die venv-virtuelle Umgebung mit dem folgenden Befehl. Nach der Aktivierung wird Ihre Shell wie (venv) user@hostname aussehen.

source venv/bin/activate

Führen Sie als Nächstes den pip3-Befehl unten aus, um Jupyter über das PyPi-Repository zu installieren:

pip3 install jupyter

Unten sehen Sie die Installation von jupyter über den pip3-Befehl:

Nachdem der Prozess abgeschlossen ist, überprüfen Sie die Jupyter-Version mit dem folgenden Befehl:

jupyter –version

Sie sehen die Version jeder Jupyter-Komponente, wie jupyterlab, jupyter_server, jupyter_client, jupyter_core und iPython.

Jupyter konfigurieren

In diesem Abschnitt konfigurieren Sie zwei Hauptkomponenten von Jupyter, nämlich jupyter_server und jupyterlab. Sie generieren die Konfiguration und richten die Passwortauthentifizierung für beide Komponenten ein. Dann führen Sie Jupyter über die Befehlszeile aus.

Zuerst führen Sie den folgenden jupyter-Befehl aus, um die jupyter_server-Konfiguration und das Passwort zu generieren. Geben Sie Ihr Passwort ein, wenn Sie dazu aufgefordert werden, und wiederholen Sie es.

jupyter server –generate-config
jupyter server password

Sie können unten sehen, dass die jupyter_server-Konfiguration in ~/.jupyter/jupyter_server_config.py generiert wurde und die Passwortdatei in ~/.jupyter/jupyter_server_config.json geschrieben wurde.

Überprüfen Sie die jupyter_server-Konfiguration mit dem folgenden Befehl.

jupyter server –show-config

Und Sie werden eine ähnliche Ausgabe wie folgt sehen:

Führen Sie als Nächstes den jupyter-Befehl unten aus, um die jupyterlab-Konfiguration in ~/.jupyter/jupyter_lab_config.py zu generieren. Überprüfen Sie dann die jupyterlab-Konfiguration.

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

In der folgenden Ausgabe ist der Standard-URL-Pfad für jupyterlab /lab.

Führen Sie jetzt den jupyter-Befehl unten aus, um jupyterlab über die Befehlszeile zu starten. Das jupyterlab sollte auf Port 8888 und dem URL-Pfad lab laufen.

jupyter lab –ip 0.0.0.0

Besuchen Sie http://server-ip:8888/lab, um auf Ihre jupyterlab-Installation zuzugreifen. Sie sehen das folgende Jupyter-Dashboard.

Drücken Sie jetzt Ctrl+c und geben Sie yes ein, um den jupyterlab-Prozess zu beenden.

JupyterLab als Dienst ausführen

In diesem Leitfaden führen Sie Jupyter im Hintergrund als Dienst aus. Sie müssen jetzt eine neue systemd-Dienstdatei für Jupyter erstellen.

Erstellen Sie eine neue systemd-Dienstdatei /etc/systemd/system/jupyterlab.service mit dem folgenden Befehl im Nano-Editor.

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

Geben Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den Benutzer alice durch Ihren Benutzernamen ersetzen.

[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

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie jetzt den folgenden Befehl aus, um den systemd-Manager neu zu laden und Ihre neue Dienstdatei zu aktivieren.

sudo systemctl daemon-reload

Starten und aktivieren Sie als Nächstes den jupyterlab-Dienst mit dem folgenden Befehl.

sudo systemctl start jupyterlab
sudo systemctl enable jupyterlab

Führen Sie zuletzt den folgenden Befehl aus, um den Status des jupyterlab-Dienstes zu überprüfen. Sie werden sehen, dass der jupyterlab-Dienst auf Ihrem System läuft und aktiviert ist.

sudo systemctl status jupyterlab

Remote-Zugriff auf Jupyter erlauben

Bevor Sie Nginx als Reverse-Proxy einrichten, müssen Sie den Remote-Zugriff auf jupyterlab erlauben. Jetzt werden Sie die Datei ~/.jupyter/jupyter_lab_config.py ändern und den Remote-Zugriff aktivieren.

Öffnen Sie zuerst die jupyterlab-Konfiguration ~/.jupyter/jupyter_lab_config.py mit dem folgenden Nano-Editor.

nano ~/.jupyter/jupyter_lab_config.py

Kommentieren Sie die Option c.ServerApp.allow_remote_access aus und ändern Sie sie in True. Dies aktiviert den Remote-Zugriff für jupyterlab.

c.ServerApp.allow_remote_access = True

Speichern Sie die Datei und beenden Sie sie, wenn Sie fertig sind.

Führen Sie jetzt den folgenden Befehl aus, um den jupyterlab-Dienst neu zu starten und Ihre Änderungen anzuwenden. Nachdem der Remote-Zugriff in Jupyter aktiviert wurde, wird ein neuer Token zur Einrichtung eines Passworts generiert.

sudo systemctl restart jupyterlab

Schauen Sie sich den unteren Teil der Nachricht an und kopieren Sie den generierten Token für Jupyter.

Nginx als Reverse-Proxy einrichten

In diesem Abschnitt installieren und konfigurieren Sie Nginx als Reverse-Proxy für Ihre Jupyter-Installation. Stellen Sie sicher, dass Sie Ihren Domainnamen haben, egal ob es sich um einen öffentlichen oder privaten Domainnamen handelt.

Installieren Sie den Nginx-Webserver mit dem folgenden Befehl - Geben Sie Y ein, um mit der Installation fortzufahren.

sudo apt install nginx

Nachdem die Installation abgeschlossen ist, erstellen Sie eine neue Nginx-Serverblockkonfiguration /etc/nginx/sites-available/jupyterlab mit dem folgenden Nano-Editor.

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

Fügen Sie die folgende Konfiguration in die Datei ein und stellen Sie sicher, dass Sie den Domainnamen innerhalb der Option server_name ändern.

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

Wenn Sie fertig sind, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den folgenden Befehl aus, um den jupyterlab-Serverblock zu aktivieren und Ihre Nginx-Syntax zu überprüfen. Wenn Sie die richtige Konfiguration haben, erhalten Sie die Ausgabe syntax is ok ... test is successful.

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

Führen Sie zuletzt den folgenden Befehl aus, um Nginx neu zu starten und Ihre neue jupyterlab-Serverblockkonfiguration anzuwenden. Nachdem der Befehl ausgeführt wurde, läuft Ihr Jupyter unter dem Nginx-Reverse-Proxy.

sudo systemctl restart nginx

Auf Jupyter zugreifen

Wenn Sie Linux oder MacOS verwenden, bearbeiten Sie die Datei /etc/hosts. Für Windows-Benutzer bearbeiten Sie die Datei C:\System32\drivers\etc\hosts als Administrator.

Fügen Sie Ihre Server-IP-Adresse und den Domainnamen Jupyter wie folgt hinzu:

192.168.5.65 lab.howtoforge.local

Speichern Sie die Datei und beenden Sie sie.

Öffnen Sie jetzt Ihren Webbrowser und besuchen Sie Ihren Jupyter-Domainnamen wie http://lab.howtoforge.local/. Wenn Ihre Konfiguration erfolgreich ist, sehen Sie die Jupyter-Anmeldeseite.

Scrollen Sie nach unten und fügen Sie den Token für Ihre Jupyter-Installation ein. Geben Sie dann das neue Passwort für Jupyter ein und klicken Sie auf Anmelden und neues Passwort festlegen.

Wenn erfolgreich, sehen Sie das Jupyter-Dashboard wie folgt - Und Ihr Passwort für Jupyter wurde ebenfalls geändert.

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Jupyter auf Ubuntu 24.04 abgeschlossen. Sie haben jetzt Jupyter, das mit Nginx als Reverse-Proxy läuft und mit Passwortauthentifizierung gesichert ist. Wenn Sie Jupyter auf einem öffentlichen Server oder VPS (Virtual Private Server) ausführen, müssen Sie HTTPS über Ihren Nginx-Reverse-Proxy implementieren. Sie können dies über Certbot und Letsencrypt erreichen.