Madhyamas

트래픽 캡처 및 검사

Madhyamas는 실시간 HTTP/HTTPS 인터셉트를 통해 트래픽을 캡처하고 자동 TLS 인증서 생성을 제공합니다. HTTP/2 및 gRPC(실험적) 업스트림을 지원하며, WebSocket 메시지를 실시간으로 캡처하고 표시합니다. 가상화된 행을 갖춘 워터풀 타임라인 차트로 요청 타이밍을 시각화하고, 구문 강조 표시된 코드 및 트리 뷰에서 JSONPath 및 JMESPath 쿼리를 지원하는 JSON 뷰어를 제공합니다. PNG, JPEG, GIF, WebP, SVG 등에 대한 인라인 렌더링을 통해 이미지 미리보기를 제공하고, 요청 및 응답 본문 전체에서 전체 텍스트 검색을 수행할 수 있습니다. 필요 시 gzip/deflate/brotli 압축 해제를 토글하고, 어떤 요청이라도 cURL, HTTPie, fetch 또는 wget 명령어로 내보낼 수 있습니다. 헤더 및 본문 크기를 목록 및 상세 뷰에서 정확하게 추적할 수 있습니다.

트래픽 조작

브레이크포인트를 설정하여 요청 또는 응답을 일시 중지하고 검사 및 편집한 후 전달할 수 있습니다. 단일, 시퀀스, 조건부 및 확률적 모의 응답을 제공하며, 컬렉션, 기록, 내보내기/가져오기 기능을 지원합니다. 내장 템플릿(캐싱 없음, CORS 추가 등) 또는 사용자 정의 규칙을 사용하여 URL, 헤더 및 본문을 수정하는 리라이트 규칙을 제공합니다. 3G, 4G, DSL 또는 사용자 정의 지연 프로파일을 시뮬레이션하는 대역폭 스로틀링 기능을 갖추고 있습니다. 캡처된 요청을 수정하여 재실행하고, 반복, 동시성 및 지연을 갖춘 배치 재생을 지원합니다. 도메인 및 패턴 차단 목록을 인터셉트 레이어에서 제공하고, 필터링 없이 일치하는 호스트를 시각적으로 강조하는 포커스 모드를 제공합니다.

프록시 모드

표준 프록시로 포트 8888에서 MITM을 사용하는 HTTP/HTTPS 프록시 모드를 제공합니다. 포트 1080에서 블라인드 TCP 터널링을 위한 SOCKS5 프록시 모드를 지원합니다. 바이패스 목록과 함께 HTTP/HTTPS/SOCKS5 업스트림 프록시를 통해 아웃바운드 트래픽을 라우팅하는 업스트림 체이닝 기능을 갖추고 있습니다.

세션 및 내보내기

디버깅 세션을 저장하고 복원할 수 있는 세션 관리 기능을 제공합니다. 산업 표준 HTTP Archive 형식인 HAR 내보내기/가져오기를 지원하며, 캡처된 요청에 대한 cURL 명령어를 생성할 수 있습니다. 선택적 회전과 함께 주기적인 HAR/세션 백업을 제공하는 자동 저장 기능을 갖추고 있습니다. URL 경로 구조를 미러링하여 디스크에 응답 본문을 저장하는 미러 도구를 제공하며, FIFO 프루닝을 갖춘 구성 가능한 최대 요청 수, 총 크기 및 본문 크기를 갖춘 녹화 제한 기능을 제공합니다.

스크립팅 및 플러그인

boa_engine를 통한 ES6+ JavaScript 스크립팅을 제공하여 트래픽 조작을 자동화하며, 13개의 내장 템플릿과 SQLite-지속 스크립트를 지원합니다. wasmtime을 통한 샌드박스화된 WASM 플러그인을 제공하여 기능을 확장하며, 연료 계측, Ed25519 서명 및 핫 리로드를 지원합니다.

AI 에이전트 통합

Claude Desktop, Windsurf 및 기타 AI 기반 도구를 위한 stdio 전송의 내장 Model Context Protocol(MCP) 서버를 제공합니다. 트래픽, 모의, 브레이크포인트, 세션 및 구성을 포함한 트래픽에 대한 프로그래밍적 접근을 제공하는 146개의 MCP 도구를 갖추고 있습니다. 스크립팅 및 자동화를 위한 159개의 CLI 하위 명령어와 외부 도구와의 통합을 위한 184개의 REST 엔드포인트를 제공합니다.

다운로드 및 설치 방법

공식 배포 채널이 명시되지 않았으므로, 소스 코드에서 직접 빌드하여 사용해야 합니다. Rust 툴체인이 설치된 시스템에서 다음 명령을 실행하여 릴리스 빌드를 생성할 수 있습니다:

cargo build --release

빌드가 완료되면, 대상 디렉터리에서 실행 파일을 실행합니다:

./target/release/madhyamas

프록시를 시작한 후, 브라우저 또는 기기의 프록시 설정을 localhost:8888로 지정합니다. 그런 다음 웹 브라우저에서 http://localhost:3001을 열어 대시보드에 접근할 수 있습니다. 모바일 디바이스의 경우, 인증서 설치 및 고급 구성에 대한 자세한 내용은 Getting Started Guide를 참조하십시오.

기본 사용법

Madhyamas를 시작한 후, 웹 브라우저에서 http://localhost:3001을 열어 대시보드에 접근합니다. 여기서 실시간으로 캡처된 트래픽을 목록 형태로 볼 수 있으며, 개별 항목을 클릭하여 요청 및 응답 헤더, 본문, 타이밍 정보를 상세히 검사할 수 있습니다. 상단 메뉴를 통해 브레이크포인트 설정, 모의 응답 생성, 리라이트 규칙 적용, 대역폭 스로틀링 구성 등의 기능을 사용할 수 있습니다. 세션 패널에서 현재 디버깅 세션을 저장하거나 이전에 저장된 세션을 불러올 수 있으며, HAR 내보내기 버튼을 클릭하여 캡처된 트래픽을 표준 형식으로 저장할 수 있습니다. 스크립트 콘솔을 통해 JavaScript를 사용하여 트래픽을 프로그래밍적으로 조작할 수 있으며, AI 에이전트 연동을 위해서는 MCP 서버가 자동으로 시작됩니다.

이런 경우에 유용합니다

API 개발 중인 개발자는 Madhyamas를 사용하여 API 호출을 검사하고, CORS 문제를 디버그하며, JSONPath 쿼리를 통해 JSON 응답을 쉽게 분석할 수 있습니다. 모바일 앱 개발자는 iOS/Android 기기의 네트워크 트래픽을 디버그하고, 인증서 고정 우회를 테스트할 수 있습니다. 프론트엔드 개발자는 백엔드가 준비되기 전에 실제 트래픽을 기록하여 모의 API를 구축하고, 오류 처리 로직을 테스트할 수 있습니다. 성능 엔지니어는 느린 네트워크 조건을 시뮬레이트하고, 캡처된 요청을 배치 재생하여 부하 테스트를 수행하며, 워터풀 분석을 통해 병목 현상을 식별할 수 있습니다. QA 엔지니어는 정확한 실패 요청을 캡처하여 내보내고, 배포 후 회귀 테스트를 위해 재생할 수 있습니다. 보안 분석가는 인증 토큰을 검사하고, 광고/트래커를 차단하며, 테스트를 위해 보안 헤더를 제거할 수 있습니다. 자동화 엔지니어는 JavaScript 훅을 사용하여 트래픽을 로그, 수정, 차단 또는 모의 프로그래밍적으로 처리할 수 있습니다. AI 도구 사용자는 Claude 또는 Windsurf와 같은 에이전트를 MCP를 통해 연결하여 트래픽을 검사하고 조작할 수 있습니다. 팀 및 엔터프라이즈 사용자는 인증이 가능한 공유 프록시를 설정하고, 감사 추적을 유지하며, 다중 인스턴스 클러스터링을 구성하고, CI/CD 파이프라인에서 API 키를 관리할 수 있습니다. 네트워크 엔지니어는 기업 프록시 체이닝을 구성하고, gRPC 트래픽을 검사하며, WebSocket 연결을 디버그하고, SOCKS5 터널링을 설정할 수 있습니다. 협업 팀은 HAR 내보내기를 공유하고, 스테이징 및 프로덕션 환경을 비교하며, 세션별로 트래픽을 정리할 수 있습니다. 규정 준수 담당자는 세션을 자동 저장하고, API 응답을 디스크에 미러링하여 감사 추적을 내보낼 수 있습니다. Charles 또는 Fiddler에서 전환하는 사용자는 HAR 파일을 가져오고, Charles의 기능을 Madhyamas에 매핑할 수 있습니다.

제한 사항·확인 사항

엔터프라이즈 기능은 `enterprise` Cargo 기능 뒤에 게이트되어 있으며, BSL-1.1 라이선스로 제공됩니다. 오픈소스 핵심은 MIT 또는 Apache-2.0 라이선스로 제공되지만, 엔터프라이즈 크레이트(`madhyamas-enterprise`)는 별도의 라이선스가 적용됩니다. 엔터프라이즈 기능을 사용하려면 PostgreSQL 및 Redis와 같은 외부 서비스가 필요하며, 인증 및 사용자 관리를 위한 추가 설정이 필요합니다. 현재 버전에서는 gRPC 및 WASM 플러그인 지원이 실험적 단계로 표시되어 있습니다.