README.fr.md

May 30, 2026 · View on GitHub

Rockxy

Rockxy

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

Proxy de débogage HTTP open-source et auditable pour macOS.

Interceptez, inspectez et modifiez le trafic HTTP/HTTPS/WebSocket/GraphQL avec une app Swift native que vous pouvez inspecter, compiler et vérifier.
Une alternative local-first, AGPL-3.0 à Proxyman et Charles Proxy.

Version Plateforme Swift Licence PRs bienvenues Soutenir

Rockxy en cours d'exécution sur macOS


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.

Points forts de la branche actuelle

  • Developer Setup Hub couvre désormais les runtimes, navigateurs, clients, appareils, frameworks et environnements avec des snippets ciblés, des watchers de validation et une documentation honnête.
  • Quand le SSL Proxying est activé ou désactivé par domaine ou par application, l’invite HTTPS chiffrée, les actions de la barre latérale et la table principale restent synchronisées.
  • L’inspecteur et la table principale ont été peaufinés avec des onglets défilants sur une seule ligne, un contenu Query aligné en haut, une meilleure séparation Status/Code, des colonnes Request/Response en octets, des correctifs de duration et des icônes SSL mises à jour en direct.

Fonctionnalités

Les outils que vous saisissez quand les DevTools du navigateur ne suffisent plus. Du débogage de trafic principal pour le travail Mac et iOS — natif macOS, avec des releases publiques et un flux local-first.

Capture du trafic

Rockxy capturing HTTP, HTTPS, WebSocket, and GraphQL traffic with a timing waterfall

Inspectez le trafic HTTP, HTTPS, WebSocket et GraphQL depuis n'importe quelle application Mac, CLI ou appareil iOS. Les DevTools du navigateur s'arrêtent au navigateur — Rockxy voit le reste de votre stack.

HTTP / HTTPS · WebSocket · GraphQL · iOS Device & Simulator · Filter by Process ID · Timing Waterfall

Filtres et recherche avancés

Rockxy advanced filtering with multi-field filters and full-text search across a session

Réduisez des milliers de requêtes capturées en quelques secondes. Combinez les filtres method, host, status, header, body et processus — ou lancez une recherche plein texte sur toute la session.

Multi-Field Filters · Full-Text Search · Status / Method · Header / Body Match · Process / Host · Saved Filters

Serveur MCP pour assistants IA

Rockxy local MCP server exposing captured traffic to Claude Desktop and Cursor

Laissez Claude Desktop ou Cursor lire votre trafic capturé via un serveur MCP local. Demandez "pourquoi cette requête a renvoyé 500 ?" au lieu de coller des headers dans le chat. Serveur MCP gratuit — pas de module IA payant, pas de plafond d'utilisation.

Claude Desktop · Cursor · Local stdio · Redaction · Open Source

Developer Setup Hub

Rockxy Developer Setup Hub with copy-paste proxy snippets and one-click verify

Copiez-collez les snippets de proxy pour Python, Node.js, Go, Rust, cURL, Docker et les navigateurs, puis cliquez sur Run Test pour confirmer que le trafic passe réellement.

Python · Node.js · Go / Rust / Java · cURL / Docker · One-Click Verify · Trust Diagnostics

Gestion des certificats pour déboguer HTTPS

Rockxy certificate management with a P-256 ECDSA root CA sealed in the Keychain

Un root CA P-256 ECDSA généré au premier lancement, scellé dans votre Keychain. Déchiffrez HTTPS du premier coup ; les hôtes épinglés sont automatiquement laissés en transit.

P-256 ECDSA Root CA · Keychain-Sealed Key · Per-Host Leaf Certs · Trust Wizard · Pinned-Host Passthrough · Rotate / Reset

SSL Proxy et déchiffrement HTTPS

Rockxy SSL proxy settings showing per-host TLS decryption rules with wildcard patterns and allow list

Choisissez quels hôtes seront déchiffrés en TLS. Le trafic déchiffré révèle les vrais headers et JSON ; le reste passe chiffré. Les règles wildcard permettent de cibler un domaine en un clic.

Per-Host Decryption · Wildcard Rules · Allow / Deny List · TLS 1.2 / 1.3 · Pinned Host Passthrough

Bypass Proxy

Rockxy bypass proxy list skipping cert-pinned apps and noisy telemetry hosts

Sautez certains hôtes pour que les applis à pinning de certificat, les services internes ou la télémétrie bruyante n'entrent jamais dans la capture. Les wildcards gardent la liste courte et le journal de requêtes concentré sur ce qui compte.

Per-Host Bypass · Wildcard Patterns · Skip Pinned Hosts · Mute Telemetry · Reduce Noise · Toggle Anytime

Block List

Rockxy block list dropping ad networks and flaky dependencies to simulate outages

Faites échouer n'importe quel hôte. Coupez les régies pub, les trackers tiers ou une dépendance instable pour voir comment votre app se dégrade sans elle — sans changer une ligne de code.

Per-Host Block · Wildcard Match · Simulate Outage · Test Fallbacks · Strip Trackers · Toggle Anytime

Map Local

Rockxy Map Local serving a saved file or directory tree in place of a live response

Servez un fichier enregistré ou une arborescence locale à la place d'une réponse en direct. Substituez un payload JSON, rejouez un snapshot ou épinglez une API tierce capricieuse sur une copie locale pendant le débogage.

File or Directory · Response Snapshot · Regex Patterns

Map Remote

Rockxy Map Remote rewriting a request destination from production to staging

Réécrivez la destination d'une requête capturée sans toucher au code de l'application ni à /etc/hosts. Pointez le trafic de prod vers staging, votre serveur de dév ou la machine d'un collègue pour reproduire un bug de manière fiable.

Host Rewrite · Regex Patterns · Preserve Host Header

Breakpoints et règles

Rockxy breakpoints pausing a request to edit method, headers, body, or status mid-flight

Mettez une requête ou réponse en pause, modifiez method, headers, body ou status, puis continuez. Le moyen le plus rapide de tester "et si l'API renvoie 401 ?" sans toucher au backend.

Request Breakpoints · Response Breakpoints · Block · Throttle · Regex / Wildcard Match · Inject Failure States

Modifier les headers

Rockxy modifying request and response headers per host with CORS and auth presets

Ajoutez, supprimez ou remplacez des headers sur n'importe quel hôte sans redéployer. Testez CORS, l'auth ou les changements de cache en quelques secondes grâce aux presets intégrés.

Add / Remove / Replace · CORS Presets · Auth Stripping · Request Phase · Response Phase · URL Pattern Scope

Headers de requête et de réponse personnalisés

Rockxy custom request and response header rules injecting tokens and stripping cookies

Surchargez les headers par hôte avec un contrôle total sur les deux phases. Injectez des tokens d'auth sur les requêtes sortantes, supprimez Set-Cookie sur les réponses ou figez un User-Agent personnalisé — le tout sauvegardé en règles nommées activables à tout moment.

Per-Host Override · Request Phase · Response Phase · Auth Token Inject · Cookie Strip · Named Rules

Conditions réseau

Rockxy network conditions throttling traffic to 3G, EDGE, LTE, or custom latency

Bridez en 3G, EDGE, LTE, WiFi ou avec un délai personnalisé. Votre laptop est en fibre ; vos utilisateurs non — voyez l'UX à 400 ms de RTT avant eux.

3G · EDGE · LTE · WiFi · Very Bad Network · Custom Latency

Compose — Éditer et rejouer

Rockxy Compose editing and replaying a captured HTTP request without leaving the app

Reconstruisez n'importe quelle requête HTTP capturée — changez method, URL, headers, query params ou body — et renvoyez-la sans quitter Rockxy. Plus de boucle copier-coller vers Postman, Insomnia ou curl. Itérez sur des prompts LLM, fuzzez des limites d'auth ou reproduisez un cas qui échoue pour OpenAI, Anthropic et Cohere en quelques secondes.

Edit Headers · Edit Body · Edit Query · Edit Method · LLM Prompt Iteration · Postman Alternative · OAuth Flow Debug · Webhook Replay

Comparer

Rockxy comparing two captured responses side-by-side with JSON, header, and body diff

Empilez deux réponses capturées côte à côte et repérez chaque champ qui a basculé — status, headers, clés JSON, octets du body. Attrapez les régressions API silencieuses, les sorties LLM non déterministes et la dérive de prompt sans pousser quoi que ce soit vers un outil tiers. Le diff côte à côte met en évidence ce qui change ; la comparaison JSON profonde ignore l'ordre des clés.

Diff Compare · Side-by-Side · JSON Diff · Header Diff · Body Diff · LLM Output Compare · Non-determinism · API Regression · Schema Drift

Onglets de prévisualisation personnalisés

Rockxy custom inspector previewer tabs for JSON, GraphQL, JWT, and image bodies

Rendez les bodies de requête et de réponse comme vous le souhaitez. Épinglez des onglets supplémentaires dans l'inspecteur pour JSON, GraphQL, JWT, image ou votre propre format — réutilisables sur chaque requête capturée.

JSON · GraphQL · JWT Decoder · Image / Hex · Custom Format · Pinned per Inspector

Sessions et export

Rockxy session export to HAR, cURL, and JSON with secret redaction before sharing

Sauvegardez des sessions, importez/exportez du HAR pour le passage d'un outil à l'autre, copiez n'importe quelle requête en cURL ou JSON. Redactez les headers d'authorization, cookies et bearer tokens avant partage — donnez à un collègue un repro de bug fonctionnel sans fuiter de secrets.

.rockxysession · HAR Import / Export · Copy as cURL · Copy as JSON · Raw HTTP · Secret Redaction · Token Sanitize · Privacy-Safe Share

Espaces de travail multi-onglets

Rockxy multi-tab workspaces running independent capture sessions side-by-side

Lancez des sessions de capture indépendantes côte à côte — un onglet pour staging, un pour la prod, un pour le build iOS. Chaque onglet conserve ses propres filtres, sélection et état d'inspecteur, donc le changement de contexte ne coûte rien.

Independent Sessions · Per-Tab Filters · Per-Tab Inspector · Compare Environments · Mac & iOS Together · Detach & Rename

Scripting JavaScript

Rockxy JavaScript scripting with request and response hooks and inline error feedback

Hooks JS sur les requêtes et réponses pour les cas qu'une règle statique ne couvre pas — redacter les PII, signer des tokens, réécrire des payloads. Les erreurs apparaissent inline au lieu de corrompre le trafic.

Request Hooks · Response Hooks · Programmatic Filtering · PII Redaction · Inline Error Feedback

Partage et collaboration en équipe Bientôt disponible

Envoyez une session capturée à un collègue d'un seul clic. Annotez les requêtes en échec en inline, voyez qui regarde quoi en temps réel et faites du pair-debug HTTPS sans partage d'écran. Ciblé pour une release future.

Shared Sessions · Team Workspaces · Inline Comments · Live Cursor · Cloud Sync · Pair Debug · SSO · Audit Log

100 % natif macOS. Pas d'Electron. Pas de vues web. SwiftUI + AppKit + SwiftNIO.

Démarrage rapide

git clone https://github.com/RockxyApp/Rockxy.git
cd Rockxy
open Rockxy.xcodeproj

Compilez et exécutez dans Xcode. La fenêtre de bienvenue vous guide à travers la configuration du CA racine, l'installation du helper et l'activation du proxy.

Prérequis : macOS 14.0+, Xcode 16+, Swift 5.9

Rockxy vs. Alternatives

RockxyProxymanCharles Proxy
Modèle de projetProjet open-source AGPL-3.0App commerciale propriétaireApp commerciale propriétaire
Code sourcePublic, auditable, forkableSource ferméeSource fermée
Compilation depuis la sourceGratuite avec Xcode depuis ce repoNon disponible depuis une source publiqueNon disponible depuis une source publique
Base native macOSSwift + SwiftNIO + SwiftUI/AppKitApp commerciale native macOSApp commerciale multiplateforme
Capture local-firstProxy local, certificats, helper et données de capture restent sur votre MacApp proxy desktopApp proxy desktop
Workflow de setup développeurDeveloper Setup Hub intégré pour runtimes, clients, appareils, frameworks et environnementsGuides de setup propres au produitGuides de setup propres au produit
MCP/local automation bridgeIntégré, authentifié par token, masquage par défautNon revendiqué dans les docs publiques consultéesNon revendiqué dans les docs publiques consultées
Chemin de contribution ouvertIssues, discussions, roadmap et PRs publicsProduit contrôlé par le fournisseurProduit contrôlé par le fournisseur

Sur la feuille de route : workflows replay/diff/rules/scripting plus profonds, inspection WebSocket et GraphQL améliorée, et exploration du support gRPC/Protobuf ainsi que HTTP/2 et HTTP/3.

Sécurité

Rockxy intercepte le trafic réseau — la sécurité est fondamentale, pas optionnelle.

  • Le helper XPC valide les appelants par comparaison de chaîne de certificats, pas seulement par bundle ID
  • Les plugins s'exécutent dans un JavaScriptCore isolé avec un timeout de 5 secondes, sans accès au système de fichiers ni au réseau
  • Validation des entrées sur toutes les frontières — limites de taille des body, limites d'URI, protection contre le DoS regex, prévention du path traversal
  • Les identifiants sont automatiquement masqués dans les logs
  • Les fichiers sensibles sont stockés avec des permissions 0o600

Signaler les vulnérabilités via SECURITY.md. Voir l'architecture de sécurité complète pour plus de détails.

Feuille de route

La feuille de route publique de Rockxy est orientée workflows et sans dates promises. Elle se concentre sur la fiabilité, l'UX macOS native, les workflows de débogage, les protocoles, la documentation et l'accueil des contributeurs.

  • ROADMAP.md : direction d'ingénierie publique de haut niveau
  • Rockxy Public Roadmap : visibilité opérationnelle des issues suivies dans la feuille de route

Documentation

Documentation complète disponible sur Rockxy Docs :

Contribuer

Toutes les contributions sont les bienvenues — code, tests, documentation, rapports de bugs et retours UX.

Consultez CONTRIBUTING.md pour les instructions de configuration, le style de code et la checklist PR complète.

Les issues pour débutants sont étiquetées good first issue. En soumettant une PR, vous acceptez le CLA.

Sponsors et Partenaires

Rockxy est construit et maintenu par des développeurs indépendants. Les sponsorisations financent le développement continu, les audits de sécurité et les nouvelles fonctionnalités.

Sponsoriser Rockxy

NiveauAvantages
Gold SponsorLogo sur le README + site de docs, demandes de fonctionnalités prioritaires, canal de support dédié
Silver SponsorLogo sur le README, remerciements dans les notes de version
Bronze SponsorRemerciements dans le README et la documentation
PartnerCo-développement, support d'intégration, accès anticipé aux fonctionnalités à venir

Demandes de partenariat — entreprises d'outils de développement, sociétés de sécurité et équipes entreprise cherchant des intégrations personnalisées ou des solutions en marque blanche : rockxyapp@gmail.com

Support

Licence

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

Historique des Étoiles

Star History Chart

Made by Stephen. Construit avec Swift, SwiftNIO, SwiftUI et AppKit.