WSL2에서 Ollama를 설치하고 OLLAMA_HOST를 확인

WSL2에서 Ollama를 설치하고 OLLAMA_HOST를 확인하는 방법을 알려드리겠습니다.

---

🔍 OLLAMA_HOST 확인 방법

방법 1: WSL2 내부에서 확인 (가장 간단)

bash

Copy

# WSL2 Ubuntu 터미널에서 실행
echo $OLLAMA_HOST

# 아무것도 출력되지 않으면 기본값 사용
# 기본값: 127.0.0.1:11434 (로컬호스트)

방법 2: Ollama 서버 실행 시 확인

bash

Copy

# WSL2에서 Ollama 서버 시작 (터미널 1)
ollama serve

# 출력 예시:
# time=2026-04-10T10:22:00.000Z level=INFO source=routes.go:123 msg="listening on 127.0.0.1:11434"
# 또는
# time=2026-04-10T10:22:00.000Z level=INFO source=routes.go:123 msg="listening on [::]:11434"

여기서 listening on 뒤의 주소가 OLLAMA_HOST입니다.

방법 3: WSL2 IP 주소 확인 (Windows에서 접근 시 필요)

bash

Copy

# WSL2 내부 IP 확인 (Windows 호스트에서 WSL2로 접근할 때)
ip addr show eth0 | grep 'inet\b' | awk '{print $2}' | cut -d/ -f1

# 또는
hostname -I | awk '{print $1}'

# 출력 예시: 172.17.123.45

방법 4: Windows에서 WSL2 Ollama 접근 설정

WSL2 Ubuntu 터미널에서:

bash

Copy

# 1. Ollama가 모든 인터페이스에서 수신하도록 설정
export OLLAMA_HOST=0.0.0.0:11434

# 2. Ollama 서버 시작
ollama serve

Windows PowerShell에서 확인:

powershell

Copy

# WSL2 IP 확인
wsl hostname -I

# 출력 예시: 172.17.123.45

# Windows에서 Ollama 접근 테스트
$env:OLLAMA_HOST="http://172.17.123.45:11434"
ollama list

---

🎯 WSL2 Ollama 사용 시나리오별 설정

시나리오 1: WSL2 내부에서만 사용

bash

Copy

# WSL2 터미널에서 (기본값)
ollama serve

# 다른 WSL2 터미널에서
ollama run llama3.1:latest

# Python에서
export OLLAMA_HOST=127.0.0.1:11434
# 또는 설정 없이 사용 (기본값이므로)

시나리오 2: Windows에서 WSL2 Ollama 사용

bash

Copy

# WSL2 터미널 1: 서버 시작 (모든 인터페이스 허용)
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

# Windows PowerShell: WSL2 IP 확인 후 접근
wsl hostname -I
# 예: 172.17.123.45

$env:OLLAMA_HOST="http://172.17.123.45:11434"
ollama list

시나리오 3: Python (Streamlit/LangChain)에서 사용

Python

Copy

# WSL2 내부에서 실행하는 경우
OLLAMA_BASE_URL = "http://localhost:11434"
# 또는
OLLAMA_BASE_URL = "http://127.0.0.1:11434"

# Windows에서 WSL2 Ollama 사용하는 경우
OLLAMA_BASE_URL = "http://172.17.123.45:11434"  # WSL2 IP

---

🔧 자동화 설정 (권장)

WSL2에서 Ollama 자동 시작 설정

bash

Copy

# ~/.bashrc 또는 ~/.zshrc에 추가
echo 'export OLLAMA_HOST=0.0.0.0:11434' >> ~/.bashrc
source ~/.bashrc

Windows에서 WSL2 IP 자동화 (PowerShell)

powershell

Copy

# WSL2 IP를 환경변수로 설정
$wslIp = wsl hostname -I | awk '{print $1}'
$env:OLLAMA_HOST = "http://${wslIp}:11434".Trim()

Write-Host "OLLAMA_HOST 설정: $env:OLLAMA_HOST"

---

📋 요약

Table

 

 

상황OLLAMA_HOST 값사용 위치

WSL2 내부	127.0.0.1:11434 또는 localhost:11434	WSL2 터미널, Python
Windows → WSL2	http://172.17.x.x:11434 (WSL2 IP)	Windows PowerShell, Python
Docker → WSL2	host.docker.internal:11434	Docker 컨테이너

즉시 확인 명령어:

bash

Copy

# WSL2에서
curl http://localhost:11434/api/tags  # Ollama API 확인

# Windows에서
curl http://$(wsl hostname -I | awk '{print $1}'):11434/api/tags

llama3.1:latest 모델이 잘 다운로드되었는지 확인하려면:

bash

Copy

ollama list
# 출력 예시:
# NAME            ID              SIZE      MODIFIED
# llama3.1:latest 62757c860...    4.7 GB    10 minutes ago