기술연동

[Jupyter Lab] WSL ubuntu에 주피터랩 설치 및 실행 가이드

quantumee 2025. 4. 3. 01:08

wsl로 개발하는 이유...

윈도우 PC에서 개발 할때 리눅스 환경에 테스트하기 가장 좋은 방법은 wsl을 활용하는 거다

 

파이썬으로 작업할 때 라이브러리 중 리눅스 호환이 안되거나 예상치 못한 버그가 발생하는 것을 로컬에서 캐치하고자 할때 

wsl에 jupyterlab을 설치해 사용하면 편하게 리눅스환경에서 로컬테스트가 가능하다.

 


1. apt 업데이트

sudo apt update && sudo apt upgrade -y

 

2. 파이썬 및 pip 설치

sudo apt install python3 python3-pip -y

   ++ 설치확인 cmd : 

             ->  python3 --version

             ->  pip3 --version

 

3. 주피터랩 설치

pip3 install jupyterlab

  ++ 설치확인:

             ->   jupyter lab --version

  만약) 

jupyterlab 설치 문제

    ㄴ> 이렇게 설치를 했는데도 버전 확인이 안된다면

# 경로 맞추기 
export PATH="$HOME/.local/bin:$PATH"

# 영구적으로 맞추기
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc 
source ~/.bashrc

 

 

4. 주피터 랩 설정 파일 생성

jupyter-lab --generate-config

 

5. 주피터 랩 설정

1) 비밀번호 설정

- 비밀번호 사용자 지정 

# 파이썬 실행
python3

# 파이썬 실행 후 >>> 에 넣을 파이썬 코드
from jupyter_server.auth import passwd; passwd()

L> 실행 후

    Enter passsword: 비밀번호로 쓸 내용 입력 후

    Verify password: 에 다시 입력 하고 나온 내용 (argon2~~~~) 복사해 놓기

    exit() 입력하고 python 창에서 나오기

 

- 설정파일에 설정한 비밀번호 관련 내용 추가 및 수정

# jupyter lab 설정 파일 켜기
vi /home/$$name$$/.jupyter/jupyter_lab_config.py

ㄴ> 실행후

    '/'로 c.ServerApp.password 검색 (vi 외의 vim이나 nano 뭐든 상관없음)

    주석되어있는 c.ServerApp.password 가 포함된 라인의 주석을 풀고 내용에 복사한 내용(argon2~~~)을 넣어줌

    다시 '/'로  c.ServerApp.password_required  검색

    마찬가지로 주석 풀고 False 값을 True로 변경   

 

2) 네트워크 설정

위의 vi로 설정 파일을 열어둔 채로 c.ServerApp.allow_origin  를 찾아 검색 후 '*' (전체 허용)입력

다음 c.ServerApp.ip 을 찾아 '0.0.0.0' 입력

다음 c.ServerApp.port 을 찾아 원하는 포트 번호 입력 ex) 7979

 

6. 주피터 랩 실행

jupyter lab --no-browser

 

을 실행하면

 

이렇게 나오는데 저 빨간 박스의 링크를 ctrl 키를 누른채 클릭하면 주피터 랩이 켜진다

화면상에서 아까 전에 설정한 패스워드를 입력하면 주피터 랩을 사용할 수 있다