문제 해결 대조표
현상별로 찾으세요. 안 되면 App 설정 → 도움말과 피드백 → 문제 제보（스크린샷·문제 로그）또는 피드백 이메일. 가능하면: OS, 도구（Ollama / LM Studio / KoboldCPP 등）, Base URL（IP 뒤 두 구간 마스킹）, 오류 원문.
연결 / 테스트
| 현상 | 가능 원인 | 처리 |
|---|---|---|
| 연결 타임아웃 | 다른 Wi‑Fi, 방화벽, 서비스가 0.0.0.0 미리슨 | 같은 망; 포트 개방; 각 도구 「서비스 / LAN」장 |
| 즉시 실패 / 연결 불가 | IP·포트 오류, 서비스 미기동 | PC 브라우저 http://IP:포트/v1/models; Base URL 확인 |
| localhost여도 실패 | 폰의 localhost는 폰 자신 | PC LAN IP로 변경 |
| 401 / 키 오류 | 일부 로컬 스택이 Key 검증 | 비어 있지 않은 자리, 또는 도구 문서대로 인증 끔 |
| 404 / 모델 없음 | 로컬과 모델명 불일치 | ollama list 또는 /v1/models에서 전체 id |
| 응답 있으나 채팅 빈칸/오류 | 호환성, 타임아웃 짧음, 미로드 | 타임아웃↑; 모델 load 확인; 작은 모델로 경로 검증 |
네트워크와 시스템
| 현상 | 가능 원인 | 처리 |
|---|---|---|
| PC OK, 폰 안 됨 | 게스트 Wi‑Fi 격리, AP 격리 | 주 네트워크; 임시로 폰 핫스팟에 PC 접속 |
| 간헐 끊김 | PC 절전, IP 변경 | 절전 금지; IP 재확인·연결 갱신 |
| VPN 후 이상 | 분기/가상 NIC | 테스트 시 VPN 끄거나 LAN 제외 |
URL 표기
| 올바른 예 | 잘못된 예 |
|---|---|
http://192.168.1.8:11434/v1 | http://localhost:11434/v1 |
http://192.168.1.8:1234/v1 | http://192.168.1.8:1234/v1/chat/completions |
http://192.168.1.8:5001/v1 | https://192.168.1.8:11434/v1（로컬에 인증서 없으면 https 강제 금지） |
http://192.168.1.8:8080/v1 |
HTTP 평문
MiniTavern Android는 평문 HTTP（LAN 흔함）허용. 여전히 막히면:
- Base URL이
http://인지 - 시스템/제조사 네트워크 보호가 LAN을 막지 않는지
- iOS ATS 제한 시 문서의 LAN 주소 우선; 실패 시 OS 버전·오류 제보
CORS
브라우저 웹페이지만 CORS에 자주 걸림; 네이티브 App 직결 API는 보통 CORS 무관. PC 브라우저 프론트가 실패해도 MiniTavern 실패는 아님 — App 내 테스트 기준.
성능
| 현상 | 처리 |
|---|---|
| 첫 글자 매우 느림 | 더 작은 양자화/파라미터; GPU 사용 확인 |
| 생성 중 멈춤 | 타임아웃↑; 다른 VRAM 점유 끔; PC 로그 OOM |