Rockxy

English | Tiếng Việt | 中文 | 日本語 | 한국어 | Français | Deutsch

macOS용 오픈소스, 감사 가능한 HTTP 디버깅 프록시.

직접 검사하고 빌드하며 신뢰할 수 있는 네이티브 Swift 앱으로 HTTP/HTTPS/WebSocket/GraphQL 트래픽을 가로채고, 검사하고, 수정하세요.
Proxyman과 Charles Proxy를 대체하는 local-first, AGPL-3.0 선택지.

---

Latest Tagged Release

v0.23.0 — 2026-05-29

Added

• Added a more powerful advanced filter builder for narrowing traffic by URL, method, status, headers, body, app, domain, and other request or response fields.
• Added saved filter presets and inspector match highlighting so repeated investigations are faster to resume.
• Added upstream HTTP/HTTPS proxy support for routing captured traffic through another proxy when your network or lab setup requires it.
• Added Tools menu entries for external proxy settings, SOCKS proxy settings, Protobuf mappings, and Protobuf schema management.
• Added WebSocket Protobuf previews that make binary frame payloads easier to inspect as readable field trees.

Fixed

• Fixed bypass proxy handling during TLS setup so bypassed hosts avoid interception more reliably.
• Improved scripting stability so request and response scripts handle headers, console output, and runtime errors more reliably.
• Strengthened redaction for local integration exports so sensitive request and rule data stays protected.
• Improved HAR imports and content-type detection for better handling of modern JSON-style responses and imported sessions.
• Improved sidebar grouping cleanup when selected domain/app groups disappear, keeping active filters and sidebar state aligned.

Changed

• Refined multi-tab workspace behavior so tabs, selection, and window placement feel more predictable.
• Polished the proxy status indicator and workspace tab chrome for clearer capture state at a glance.

See CHANGELOG.md for the full release history.

현재 브랜치 하이라이트

• Developer Setup Hub는 런타임, 브라우저, 클라이언트, 디바이스, 프레임워크, 환경 전반을 대상으로 타깃별 스니펫, 검증 워처, 정직한 가이드를 제공합니다.
• 도메인이나 앱 단위로 SSL Proxying을 켜거나 끌 때 HTTPS 응답 프롬프트, 사이드바 액션, 메인 요청 테이블이 서로 같은 상태를 유지합니다.
• Inspector와 메인 요청 테이블은 스크롤 가능한 단일 행 탭, Query 상단 정렬, 더 명확한 Status/Code 구분, Request/Response 바이트 컬럼, Duration 수정, 실시간 SSL 상태 아이콘으로 한층 더 다듬어졌습니다.

기능

브라우저 DevTools만으로 부족할 때 손이 가는 도구들. Mac과 iOS 작업을 위한 핵심 트래픽 디버깅 — macOS 네이티브, 공개 릴리스, 로컬 우선 워크플로우.

트래픽 캡처

모든 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이 났지?"라고 바로 물어보세요. 무료 MCP 서버 — 유료 AI 애드온이나 상위 판매 없음, 사용 한도 없음.

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

팀 공유 & 협업 곧 출시

한 번의 클릭으로 캡처된 세션을 동료에게 보냅니다. 실패한 요청에 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.

빠른 시작

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 검사, gRPC/Protobuf와 HTTP/2 및 HTTP/3 지원 탐색.

보안

Rockxy는 네트워크 트래픽을 가로챕니다 — 보안은 기반이지 선택이 아닙니다.

• XPC 헬퍼는 bundle ID만이 아닌 인증서 체인 비교로 호출자 검증
• 플러그인은 샌드박스화된 JavaScriptCore에서 실행, 5초 타임아웃, 파일시스템/네트워크 접근 불가
• 모든 경계에서 입력 유효성 검사 — body 크기 제한, URI 제한, regex DoS 방지, 경로 순회 방지
• 로그에서 자격 증명 자동 마스킹
• 민감한 파일은 0o600 권한으로 저장

취약점 보고는 SECURITY.md를 참조. 자세한 내용은 보안 아키텍처를 확인하세요.

로드맵

Rockxy의 공개 로드맵은 워크플로 중심이며 고정 날짜를 약속하지 않습니다. 안정성, 네이티브 macOS UX, 디버깅 워크플로, 프로토콜 지원, 문서, 기여자 온보딩에 집중합니다.

• ROADMAP.md: 공개 엔지니어링 방향의 큰 그림
• Rockxy Public Roadmap: 로드맵 이슈의 실행 현황

문서

전체 문서는 Rockxy Docs에서 확인 가능:

• 빠른 시작 가이드 — 몇 분 만에 설정
• Developer Setup Hub — 런타임 스니펫, 디바이스 가이드, 검증 프로브, 지원 매트릭스
• 아키텍처 — 프록시 엔진, Actor 모델, 데이터 플로우
• 보안 모델 — 신뢰 경계, XPC 검증, 인증서 관리
• 설계 결정 — SwiftNIO, NSTableView, Actor를 선택한 이유
• 소스에서 빌드 — 빌드, 테스트, lint, 디버그
• 코드 스타일 — SwiftLint, SwiftFormat, 코딩 규칙
• 변경 기록 — 현재 브랜치 작업과 정식 릴리스 기록

기여

모든 종류의 기여를 환영합니다 — 코드, 테스트, 문서, 버그 리포트, UX 피드백.

설정 안내, 코드 스타일, PR 체크리스트는 **CONTRIBUTING.md**를 참조하세요.

초보자용 이슈는 good first issue로 표시되어 있습니다. PR을 제출하면 CLA에 동의한 것으로 간주합니다.

스폰서 및 파트너

Rockxy는 독립 개발자들이 구축하고 유지합니다. 후원금은 지속적인 개발, 보안 감사, 새로운 기능에 사용됩니다.

등급	혜택
Gold Sponsor	README + 문서 사이트에 로고 게재, 기능 요청 우선, 전용 지원 채널
Silver Sponsor	README에 로고 게재, 릴리스 노트에서 감사 표시
Bronze Sponsor	README 및 문서에서 감사 표시
Partner	공동 개발, 통합 지원, 향후 기능 조기 접근

파트너십 문의 — 개발자 도구 회사, 보안 기업, 커스텀 통합 또는 화이트라벨 솔루션이 필요한 엔터프라이즈 팀: rockxyapp@gmail.com

지원

• GitHub Sponsors — Rockxy 개발 지원
• GitHub Issues — 버그 리포트 및 기능 요청
• GitHub Discussions — 질문 및 커뮤니티 채팅
• 이메일 — rockxyapp@gmail.com
• 보안 문제 — 책임 있는 공개를 위해 SECURITY.md 참조

라이선스

GNU Affero General Public License v3.0 — Copyright 2024–2026 Rockxy Contributors.

스타 히스토리

---

_{Made by Stephen. Swift, SwiftNIO, SwiftUI, AppKit으로 빌드.}