Host Mapping

개요

Host Mapping은 특정 도메인의 요청을 다른 호스트로 리다이렉트하는 기능입니다. /etc/hosts 파일을 수정하는 것과 유사하지만, 시스템 설정을 변경하지 않고 프록시 수준에서 동적으로 호스트를 매핑합니다.

스테이징 서버 테스트, 로컬 개발 서버 연결, 서버 마이그레이션 검증 등의 시나리오에서 시스템 hosts 파일을 수정하지 않고도 도메인 단위로 트래픽을 제어할 수 있습니다.


설정 항목

항목설명
소스 호스트매칭할 도메인 패턴 (와일드카드 지원, 예: *.api.example.com)
소스 포트매칭할 포트 (미지정 시 모든 포트)
대상 호스트리다이렉트할 IP 주소 또는 도메인
대상 포트리다이렉트할 포트 (미지정 시 원본 포트 유지)
활성화규칙 활성화/비활성화

와일드카드 패턴

소스 호스트에 와일드카드 패턴을 사용하여 여러 서브도메인을 한 번에 매핑할 수 있습니다.

패턴매칭 예시
api.example.com정확한 도메인 매칭
*.example.comapi.example.com, cdn.example.com
*.api.example.comv1.api.example.com, v2.api.example.com

활용 사례

스테이징 서버 테스트

소스: api.example.com
대상: staging.internal.example.com

프로덕션 도메인으로의 요청을 스테이징 서버로 라우팅하여, 프론트엔드 코드 변경 없이 스테이징 환경을 테스트합니다.

로컬 개발

소스: api.example.com
대상: 127.0.0.1
대상 포트: 3000

API 요청을 로컬 개발 서버로 라우팅합니다. 프론트엔드 앱을 프로덕션 URL로 접속하면서도 API는 로컬 서버를 사용할 수 있습니다.

서버 마이그레이션 검증

소스: *.old-service.com
대상: new-service.com

기존 서비스 도메인을 새 서비스로 매핑하여 마이그레이션 전 동작을 검증합니다.


사용 방법

Desktop

  1. 사이드바에서 Host Mapping 메뉴 선택
  2. 규칙 추가 버튼 클릭
  3. 소스 호스트, 대상 호스트, 포트 설정
  4. 저장

MCP

"api.example.com을 localhost:3000으로 매핑해줘"
"호스트 매핑 규칙 목록을 보여줘"