English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
Debugging proxy mã nguồn mở, có thể kiểm tra cho macOS.
Chặn bắt, kiểm tra và chỉnh sửa lưu lượng HTTP/HTTPS/WebSocket/GraphQL bằng app Swift native mà bạn có thể kiểm tra, build và tin tưởng.
Được xây dựng cho workflow debug API, mobile, MCP-assisted, AI và blockchain-era khi Rockxy tiếp tục phát triển.
Giải pháp local-first, AGPL-3.0 thay thế cho Proxyman và Charles Proxy.
Kiểm tra lưu lượng HTTP, HTTPS, WebSocket và GraphQL từ bất kỳ ứng dụng Mac, CLI hay thiết bị iOS nào. Browser DevTools dừng lại ở trình duyệt — Rockxy nhìn thấy phần còn lại của stack.
`HTTP / HTTPS` · `WebSocket` · `GraphQL` · `iOS Device & Simulator` · `Filter by Process ID` · `Timing Waterfall`
### Lọc & Tìm Kiếm Nâng Cao
Thu hẹp hàng nghìn request đã bắt trong vài giây. Kết hợp filter theo method, host, status, header, body và process — hoặc chạy full-text search trên toàn bộ session.
`Multi-Field Filters` · `Full-Text Search` · `Status / Method` · `Header / Body Match` · `Process / Host` · `Saved Filters`
### MCP Server cho AI Assistants
Để Claude Desktop hoặc Cursor đọc traffic đã bắt qua một MCP server local. Hỏi "tại sao request này 500?" thay vì dán headers vào chat. Local, redaction-aware, và mã nguồn mở.
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### Developer Setup Hub
Copy-paste snippet proxy cho Python, Node.js, Go, Rust, cURL, Docker và browser, sau đó bấm Run Test để xác nhận traffic thực sự đang chạy qua.
`Python` · `Node.js` · `Go / Rust / Java` · `cURL / Docker` · `One-Click Verify` · `Trust Diagnostics`
### Quản Lý Chứng Chỉ cho HTTPS Debugging
Root CA P-256 ECDSA tạo ngay lần khởi động đầu tiên, niêm trong Keychain. Giải mã HTTPS ngay lần thử đầu; các host bị pin tự động đi qua không can thiệp.
`P-256 ECDSA Root CA` · `Keychain-Sealed Key` · `Per-Host Leaf Certs` · `Trust Wizard` · `Pinned-Host Passthrough` · `Rotate / Reset`
### SSL Proxy & Giải Mã HTTPS
Chọn host nào được giải mã TLS. Traffic được giải mã hiển thị header và JSON thật; phần còn lại đi qua dạng mã hoá. Quy tắc wildcard cho phép scope theo domain chỉ với một cú click.
`Per-Host Decryption` · `Wildcard Rules` · `Allow / Deny List` · `TLS 1.2 / 1.3` · `Pinned Host Passthrough`
### Bypass Proxy
Bỏ qua một số host để app pin chứng chỉ, dịch vụ nội bộ, hay telemetry ồn ào không bao giờ lọt vào capture. Wildcard giữ list ngắn gọn và log request tập trung đúng cái bạn quan tâm.
`Per-Host Bypass` · `Wildcard Patterns` · `Skip Pinned Hosts` · `Mute Telemetry` · `Reduce Noise` · `Toggle Anytime`
### Block List
Khiến bất kỳ host nào fail. Cắt mạng quảng cáo, tracker bên thứ ba, hay dependency hay lỗi để xem app xuống cấp thế nào khi nó biến mất — không cần đổi một dòng code.
`Per-Host Block` · `Wildcard Match` · `Simulate Outage` · `Test Fallbacks` · `Strip Trackers` · `Toggle Anytime`
### Map Local
Phục vụ một file đã lưu hoặc một cây thư mục thay cho response thực. Đổi một payload JSON, replay một snapshot, hoặc pin một API bên thứ ba hay lỗi về bản local trong khi debug.
`File or Directory` · `Response Snapshot` · `Regex Patterns`
### Map Remote
Đổi đích đến của request đã bắt mà không cần chạm vào code app hay /etc/hosts. Trỏ traffic production sang staging, dev server của bạn, hoặc máy đồng nghiệp để tái hiện bug có thể lặp lại.
`Host Rewrite` · `Regex Patterns` · `Preserve Host Header`
### Breakpoint & Rules
Tạm dừng request hoặc response, sửa method, header, body hay status, rồi tiếp tục. Cách nhanh nhất để thử "điều gì xảy ra nếu API trả 401?" mà không phải đụng backend.
`Request Breakpoints` · `Response Breakpoints` · `Block` · `Throttle` · `Regex / Wildcard Match` · `Inject Failure States`
### Modify Headers
Thêm, gỡ hoặc thay header trên bất kỳ host nào mà không cần redeploy. Test thay đổi CORS, auth hay cache trong vài giây với preset có sẵn.
`Add / Remove / Replace` · `CORS Presets` · `Auth Stripping` · `Request Phase` · `Response Phase` · `URL Pattern Scope`
### Custom Request & Response Headers
Override header theo từng host với toàn quyền điều khiển cả hai phase. Inject auth token vào request đi ra, gỡ Set-Cookie ở response, hoặc pin một User-Agent tuỳ chỉnh — lưu lại dưới dạng named rule có thể bật/tắt bất cứ lúc nào.
`Per-Host Override` · `Request Phase` · `Response Phase` · `Auth Token Inject` · `Cookie Strip` · `Named Rules`
### Network Conditions
Throttle về 3G, EDGE, LTE, WiFi hoặc delay tuỳ chỉnh. Laptop của bạn dùng fiber; người dùng thì không — xem UX ở 400 ms RTT trước khi họ thấy.
`3G` · `EDGE` · `LTE` · `WiFi` · `Very Bad Network` · `Custom Latency`
### Compose — Sửa & Replay
Dựng lại bất kỳ request HTTP đã bắt — đổi method, URL, header, query param hay body — rồi gửi lại mà không cần rời Rockxy. Không cần vòng lặp copy-paste qua Postman, Insomnia hay curl. Iterate prompt LLM, fuzz biên auth, hoặc tái hiện một case lỗi cho OpenAI, Anthropic, Cohere endpoint trong vài giây.
`Edit Headers` · `Edit Body` · `Edit Query` · `Edit Method` · `LLM Prompt Iteration` · `Postman Alternative` · `OAuth Flow Debug` · `Webhook Replay`
### So Sánh
Xếp hai response đã bắt cạnh nhau và bắt được mọi trường đã đổi — status, headers, JSON keys, body bytes. Bắt được regression API âm thầm, output LLM không deterministic và prompt drift mà không cần đẩy dữ liệu sang công cụ diff bên thứ ba. Side-by-side diff highlight phần đã đổi; deep JSON compare bỏ qua thứ tự key.
`Diff Compare` · `Side-by-Side` · `JSON Diff` · `Header Diff` · `Body Diff` · `LLM Output Compare` · `Non-determinism` · `API Regression` · `Schema Drift`
### Custom Previewer Tabs
Render body request và response theo cách bạn muốn. Pin thêm tab vào inspector cho JSON, GraphQL, JWT, image hay format riêng — dùng lại được trên mọi request đã bắt.
`JSON` · `GraphQL` · `JWT Decoder` · `Image / Hex` · `Custom Format` · `Pinned per Inspector`
### Sessions & Export
Lưu session, import/export HAR cho handoff đa công cụ, copy bất kỳ request nào ra cURL hay JSON. Redact header authorization, cookie và bearer token trước khi chia sẻ — đưa cho đồng đội bug repro hoạt động được mà không lộ secret.
`.rockxysession` · `HAR Import / Export` · `Copy as cURL` · `Copy as JSON` · `Raw HTTP` · `Secret Redaction` · `Token Sanitize` · `Privacy-Safe Share`
### Multi-Tab Workspaces
Chạy các session capture độc lập song song — một tab cho staging, một cho prod, một cho build iOS device. Mỗi tab giữ filter, selection và state inspector riêng, nên chuyển context không tốn gì.
`Independent Sessions` · `Per-Tab Filters` · `Per-Tab Inspector` · `Compare Environments` · `Mac & iOS Together` · `Detach & Rename`
### JavaScript Scripting
Hook JS lên request và response cho các case mà rule tĩnh không phủ được — redact PII, ký token, viết lại payload. Lỗi hiện ra inline thay vì làm hỏng traffic.
`Request Hooks` · `Response Hooks` · `Programmatic Filtering` · `PII Redaction` · `Inline Error Feedback`
## Nhiều Tính Năng Sắp Ra Mắt
Các tính năng tương lai được theo dõi công khai và chỉ ship khi implementation, test, privacy behavior và documentation đã sẵn sàng.
### AI Traffic Inspection `Sắp Ra Mắt`
Làm cho model traffic dễ debug hơn ngay trong workflow capture bình thường. Detect AI request, inspect model call đã chọn, diagnose streaming response, compare prompt/output behavior, và hiểu tool-call chain mà không phải dán payload nhạy cảm vào dịch vụ khác.
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Web3/RPC Inspection `Sắp Ra Mắt`
Biến network call của blockchain-era thành debugging evidence dễ đọc. Inspect JSON-RPC và Solana RPC traffic, group related calls thành flow, giải thích lỗi RPC phổ biến, và replay selected request mà không biến Rockxy thành wallet hay block explorer.
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### x402 Payment Flow Debugging `Sắp Ra Mắt`
Hiểu payment-gated HTTP flow từ tầng network. Highlight payment-required response, theo dõi retry path, và giữ debugging evidence local với redaction-aware.
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### Redacted Evidence Bundles `Sắp Ra Mắt`
Chia sẻ những dữ kiện cần để reproduce bug mà không leak secret. Package selected traffic với protocol summary, redaction preview, và source-backed context để đồng đội có thể audit.
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### Protocol-Aware Filters & Rules `Sắp Ra Mắt`
Dùng AI và Web3 metadata ở đúng nơi Rockxy đã hoạt động: filter, badge, optional column, comparison, rule, Developer Setup, và local MCP summary.
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### Chia Sẻ & Cộng Tác Theo Team `Sắp Ra Mắt`
Gửi một session đã bắt cho đồng đội chỉ với một cú click. Annotate request lỗi inline, thấy ai đang xem cái gì real-time, và pair-debug traffic HTTPS mà không cần share màn hình. Đặt mục tiêu cho một release tương lai.
`Shared Sessions` · `Team Workspaces` · `Inline Comments` · `Live Cursor` · `Cloud Sync` · `Pair Debug` · `SSO` · `Audit Log`
> 100% native macOS. Không Electron. Không web view. SwiftUI + AppKit + SwiftNIO.
## Bắt Đầu Nhanh
```bash
git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj
```
Build và chạy trong Xcode. Cửa sổ Welcome sẽ hướng dẫn bạn cài đặt root CA, helper tool, và kích hoạt proxy.
**Yêu cầu:** macOS 14.0+, Xcode 16+, Swift 5.9
## Rockxy vs. Các Giải Pháp Khác
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **Mô hình dự án** | Dự án mã nguồn mở AGPL-3.0 | Ứng dụng thương mại độc quyền | Ứng dụng thương mại độc quyền |
| **Mã nguồn** | Công khai, có thể kiểm tra, có thể fork | Mã nguồn đóng | Mã nguồn đóng |
| **Build từ mã nguồn** | Miễn phí với Xcode từ repo này | Không có mã nguồn công khai để build | Không có mã nguồn công khai để build |
| **Nền tảng macOS native** | Swift + SwiftNIO + SwiftUI/AppKit | Ứng dụng macOS thương mại native | Ứng dụng thương mại đa nền tảng |
| **Capture local-first** | Proxy, chứng chỉ, helper và dữ liệu capture ở trên máy Mac của bạn | Ứng dụng proxy desktop | Ứng dụng proxy desktop |
| **Workflow thiết lập developer** | Developer Setup Hub tích hợp cho runtime, client, device, framework và environment | Hướng dẫn thiết lập theo sản phẩm | Hướng dẫn thiết lập theo sản phẩm |
| **MCP/local automation bridge** | Tích hợp sẵn, xác thực bằng token, mặc định che giấu dữ liệu nhạy cảm | Chưa được nêu trong tài liệu công khai đã kiểm tra | Chưa được nêu trong tài liệu công khai đã kiểm tra |
| **Đường đóng góp mở** | Issues, discussions, roadmap và PR công khai | Sản phẩm do vendor kiểm soát | Sản phẩm do vendor kiểm soát |
Trên lộ trình: workflow replay/diff/rules/scripting sâu hơn, cải thiện kiểm tra WebSocket và GraphQL, protocol-aware debugging cho AI và Web3/RPC, visibility cho x402-style payment flow, và khám phá hỗ trợ gRPC/Protobuf cùng HTTP/2 và HTTP/3.
## Bảo Mật
Rockxy chặn bắt lưu lượng mạng — bảo mật là nền tảng, không phải tùy chọn.
- XPC helper xác thực caller bằng **so sánh chuỗi chứng chỉ**, không chỉ bundle ID
- Plugin chạy trong **JavaScriptCore sandbox** với timeout 5 giây, không truy cập filesystem/network
- **Kiểm tra đầu vào** trên mọi ranh giới — giới hạn kích thước body, giới hạn URI, chống regex DoS, chống path traversal
- Thông tin xác thực **tự động che giấu** trong log
- File nhạy cảm được lưu với **quyền 0o600**
Báo cáo lỗ hổng qua [SECURITY.md](SECURITY.md). Xem [kiến trúc bảo mật đầy đủ](docs/development/security.mdx) để biết chi tiết.
## Lộ Trình
Lộ trình công khai của Rockxy tập trung vào workflow và không cam kết ngày phát hành cố định. Nội dung ưu tiên độ tin cậy, UX macOS native, workflow debug, hỗ trợ giao thức, AI/Web3-era traffic visibility, tài liệu và onboarding cho contributor.
- [ROADMAP.md](ROADMAP.md): định hướng kỹ thuật công khai ở mức cao
- [Rockxy Public Roadmap](https://github.com/orgs/RockxyApp/projects/1): trạng thái thực thi của các issue trong roadmap
## Tài Liệu
Tài liệu đầy đủ tại [Rockxy Docs](docs/index.mdx):
- [Hướng dẫn nhanh](docs/quickstart.mdx) — thiết lập và chạy trong vài phút
- [Developer Setup Hub](docs/features/developer-setup-hub.mdx) — snippet theo runtime, guide cho device, validation probe và support matrix
- [Kiến trúc](docs/development/architecture.mdx) — proxy engine, actor model, luồng dữ liệu
- [Mô hình bảo mật](docs/development/security.mdx) — ranh giới tin cậy, xác thực XPC, quản lý chứng chỉ
- [Quyết định thiết kế](docs/development/design-decisions.mdx) — tại sao SwiftNIO, NSTableView, actors
- [Build từ mã nguồn](docs/development/building.mdx) — build, test, lint, và debug
- [Phong cách code](docs/development/code-style.mdx) — SwiftLint, SwiftFormat, và quy ước
- [Changelog](CHANGELOG.md) — thay đổi chưa phát hành và các bản phát hành đã gắn tag
## Đóng Góp
Chào đón mọi đóng góp — code, test, tài liệu, báo lỗi, và phản hồi UX.
Xem **[CONTRIBUTING.md](CONTRIBUTING.md)** để biết hướng dẫn cài đặt, phong cách code, và checklist PR đầy đủ.
Các issue dành cho người mới được gắn nhãn [`good first issue`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue). Khi mở PR, bạn đồng ý với [CLA](CLA.md).
## Nhà Tài Trợ & Đối Tác
Rockxy được xây dựng và duy trì bởi các developer độc lập. Tài trợ giúp trang trải phát triển liên tục, kiểm tra bảo mật, và các tính năng mới.
Made by Stephen. Xây dựng bằng Swift, SwiftNIO, SwiftUI, và AppKit.