기술블로그

🧠 WSL에서 SQLite GUI 도구(sqlitebrowser) 설치 및 실행 방법 완전 정복

Chansman 2025. 4. 30. 16:03

🧠 WSL에서 SQLite GUI 도구(sqlitebrowser) 설치 및 실행 방법 완전 정복

✅ 목표

WSL2 환경에서 sqlitebrowser 같은 GUI 도구를 설치하고,
Windows처럼 GUI 화면으로 SQLite DB를 쉽게 조회하고 수정하는 방법!

✅ 준비 사항

  • 운영체제: Windows 11 또는 Windows 10 (22H2 이상)
  • WSL 버전: WSL2 + WSLg (GUI 지원 환경)
  • 리눅스 배포판: Ubuntu (기준)

확인 명령:

wsl --version

WSLg가 포함된 버전인지 확인하고, 아니라면 업데이트:

wsl --update

🪜 설치 및 실행 단계별 요약

✅ 1단계: APT를 통한 설치

sudo apt update
sudo apt install sqlitebrowser -y

✅ 2단계: GUI 실행

sqlitebrowser &

정상적으로 실행되면 Windows처럼 GUI 창이 뜨게 됩니다.

🧩 실행 중 경고 메시지 해결 (선택 사항)

QStandardPaths: wrong permissions on runtime directory /run/user/1000/, 0755 instead of 0700
  • 이 메시지는 단순 보안 경고이며 기능상 문제는 없음
  • 원한다면 다음 명령으로 수정 가능 (선택):
sudo chmod 700 /run/user/1000

✅ SQLite DB 연결 확인

  • GUI 창에서 .sqlite3 파일 열기
  • 테이블 목록, 데이터 보기, 직접 수정 가능 ✅

✅ Django의 db.sqlite3 파일도 바로 열고 편집 가능

🎯 요약 정리

항목 내용

설치 방법 sudo apt install sqlitebrowser
실행 방법 sqlitebrowser &
GUI 창 출력 조건 WSLg (Windows 11 이상 또는 최신 WSL)
경고 메시지 무시 가능 (/run/user/1000/ 퍼미션)
DB 연결 결과 Django SQLite 파일 정상 조회/편집 가능

WSL 환경에서도 GUI 기반 SQLite 도구를 활용하면
개발 생산성과 가독성이 훨씬 올라갑니다. GUI 설정까지 마쳤다면 이제 본격적인 DB 탐색을 시작해보세요! 🚀