Guide
Cheolsu Proxy is an HTTP/HTTPS debugging proxy built with Rust and Tauri. It sits between your browser or application and the server, allowing you to monitor and analyze network traffic in real time. It's useful for API development, frontend debugging, mobile app testing, and more.
Getting Started
Installation
How to download and install Cheolsu Proxy on your system. Cheolsu Proxy supports macOS and provides three interfaces: Desktop GUI, TUI, and MCP Server.
Basic Usage
Learn the basics of starting the proxy and capturing traffic. If you're new to Cheolsu Proxy, start here.
SSL Certificates
To capture HTTPS traffic, you need to install and trust Cheolsu Proxy's CA certificate on your system. This guide covers platform-specific installation steps.
Core Concepts
Proxying
How Cheolsu Proxy works as a proxy, system proxy configuration, manual proxy setup, upstream proxy, and the daemon architecture.
Recording
Traffic capture, table/tree views, request/response details, HAR export, and more.
Sessions
Save and load captured traffic as sessions for later review.
Troubleshooting
Solutions for common issues including proxy startup failures, website access problems, HTTPS certificate issues, and performance problems.
Advanced Features
Beyond capturing traffic, Cheolsu Proxy offers powerful tools for manipulating and automating requests and responses.
- Cheolsu-Query - Network request filtering query language
- Intercept Rules - Block, modify, or redirect requests
- Scripting - Automate traffic manipulation with JavaScript/TypeScript
- WebSocket - WebSocket traffic monitoring and injection
- Server Replay - Cache and reuse captured responses
- MCP Server - AI assistant integration
Security Considerations
Use only for development and testing purposes. Cheolsu Proxy is a powerful tool that can intercept and modify network traffic. Please observe the following:
- No malicious use — Do not use Cheolsu Proxy for data tampering, unauthorized interception, or any malicious purpose.
- Corporate compliance — When using in a corporate environment, obtain IT department approval and comply with company policies.
- Privacy protection — Do not intercept traffic containing sensitive personal information. Ensure sensitive data is not recorded in logs.
- Legal responsibility — Users are responsible for all legal consequences of using Cheolsu Proxy.
Get Started: Begin with Installation, or if already installed, jump to Basic Usage.