# PharmQ 인프라 트러블슈팅 & 설치 가이드

약국 인프라 설치/운영 중 발생하는 고급 트러블슈팅 기록 및 설치 스크립트 문서.

## 설치 스크립트

### 개별 실행 (단계별)
```bash
# 1단계: PVE 구독 제한 해제
curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/fix-pve9-repos.sh | bash

# 2단계: Headscale VPN 등록 + 약국 생성
curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/headscale-auto-register.sh | bash

# 3단계: PBS 등록 + VM 복원
curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/pbs_allinone.sh | bash
```

### 통합 실행 (원클릭)
```bash
# 전체 통합: Repo Fix → VPN → PBS → CT 생성 → 약국/장비/계정 등록
curl -fsSL https://git.0bin.in/thug0bin/pve9-repo-fix/raw/branch/main/pharmq-setup.sh | bash
```

통합 스크립트 8단계:
1. PVE Repository Fix (구독 제한 해제)
2. PVE Host Tailscale → Headscale 등록
3. 약국 정보 수집 (대화형)
4. PBS 등록 + Windows VM(팜IT3000) 복원
5. Ubuntu CT 자동 생성
6. CT 내부 환경 구축 (ODBC, Tailscale, API)
7. farmq.db 약국 + 장비 2개 + gateway 계정 등록
8. 검증 + 로그인 정보 출력

## 트러블슈팅 문서

| 문서 | 주제 | 날짜 |
|------|------|------|
| [caddy-headscale-proxy.md](caddy-headscale-proxy.md) | Caddy + Headscale 리버스 프록시 — HTTP 리다이렉트 + HTTP/2 Upgrade 충돌 | 2026-04-06 |
| [nat-hairpinning.md](nat-hairpinning.md) | 같은 LAN에서 공인 IP 접근 시 NAT Hairpinning 문제 | 2026-04-06 |
| [odbc-freetds-conflict.md](odbc-freetds-conflict.md) | MSSQL named instance — FreeTDS vs ODBC Driver 18 충돌 | 2026-04-06 |