chore: 실행 환경 구성 문서 추가 및 수정

docs/two-hop-proxy-header-contract.md

@@ -37,7 +37,7 @@ Keycloak을 올린 뒤에 로그인이 깨지면 **세션 문제인지 프록시
 │                                                              │
 │  [스위치 1] nginx  ← 호스트 OS 의 프로세스                     │
 │    /etc/nginx/sites-available/keycloak-lab                   │
-│    = deploy/lab/host/nginx-keycloak-lab.conf                 │
+│    = deploy/lab/edge/nginx-keycloak-lab.conf                 │
 │                                                              │
 │  ┌─ kc-lab-1 (VM) ─────────────┐ ┌─ kc-lab-2 (VM) ────────┐  │
 │  │  svclb 파드  :80            │ │  svclb 파드  :80       │  │
@@ -50,9 +50,15 @@ Keycloak을 올린 뒤에 로그인이 깨지면 **세션 문제인지 프록시
 └──────────────────────────────────────────────────────────────┘
 ```
 
+> **이 측정 당시 nginx 는 물리 호스트에서 돌았다.** 2026-09-10 에 엣지 계층이
+> `kc-lab-edge`(192.168.122.10) 게스트로 옮겨졌고, 설정 파일도
+> `deploy/lab/host/` 에서 `deploy/lab/edge/` 로 옮겼다. **홉 수는 그대로 2홉**
+> 이라 아래 계약은 유효하지만, 앞단에 커널 DNAT 한 겹이 생겼으므로
+> `X-Forwarded-For` 는 이동 후 다시 재야 한다.
+
 | # | 무엇 | 사는 곳 | 설정 파일 |
 |---|---|---|---|
-| 1 | nginx | **호스트 OS의 프로세스** | `deploy/lab/host/nginx-keycloak-lab.conf` |
+| 1 | nginx | **호스트 OS의 프로세스** (이동 후: `kc-lab-edge` 게스트) | `deploy/lab/edge/nginx-keycloak-lab.conf` |
 | 2 | Traefik | **클러스터 안 파드 1개** | `HelmChartConfig` (kube-system) |
 | 3 | 앱 | **클러스터 안 파드 N개** | 각 앱의 매니페스트 `env` |
 
@@ -507,7 +513,7 @@ downstream 앱은 **이 헤더를 믿고 "누가 로그인했는지"를 판단**
 
 | | |
 |---|---|
-| 저장소 파일 | `deploy/lab/host/nginx-keycloak-lab.conf` |
+| 저장소 파일 | `deploy/lab/edge/nginx-keycloak-lab.conf` |
 | 서버 배포 위치 | `/etc/nginx/sites-available/keycloak-lab` |
 | 활성화 | `/etc/nginx/sites-enabled/keycloak-lab` 심볼릭 링크 |
 
@@ -532,7 +538,7 @@ downstream 앱은 **이 헤더를 믿고 "누가 로그인했는지"를 판단**
 
 ```bash
 cd ~/workspace/keycloak-pattern && git pull
-sudo cp deploy/lab/host/nginx-keycloak-lab.conf /etc/nginx/sites-available/keycloak-lab
+sudo cp deploy/lab/edge/nginx-keycloak-lab.conf /etc/nginx/sites-available/keycloak-lab
 sudo nginx -t && sudo systemctl reload nginx
 grep -n 'X-Forwarded-Proto\|X-Forwarded-Port' /etc/nginx/sites-available/keycloak-lab
 ```