Cheolsu Proxy
  • 한국어

      • 설치 가이드

      Cheolsu Proxy를 설치하고 첫 실행까지의 과정을 안내합니다.

      시스템 요구사항

      macOS

      • 운영체제: macOS 12 (Monterey) 이상
      • 아키텍처: Apple Silicon (M1/M2/M3/M4). Intel(x64) 빌드는 현재 제공되지 않습니다.
      • 디스크 공간: 최소 200MB 이상의 여유 공간
      • 권한: 프록시 설정 변경을 위한 관리자 권한 필요

      Windows

      Windows 지원은 현재 준비 중입니다. 향후 릴리즈에서 제공될 예정입니다.

      다운로드

      최신 버전은 GitHub Releases 페이지에서 다운로드할 수 있습니다.

      1. GitHub Releases 페이지에 접속합니다
      2. 최신 릴리즈의 Assets 섹션에서 파일을 다운로드합니다
        • macOS (Apple Silicon): Cheolsu.Proxy_x.x.x_aarch64.dmg

      현재 빌드는 Apple Silicon(aarch64)만 제공됩니다. Intel(x64) 빌드는 제공되지 않습니다.

      macOS 설치

      .dmg 파일로 설치

      1. 다운로드한 .dmg 파일을 더블클릭하여 디스크 이미지를 마운트합니다
      2. Cheolsu Proxy 아이콘을 Applications 폴더로 드래그하여 복사합니다
      3. 설치가 완료되면 디스크 이미지를 언마운트(추출)합니다

      첫 실행 시 macOS Gatekeeper 안내

      Cheolsu Proxy를 처음 실행하면 macOS Gatekeeper가 실행을 차단할 수 있습니다. 이는 앱이 Apple의 공증(notarization)을 거치지 않은 경우 발생하는 정상적인 보안 동작입니다.

      해결 방법:

      1. Finder에서 Applications 폴더의 Cheolsu Proxy를 Control + 클릭 (또는 우클릭)합니다
      2. 컨텍스트 메뉴에서 열기를 선택합니다
      3. "확인되지 않은 개발자" 경고 대화상자에서 열기 버튼을 클릭합니다

      이 과정은 최초 실행 시 한 번만 필요합니다. 이후에는 정상적으로 실행됩니다.

      또는 시스템 설정 → 개인정보 보호 및 보안 하단에서 "확인 없이 열기" 옵션을 통해 허용할 수도 있습니다.

      현재 빌드는 Apple 공증/서명이 적용되어 있지 않습니다. 위 방법으로도 열리지 않으면 터미널에서 quarantine 속성을 제거할 수 있습니다.

      xattr -cr "/Applications/Cheolsu Proxy.app"

      인터페이스 소개

      Cheolsu Proxy는 세 가지 인터페이스를 제공합니다. 사용 목적과 환경에 따라 적합한 인터페이스를 선택하세요.

      1. Desktop GUI

      Tauri 기반의 데스크톱 애플리케이션입니다. 트래픽 테이블, 상세 보기, 인터셉트 규칙 설정 등 모든 기능을 시각적으로 사용할 수 있습니다. 대부분의 사용자에게 권장되는 기본 인터페이스입니다.

      2. TUI (Terminal User Interface)

      터미널에서 동작하는 텍스트 기반 인터페이스입니다. SSH 환경이나 GUI를 사용할 수 없는 서버 환경에서 유용합니다. Desktop GUI와 동일한 프록시 데몬에 연결하여 트래픽을 모니터링합니다.

      3. MCP Server

      Model Context Protocol 서버로, Claude Code, Cursor 등 AI 어시스턴트에서 캡처된 트래픽을 직접 조회하고 조작할 수 있습니다. 자세한 내용은 MCP Server 문서를 참고하세요.

      TUI 실행 방법

      TUI는 터미널에서 cheolsu-tui 바이너리로 실행합니다. Desktop GUI와 동일한 프록시 데몬에 연결되므로, 두 인터페이스를 동시에 사용할 수도 있습니다.

      cheolsu-tui

      CLI를 설치했다면 cheolsu tui로도 실행할 수 있습니다.

      cheolsu tui --port 8100

      TUI 바이너리(cheolsu-tui)는 Desktop 앱 번들에 사이드카로 포함되어 있습니다. 터미널에서 직접 실행하려면 앱 번들 내부의 바이너리를 PATH에 추가하거나 소스에서 빌드(cargo build -p cheolsu-proxy-tui --release)하세요.

      다음 단계

      설치가 완료되었다면 다음 가이드를 따라 진행하세요.

      • 기본 사용법: 프록시 시작, 트래픽 확인, HAR 내보내기 등 기본적인 사용법을 익힙니다
      • SSL 인증서 설치: HTTPS 트래픽을 가로채려면 인증서 설치가 필요합니다
      • 프록시 설정: 시스템 프록시 설정 및 모바일 기기 연결 방법을 알아봅니다