docs: Docker API 제한 및 서버 간 접근 폴백 원칙 추가

journey/troubleshooting/251228_admin_서비스_헬스체크_개선.md

@@ -49,6 +49,18 @@
 - 다른 서버에 있는 서비스는 제거
 - docker_services 매핑은 실제 컨테이너 이름 사용
 
+### Docker API 제한 및 폴백 원칙
+
+**원칙**:
+- Docker API는 같은 서버의 컨테이너만 조회 가능 (다른 서버의 컨테이너는 조회 불가)
+- Docker API 체크 실패 시(`not_found`, `error`) HTTP 헬스체크로 자동 폴백
+- 서버 간 접근 시 URL 폴백: `172.17.0.1` 실패 시 `192.168.219.45`로 재시도
+
+**이유**:
+- Docker API는 로컬 Docker 데몬에만 접근 가능하여 원격 서버 컨테이너 조회 불가
+- 서버 간 서비스 체크는 HTTP 헬스체크로만 가능
+- Docker 네트워크 IP(`172.17.0.1`)는 같은 서버 내부에서만 유효, 서버 간 접근은 실제 IP(`192.168.219.45`) 필요
+
 ---
 
 ## 참고