JupyterLab 설치 · 5 min read · Sep 10, 2025

우분투 24.04에 JupyterLab 설치하는 방법

JupyterLab은 고전 Jupyter Notebook 경험을 확장하는 오픈 소스 웹 기반 대화형 개발 환경으로, 데이터 과학 및 과학 컴퓨팅 작업을 위한 보다 유연하고 강력한 인터페이스를 제공합니다. 다양한 프로그래밍 언어를 지원하며, Python에 강력하게 집중하고 있으며, 코드 편집, 데이터 시각화 및 대화형 출력을 단일 통합 작업 공간에서 제공하는 기능을 제공합니다. JupyterLab은 사용자가 탭 레이아웃에서 노트북, 텍스트 편집기, 터미널 및 기타 사용자 정의 구성 요소를 생성하고 관리할 수 있도록 하여 생산성과 협업을 향상시킵니다. 우분투에서는 apt와 같은 패키지 관리자를 통해 또는 Python의 패키지 설치 프로그램인 pip를 통해 쉽게 설치할 수 있어, 이 인기 있는 리눅스 배포판을 사용하는 개발자와 연구자에게 접근 가능한 도구입니다.

이 가이드에서는 우분투 24.04에 Jupyter를 설치하는 방법을 배웁니다. 비밀번호 인증으로 Jupyter를 설치하고 보안합니다. 그런 다음 Nginx를 설치하고 이를 리버스 프록시로 구성합니다.

필수 조건

시작하기 전에 다음 요구 사항이 충족되었는지 확인하십시오:

  • 우분투 24.04.
  • 관리자 권한이 있는 비루트 사용자.
  • 서버 IP 주소(공개 또는 비공식 도메인)로 지정된 도메인 이름.

종속성 설치

이 섹션에서는 Python, Pip, venv, Node.js를 포함하여 Jupyter의 종속성을 설치합니다. 이러한 패키지는 기본적으로 우분투 리포지토리에 제공되며, APT 패키지 관리자를 통해 설치합니다.

시작하려면 아래 명령어를 실행하여 우분투 패키지 인덱스를 업데이트합니다.

sudo apt update

이제 다음을 통해 우분투 리포지토리에서 Python3 및 Node.js를 설치합니다 - 설치를 확인하려면 Y를 입력하십시오:

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

install dependencies

설치가 완료되면 다음 명령어로 Python, Node.js 및 Pip 버전을 확인하십시오:

python3 -v  
pip3 -v  
node -v

아래에서 Python 3.12, Node.js 18 및 Pip 24가 설치된 것을 볼 수 있습니다.

check version

Jupyter 설치

종속성을 설치한 후, Python 가상 환경에서 Pip를 통해 Jupyter를 설치합니다. 비루트 사용자로 Jupyter를 실행할 것이므로, 이를 생성했는지 확인하십시오.

아래 명령어로 사용자로 로그인하십시오 - 다음 예제에서는 사용자 alice를 사용합니다:

su - alice

아래 명령어를 실행하여 새 디렉토리 ~/Dev를 만들고 그 안으로 이동합니다. 그런 다음 새 Python venv 가상 환경을 생성합니다.

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

이제 다음 명령어로 venv 가상 환경을 활성화합니다. 활성화되면 셸이 (venv) user@hostname과 같이 됩니다.

source venv/bin/activate

다음으로, 아래 pip3 명령어를 실행하여 PyPi 리포지토리를 통해 Jupyter를 설치합니다:

pip3 install jupyter

아래에서 pip3 명령어를 통해 jupyter 설치를 볼 수 있습니다:

installing 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에 기록된 것을 볼 수 있습니다.

generate server configuration and password

아래 명령어로 jupyter_server 구성을 확인하십시오.

jupyter server --show-config

그리고 다음과 유사한 출력을 볼 수 있습니다:

show server configuration

다음으로, 아래 jupyter 명령어를 실행하여 jupyterlab 구성을 ~/.jupyter/jupyter_lab_config.py에 생성합니다. 그런 다음 jupyterlab 구성을 확인합니다.

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

다음 출력에서 jupyterlab의 기본 URL 경로는 /lab입니다.

geenrate jupyterlab configuration

이제 아래 jupyter 명령어를 실행하여 명령줄에서 jupyterlab을 시작합니다. jupyterlab은 포트 8888에서 실행되며 URL 경로는 lab입니다.

jupyter lab --ip 0.0.0.0

running jupyter from command line

http://server-ip:8888/lab에 방문하여 jupyterlab 설치에 접근하십시오. 다음과 같은 Jupyter 대시보드를 볼 수 있습니다.

test jupyter

이제 Ctrl+c를 누르고 yes를 입력하여 jupyterlab 프로세스를 종료합니다.

JupyterLab을 서비스로 실행하기

이 가이드에서는 Jupyter를 백그라운드에서 서비스로 실행합니다. 이제 Jupyter를 위한 새로운 systemd 서비스 파일을 생성해야 합니다.

다음 nano 편집기 명령어로 새 systemd 서비스 파일 /etc/systemd/system/jupyterlab.service를 생성합니다.

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

check jupyter status

Jupyter에 원격 접근 허용하기

Nginx를 리버스 프록시로 설정하기 전에 jupyterlab에서 원격 접근을 허용해야 합니다. 이제 ~/.jupyter/jupyter_lab_config.py 파일을 수정하여 원격 접근을 활성화합니다.

먼저, 아래 nano 편집기로 jupyterlab 구성 ~/.jupyter/jupyter_lab_config.py를 엽니다.

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를 리버스 프록시로 설정하기

이 섹션에서는 Jupyter 설치를 위한 리버스 프록시로 Nginx를 설치하고 구성합니다. 따라서 공개 또는 비공식 도메인 이름이 필요합니다.

아래 명령어로 Nginx 웹 서버를 설치합니다 - 설치를 진행하려면 Y를 입력하십시오.

sudo apt install nginx

install nginx

설치가 완료되면 다음 nano 편집기로 새 Nginx 서버 블록 구성 /etc/nginx/sites-available/jupyterlab을 생성합니다.

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

setup nginx reverse proxy

Jupyter 접근하기

리눅스나 MacOS를 사용하는 경우 /etc/hosts 파일을 편집합니다. 윈도우 사용자는 C:\System32\drivers\etc\hosts 파일을 관리자 권한으로 편집합니다.

서버 IP 주소와 도메인 이름 Jupyter를 다음과 같이 추가합니다:

192.168.5.65 lab.howtoforge.local

파일을 저장하고 종료합니다.

이제 웹 브라우저를 열고 http://lab.howtoforge.local/와 같은 Jupyter 도메인 이름을 방문합니다. 구성이 성공적이라면 Jupyter 로그인 페이지를 볼 수 있습니다.

하단으로 스크롤하여 Jupyter 설치를 위한 토큰을 붙여넣습니다. 그런 다음 Jupyter에 대한 새 비밀번호를 입력하고 Log in and set new password를 클릭합니다.

login token and change password

성공적으로 로그인하면 다음과 같은 Jupyter 대시보드를 볼 수 있으며, Jupyter 비밀번호도 변경됩니다.

dashboard

결론

축하합니다! 우분투 24.04에 Jupyter 설치를 완료했습니다. 이제 Jupyter가 Nginx를 리버스 프록시로 사용하여 비밀번호 인증으로 보안되었습니다. Jupyter를 공개 서버나 VPS(가상 사설 서버)에서 실행하는 경우, Nginx 리버스 프록시 위에 HTTPS를 구현해야 합니다. Certbot과 Letsencrypt를 통해 이를 달성할 수 있습니다.

Share: X/Twitter LinkedIn
#JupyterLab 설치

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.