Open WebUI 성능 최적화 및 도커 볼륨 백업·트러블슈팅 가이드 (5/5)

# GPU 실시간 사용률·VRAM 모니터링
watch -n 1 nvidia-smi
 
# Ollama에서 현재 실행 중인 모델과 GPU 사용 여부 확인
docker exec -it ollama ollama ps
 
# Ollama 상세 로그 확인 (GPU 로드 여부)
docker logs ollama --tail 50 | grep -E "gpu|GPU|vram|VRAM"

  ollama:
    image: ollama/ollama:latest
    environment:
      - OLLAMA_NUM_PARALLEL=2        # 동시 요청 2개 처리
      - OLLAMA_MAX_LOADED_MODELS=2   # 모델 2개 메모리에 유지
      - OLLAMA_FLASH_ATTENTION=1     # Flash Attention 활성화
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    deploy:
      resources:
        limits:
          cpus: '4'        # CPU 최대 4코어
          memory: 4G       # 메모리 최대 4GB
        reservations:
          cpus: '1'
          memory: 1G

# 1. 현재 버전 확인
docker exec open-webui cat /app/package.json | grep version
 
# 2. 최신 이미지 Pull
docker compose pull
 
# 3. 컨테이너 재시작 (볼륨은 유지됨)
docker compose up -d
 
# 4. 업데이트 완료 확인
docker compose ps
docker compose logs open-webui --tail 20

## ── 백업 ──────────────────────────────────────
# Open WebUI 데이터 백업 (tar.gz 압축)
docker run --rm \
  -v open-webui:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/openwebui-backup-$(date +%Y%m%d).tar.gz /data
 
# Ollama 모델 백업 (모델 파일은 크므로 선택적으로)
docker run --rm \
  -v ollama:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/ollama-backup-$(date +%Y%m%d).tar.gz /data
 
## ── 복원 ──────────────────────────────────────
# 볼륨 복원 (기존 데이터 덮어쓰기)
docker run --rm \
  -v open-webui:/data \
  -v $(pwd):/backup \
  alpine tar xzf /backup/openwebui-backup-20250520.tar.gz -C /
 
## ── cron 자동 백업 (매일 새벽 3시) ──────────
# crontab -e 에 추가
0 3 * * * docker run --rm -v open-webui:/data -v /home/user/backups:/backup alpine tar czf /backup/openwebui-$(date +\%Y\%m\%d).tar.gz /data

# docker-compose.yml의 이미지 태그를 특정 버전으로 변경 후 재시작
# 예: :main → :v0.5.20 (GitHub Releases에서 버전 확인)
 
image: ghcr.io/open-webui/open-webui:v0.5.20
 
# 적용
docker compose pull && docker compose up -d

# Open WebUI 로그 실시간 확인
docker compose logs -f open-webui
 
# Ollama 로그 확인
docker compose logs -f ollama
 
# 최근 50줄만 확인
docker compose logs --tail 50 open-webui
 
# 컨테이너 상태 확인
docker compose ps

# 3000 포트 사용 중인 프로세스 확인
sudo lsof -i :3000
sudo netstat -tulpn | grep 3000
 
# 포트 변경 (docker-compose.yml에서 3000 → 3001로 변경)
ports:
  - "3001:8080"   # 3000 대신 3001 사용

# docker 그룹에 현재 사용자 추가
sudo usermod -aG docker $USER
 
# 즉시 적용 (재로그인 없이)
newgrp docker
 
# 확인
docker ps

# Pipelines 컨테이너 실행
docker run -d \
  --name pipelines \
  -p 9099:9099 \
  --add-host=host.docker.internal:host-gateway \
  -v pipelines:/app/pipelines \
  --restart unless-stopped \
  ghcr.io/open-webui/pipelines:main
 
# Open WebUI에 Pipelines 연결
# Admin Panel → Settings → Connections → OpenAI API 추가
# URL: http://pipelines:9099 (같은 Compose 네트워크) 또는 http://localhost:9099