Add troubleshooting docs: Caddy+Headscale proxy, NAT hairpinning, ODBC conflict

- caddy-headscale-proxy.md: HTTP redirect + HTTP/2 Upgrade header conflict fix
- nat-hairpinning.md: Same-LAN public IP access issue and auto-detection
- odbc-freetds-conflict.md: FreeTDS vs ODBC Driver 18 for MSSQL named instances
- README.md: Install script commands (individual + unified) and doc index

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
thug0bin
2026-04-06 15:37:16 +00:00
parent 6b02e5c35b
commit c42d1b70ea
4 changed files with 314 additions and 2 deletions

View File

@@ -1,3 +1,41 @@
# infra-troubleshooting
# PharmQ 인프라 트러블슈팅 & 설치 가이드
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 |