Cheolsu Proxy
  • 한국어

      • 기본 사용법

      Cheolsu Proxy를 처음 사용하는 분들을 위한 가이드입니다. 프록시를 시작하고, 트래픽을 캡처하고, 요청/응답을 확인하는 기본적인 흐름을 설명합니다.

      프록시 시작

      Cheolsu Proxy를 실행하면 데몬 프로세스가 자동으로 시작되면서 프록시 서버가 활성화됩니다. 기본 포트는 8100입니다.

      Desktop GUI

      1. Cheolsu Proxy 앱을 실행합니다.
      2. 앱이 실행되면 프록시 데몬이 자동으로 시작됩니다.
      3. macOS의 시스템 프록시가 자동으로 설정되어 즉시 트래픽 캡처가 시작됩니다.

      TUI (터미널)

      터미널에서 cheolsu-proxy-tui 바이너리를 실행하면 터미널 기반 인터페이스가 시작됩니다. TUI도 동일한 프록시 데몬에 연결됩니다.

      HTTPS 트래픽 캡처를 위한 인증서 설정

      Cheolsu Proxy가 HTTPS 트래픽을 캡처하려면 CA 인증서를 시스템에 설치하고 신뢰 설정을 해야 합니다. 인증서가 설치되지 않으면 HTTPS 사이트에서 보안 경고가 표시됩니다.

      macOS

      1. Cheolsu Proxy에서 설정 → 인증서를 클릭합니다.
      2. "인증서 설치" 버튼을 클릭합니다.
      3. 시스템에 인증서가 설치됩니다.
      4. Keychain Access 앱을 열고, Cheolsu Proxy 인증서를 찾아 더블클릭합니다.
      5. **"항상 신뢰"**로 설정합니다.

      인증서 설치에 대한 자세한 내용은 SSL 인증서 가이드를 참조하세요.

      트래픽 확인

      프록시가 시작되면 브라우저나 애플리케이션의 네트워크 요청이 Cheolsu Proxy를 통과하면서 실시간으로 캡처됩니다.

      트래픽 테이블

      메인 화면의 네트워크 대시보드에서 캡처된 트래픽 목록을 확인할 수 있습니다. 각 항목에는 다음 정보가 표시됩니다:

      • HTTP 메서드 (GET, POST, PUT 등)
      • URL
      • 응답 상태 코드
      • 응답 크기
      • 소요 시간

      호스트/경로 트리 뷰

      대시보드의 트리 뷰를 사용하면 호스트와 경로별로 트래픽을 계층적으로 탐색할 수 있습니다. 특정 도메인이나 API 엔드포인트의 트래픽만 집중해서 볼 때 유용합니다.

      요청/응답 상세 보기

      트래픽 테이블에서 항목을 선택하면 해당 트랜잭션의 상세 정보를 볼 수 있습니다:

      • 요청: 메서드, URL, 헤더, 바디
      • 응답: 상태 코드, 헤더, 바디
      • 타이밍: 요청/응답 소요 시간

      트래픽 필터링

      캡처된 트래픽이 많을 때 Cheolsu-Query를 사용하여 원하는 요청만 필터링할 수 있습니다. 쿼리 바에서 다음과 같이 입력합니다:

      method="GET" and url|="api"

      이 쿼리는 URL에 "api"가 포함된 GET 요청만 표시합니다. 더 자세한 쿼리 문법은 Cheolsu-Query 문서를 참조하세요.

      HAR 내보내기

      캡처된 트래픽을 HAR (HTTP Archive) 1.2 형식으로 내보낼 수 있습니다. HAR 파일은 Chrome DevTools, Firefox, Charles Proxy 등 다양한 도구에서 열 수 있는 표준 형식입니다.

      Desktop

      1. 네트워크 대시보드에서 트래픽을 캡처합니다.
      2. 상단의 다운로드 버튼을 클릭합니다.
      3. 저장 경로를 선택하면 .har 파일이 생성됩니다.

      TUI

      1. 네트워크 화면에서 e 키를 누릅니다.
      2. 현재 디렉토리에 cheolsu-proxy-YYYYMMDD-HHMMSS.har 파일이 생성됩니다.

      프록시 중지

      Desktop GUI에서 "프록시 중지" 버튼을 클릭하거나 앱을 종료하면 프록시가 중지되고 시스템 프록시 설정이 자동으로 복원됩니다.

      다음 단계

      기본 사용법을 익혔다면 다음 기능들을 살펴보세요: