English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
macOS용 오픈소스, 감사 가능한 디버깅 프록시.
직접 검사하고 빌드하며 신뢰할 수 있는 네이티브 Swift 앱으로 HTTP/HTTPS/WebSocket/GraphQL 트래픽을 가로채고, 검사하고, 수정하세요.
Rockxy가 진화하면서 API, 모바일, MCP 지원, AI, 블록체인 시대의 디버깅 워크플로까지 품도록 설계되었습니다.
Proxyman과 Charles Proxy를 대체하는 local-first, AGPL-3.0 선택지.
모든 Mac 앱, CLI 또는 iOS 기기의 HTTP, HTTPS, WebSocket, GraphQL 트래픽을 검사합니다. 브라우저 DevTools는 브라우저에서 끝나지만 — Rockxy는 스택의 나머지 부분까지 봅니다.
`HTTP / HTTPS` · `WebSocket` · `GraphQL` · `iOS Device & Simulator` · `Filter by Process ID` · `Timing Waterfall`
### 고급 필터 및 검색
수천 개의 캡처된 요청을 몇 초 안에 좁힙니다. 메서드, 호스트, 상태, 헤더, 본문, 프로세스 필터를 조합하거나 전체 세션에 대한 전체 텍스트 검색을 실행하세요.
`Multi-Field Filters` · `Full-Text Search` · `Status / Method` · `Header / Body Match` · `Process / Host` · `Saved Filters`
### AI 어시스턴트용 MCP 서버
Claude Desktop 또는 Cursor가 로컬 MCP 서버를 통해 캡처한 트래픽을 읽도록 합니다. 채팅에 헤더를 붙여넣는 대신 "왜 500이 났지?"라고 바로 물어보세요. 로컬, redaction-aware, 오픈소스입니다.
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### Developer Setup Hub
Python, Node.js, Go, Rust, cURL, Docker 및 브라우저용 프록시 스니펫을 복사 붙여넣기한 다음 Run Test를 클릭해 트래픽이 실제로 흐르는지 확인하세요.
`Python` · `Node.js` · `Go / Rust / Java` · `cURL / Docker` · `One-Click Verify` · `Trust Diagnostics`
### HTTPS 디버깅용 인증서 관리
처음 실행 시 생성된 P-256 ECDSA 루트 CA를 Keychain에 봉인합니다. HTTPS를 첫 시도에 복호화하고, 핀된 호스트는 자동으로 우회됩니다.
`P-256 ECDSA Root CA` · `Keychain-Sealed Key` · `Per-Host Leaf Certs` · `Trust Wizard` · `Pinned-Host Passthrough` · `Rotate / Reset`
### SSL 프록시 및 HTTPS 복호화
어떤 호스트에서 TLS 복호화할지 선택합니다. 복호화된 트래픽은 실제 헤더와 JSON을 보여주고, 나머지는 암호화된 상태로 통과합니다. 와일드카드 규칙으로 한 번의 클릭으로 도메인 단위 범위를 지정할 수 있습니다.
`Per-Host Decryption` · `Wildcard Rules` · `Allow / Deny List` · `TLS 1.2 / 1.3` · `Pinned Host Passthrough`
### Bypass Proxy
특정 호스트를 건너뛰어 인증서가 핀된 앱, 내부 서비스 또는 시끄러운 텔레메트리가 캡처에 들어오지 않게 합니다. 와일드카드로 목록을 짧게 유지하고 요청 로그를 정말 신경 쓰는 것에 집중시킵니다.
`Per-Host Bypass` · `Wildcard Patterns` · `Skip Pinned Hosts` · `Mute Telemetry` · `Reduce Noise` · `Toggle Anytime`
### Block List
어떤 호스트든 실패시킵니다. 광고 네트워크, 서드파티 트래커 또는 불안정한 종속성을 잘라내 사라졌을 때 앱이 어떻게 저하되는지 — 코드 한 줄 바꾸지 않고 — 봅니다.
`Per-Host Block` · `Wildcard Match` · `Simulate Outage` · `Test Fallbacks` · `Strip Trackers` · `Toggle Anytime`
### Map Local
실제 응답 대신 저장된 파일이나 디렉토리 트리를 제공합니다. JSON 페이로드를 바꾸거나 스냅샷을 재생하거나 디버깅 중에만 불안정한 서드파티 API를 로컬 복사본으로 고정할 수 있습니다.
`File or Directory` · `Response Snapshot` · `Regex Patterns`
### Map Remote
앱 코드나 /etc/hosts를 건드리지 않고 캡처된 요청의 목적지를 다시 작성합니다. 프로덕션 트래픽을 스테이징, 개발 서버 또는 동료의 머신으로 보내 재현 가능한 버그 repro를 만듭니다.
`Host Rewrite` · `Regex Patterns` · `Preserve Host Header`
### 브레이크포인트 & 규칙
요청이나 응답을 일시 정지하고 method, header, body, status를 편집한 다음 계속합니다. 백엔드를 건드리지 않고 "API가 401을 반환하면?"을 가장 빠르게 테스트하는 방법입니다.
`Request Breakpoints` · `Response Breakpoints` · `Block` · `Throttle` · `Regex / Wildcard Match` · `Inject Failure States`
### 헤더 수정
재배포 없이 모든 호스트의 헤더를 추가, 제거 또는 교체합니다. 내장 프리셋으로 CORS, 인증 또는 캐시 변경을 몇 초 안에 테스트하세요.
`Add / Remove / Replace` · `CORS Presets` · `Auth Stripping` · `Request Phase` · `Response Phase` · `URL Pattern Scope`
### 커스텀 요청 & 응답 헤더
양쪽 phase를 완전히 제어하면서 호스트별로 헤더를 덮어씁니다. 송신 요청에 인증 토큰을 주입하거나 응답에서 Set-Cookie를 제거하거나 커스텀 User-Agent를 고정 — 언제든 토글할 수 있는 명명된 규칙으로 저장됩니다.
`Per-Host Override` · `Request Phase` · `Response Phase` · `Auth Token Inject` · `Cookie Strip` · `Named Rules`
### 네트워크 조건
3G, EDGE, LTE, WiFi 또는 커스텀 지연으로 throttle합니다. 당신의 노트북은 광섬유지만 사용자는 그렇지 않습니다 — 사용자가 보기 전에 400 ms RTT에서 UX를 확인하세요.
`3G` · `EDGE` · `LTE` · `WiFi` · `Very Bad Network` · `Custom Latency`
### Compose — 편집 & 재생
캡처된 모든 HTTP 요청을 다시 구성 — method, URL, header, 쿼리 파라미터, body 변경 — 후 Rockxy를 떠나지 않고 재전송합니다. Postman, Insomnia, curl 복사 붙여넣기 루프가 필요 없습니다. LLM 프롬프트를 반복하고 인증 경계를 퍼지하고 OpenAI, Anthropic, Cohere 엔드포인트의 실패 케이스를 몇 초 안에 재현합니다.
`Edit Headers` · `Edit Body` · `Edit Query` · `Edit Method` · `LLM Prompt Iteration` · `Postman Alternative` · `OAuth Flow Debug` · `Webhook Replay`
### 비교
두 개의 캡처된 응답을 나란히 쌓고 뒤집힌 모든 필드를 찾아냅니다 — status, header, JSON 키, body 바이트. 서드파티 diff 도구에 데이터를 넘기지 않고 조용한 API 회귀, 비결정적 LLM 출력, 프롬프트 드리프트를 잡아냅니다. Side-by-side diff는 변경된 부분을 강조하고, 깊은 JSON 비교는 키 순서를 무시합니다.
`Diff Compare` · `Side-by-Side` · `JSON Diff` · `Header Diff` · `Body Diff` · `LLM Output Compare` · `Non-determinism` · `API Regression` · `Schema Drift`
### 커스텀 프리뷰어 탭
요청과 응답 body를 원하는 방식으로 렌더링합니다. JSON, GraphQL, JWT, 이미지 또는 자체 포맷용 탭을 inspector에 고정 — 모든 캡처 요청에서 재사용할 수 있습니다.
`JSON` · `GraphQL` · `JWT Decoder` · `Image / Hex` · `Custom Format` · `Pinned per Inspector`
### 세션 & 내보내기
세션을 저장하고 도구 간 핸드오프를 위해 HAR을 import/export하며, 모든 요청을 cURL 또는 JSON으로 복사합니다. 공유 전에 authorization 헤더, 쿠키 및 bearer 토큰을 redact — 비밀을 누출하지 않고 동료에게 작동하는 버그 repro를 건넵니다.
`.rockxysession` · `HAR Import / Export` · `Copy as cURL` · `Copy as JSON` · `Raw HTTP` · `Secret Redaction` · `Token Sanitize` · `Privacy-Safe Share`
### 멀티탭 워크스페이스
독립적인 캡처 세션을 나란히 실행 — 한 탭은 스테이징, 한 탭은 프로덕션, 한 탭은 iOS 기기 빌드. 각 탭은 자체 필터, 선택, inspector 상태를 유지하므로 컨텍스트 전환 비용이 없습니다.
`Independent Sessions` · `Per-Tab Filters` · `Per-Tab Inspector` · `Compare Environments` · `Mac & iOS Together` · `Detach & Rename`
### JavaScript 스크립팅
정적 규칙으로 다룰 수 없는 경우를 위해 요청과 응답에 JS 훅을 답니다 — PII redact, 토큰 서명, 페이로드 재작성. 오류는 트래픽을 손상시키지 않고 inline으로 표시됩니다.
`Request Hooks` · `Response Hooks` · `Programmatic Filtering` · `PII Redaction` · `Inline Error Feedback`
## 곧 출시될 더 많은 기능
향후 기능은 공개적으로 추적되며 구현, 테스트, privacy behavior, 문서가 준비된 뒤에만 출시됩니다.
### AI 트래픽 검사 `곧 출시`
일반 capture workflow 안에서 model traffic을 더 쉽게 디버그합니다. AI request를 감지하고, 선택한 model call을 검사하고, streaming response를 진단하고, prompt/output behavior를 비교하며, 민감한 payload를 다른 서비스에 붙여넣지 않고 tool-call chain을 이해합니다.
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Web3/RPC 검사 `곧 출시`
블록체인 시대의 network call을 읽기 쉬운 debugging evidence로 바꿉니다. JSON-RPC와 Solana RPC traffic을 검사하고, 관련 call을 flow로 묶고, 일반적인 RPC error를 설명하며, Rockxy를 wallet이나 block explorer로 만들지 않고 selected request를 replay합니다.
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### x402 Payment Flow Debugging `곧 출시`
네트워크 계층에서 payment-gated HTTP flow를 이해합니다. payment-required response를 강조하고, retry path를 따라가며, debugging evidence를 local-first 및 redaction-aware로 유지합니다.
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### Redacted Evidence Bundles `곧 출시`
secret을 유출하지 않고 bug repro에 필요한 사실을 공유합니다. selected traffic을 protocol summary, redaction preview, source-backed context와 함께 패키징해 동료가 감사할 수 있게 합니다.
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### Protocol-Aware Filters & Rules `곧 출시`
Rockxy가 이미 작동하는 곳에서 AI와 Web3 metadata를 사용합니다: filter, badge, optional column, comparison, rule, Developer Setup, local MCP summary.
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### 팀 공유 & 협업 `곧 출시`
한 번의 클릭으로 캡처된 세션을 동료에게 보냅니다. 실패한 요청에 inline 주석을 달고 누가 무엇을 보고 있는지 실시간으로 확인하며 화면 공유 없이 HTTPS 트래픽을 pair-debug합니다. 향후 릴리스를 목표로 합니다.
`Shared Sessions` · `Team Workspaces` · `Inline Comments` · `Live Cursor` · `Cloud Sync` · `Pair Debug` · `SSO` · `Audit Log`
> 100% 네이티브 macOS. Electron 없음. 웹 뷰 없음. SwiftUI + AppKit + SwiftNIO.
## 빠른 시작
```bash
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj
```
Xcode에서 빌드하고 실행. 환영 윈도우가 루트 CA 설정, 헬퍼 설치, 프록시 활성화를 안내합니다.
**요구 사항:** macOS 14.0+, Xcode 16+, Swift 5.9
## Rockxy vs. 대안 도구
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **프로젝트 모델** | AGPL-3.0 오픈소스 프로젝트 | 독점 상용 앱 | 독점 상용 앱 |
| **소스 코드** | 공개, 감사 가능, fork 가능 | 비공개 소스 | 비공개 소스 |
| **소스에서 빌드** | 이 저장소에서 Xcode로 무료 빌드 | 공개 소스로는 제공되지 않음 | 공개 소스로는 제공되지 않음 |
| **네이티브 macOS 기반** | Swift + SwiftNIO + SwiftUI/AppKit | 네이티브 macOS 상용 앱 | 크로스 플랫폼 상용 앱 |
| **Local-first 캡처** | 로컬 프록시, 인증서, 헬퍼, 캡처 데이터가 Mac에 유지됨 | 데스크톱 프록시 앱 | 데스크톱 프록시 앱 |
| **개발자 설정 워크플로** | runtime, client, device, framework, environment를 위한 Developer Setup Hub 내장 | 제품별 설정 가이드 | 제품별 설정 가이드 |
| **MCP/local automation bridge** | 내장, 토큰 인증, 기본 마스킹 | 검토한 공개 문서에서 확인되지 않음 | 검토한 공개 문서에서 확인되지 않음 |
| **열린 기여 경로** | 공개 issues, discussions, roadmap, PR | 벤더가 관리하는 제품 | 벤더가 관리하는 제품 |
로드맵 방향: 더 깊은 replay/diff/rules/scripting 워크플로, 향상된 WebSocket 및 GraphQL 검사, AI와 Web3/RPC를 위한 protocol-aware debugging, x402-style payment-flow visibility, gRPC/Protobuf와 HTTP/2 및 HTTP/3 지원 탐색.
## 보안
Rockxy는 네트워크 트래픽을 가로챕니다 — 보안은 기반이지 선택이 아닙니다.
- XPC 헬퍼는 bundle ID만이 아닌 **인증서 체인 비교**로 호출자 검증
- 플러그인은 **샌드박스화된 JavaScriptCore**에서 실행, 5초 타임아웃, 파일시스템/네트워크 접근 불가
- 모든 경계에서 **입력 유효성 검사** — body 크기 제한, URI 제한, regex DoS 방지, 경로 순회 방지
- 로그에서 자격 증명 **자동 마스킹**
- 민감한 파일은 **0o600 권한**으로 저장
취약점 보고는 [SECURITY.md](SECURITY.md)를 참조. 자세한 내용은 [보안 아키텍처](docs/development/security.mdx)를 확인하세요.
## 로드맵
Rockxy의 공개 로드맵은 워크플로 중심이며 고정 날짜를 약속하지 않습니다. 안정성, 네이티브 macOS UX, 디버깅 워크플로, 프로토콜 지원, AI/Web3 시대의 traffic visibility, 문서, 기여자 온보딩에 집중합니다.
- [ROADMAP.md](ROADMAP.md): 공개 엔지니어링 방향의 큰 그림
- [Rockxy Public Roadmap](https://github.com/orgs/RockxyApp/projects/1): 로드맵 이슈의 실행 현황
## 문서
전체 문서는 [Rockxy Docs](docs/index.mdx)에서 확인 가능:
- [빠른 시작 가이드](docs/quickstart.mdx) — 몇 분 만에 설정
- [Developer Setup Hub](docs/features/developer-setup-hub.mdx) — 런타임 스니펫, 디바이스 가이드, 검증 프로브, 지원 매트릭스
- [아키텍처](docs/development/architecture.mdx) — 프록시 엔진, Actor 모델, 데이터 플로우
- [보안 모델](docs/development/security.mdx) — 신뢰 경계, XPC 검증, 인증서 관리
- [설계 결정](docs/development/design-decisions.mdx) — SwiftNIO, NSTableView, Actor를 선택한 이유
- [소스에서 빌드](docs/development/building.mdx) — 빌드, 테스트, lint, 디버그
- [코드 스타일](docs/development/code-style.mdx) — SwiftLint, SwiftFormat, 코딩 규칙
- [변경 기록](CHANGELOG.md) — 현재 브랜치 작업과 정식 릴리스 기록
## 기여
모든 종류의 기여를 환영합니다 — 코드, 테스트, 문서, 버그 리포트, UX 피드백.
설정 안내, 코드 스타일, PR 체크리스트는 **[CONTRIBUTING.md](CONTRIBUTING.md)**를 참조하세요.
초보자용 이슈는 [`good first issue`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue)로 표시되어 있습니다. PR을 제출하면 [CLA](CLA.md)에 동의한 것으로 간주합니다.
## 스폰서 및 파트너
Rockxy는 독립 개발자들이 구축하고 유지합니다. 후원금은 지속적인 개발, 보안 감사, 새로운 기능에 사용됩니다.
Made by Stephen. Swift, SwiftNIO, SwiftUI, AppKit으로 빌드.