English | Tiếng Việt | 中文 | 繁體中文 | Español | Português do Brasil | 日本語 | 한국어 | Français | Deutsch | Italiano | Türkçe | Polski | Nederlands | Русский | Українська | العربية | فارسی | বাংলা | Română | ქართული
Proxy de débogage 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.
Conçu pour les workflows de débogage API, mobile, assistés par MCP, IA et de l'ère blockchain à mesure que Rockxy évolue.
Une alternative local-first, AGPL-3.0 à Proxyman et Charles Proxy.
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
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
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. Local, redaction-aware et open source.
`Claude Desktop` · `Cursor` · `Local stdio` · `Redaction` · `Open Source`
### Developer Setup Hub
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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`
## Plus de fonctionnalités bientôt
Les fonctionnalités futures sont suivies publiquement et ne seront livrées que lorsque l'implémentation, les tests, le comportement privacy et la documentation seront prêts.
### Inspection du trafic IA `Bientôt disponible`
Rendre le trafic de modèle plus facile à déboguer dans le workflow de capture normal. Détecter les requêtes IA, inspecter les appels de modèle sélectionnés, diagnostiquer les réponses streaming, comparer le comportement prompt/output et comprendre les chaînes de tool-calls sans coller de payloads sensibles dans un autre service.
`AI Requests` · `Model Inspector` · `Streaming Diagnostics` · `Tool Calls` · `Prompt Safety` · `Usage Signals`
### Inspection Web3/RPC `Bientôt disponible`
Transformer les appels réseau de l'ère blockchain en evidence de débogage lisible. Inspecter le trafic JSON-RPC et Solana RPC, regrouper les appels liés en flows, expliquer les erreurs RPC courantes et rejouer les requêtes sélectionnées sans transformer Rockxy en wallet ou block explorer.
`JSON-RPC` · `Solana RPC` · `Wallet Flows` · `RPC Errors` · `Replay Helpers` · `Network Evidence`
### Débogage des flows de paiement x402 `Bientôt disponible`
Comprendre les flows HTTP payment-gated depuis la couche réseau. Mettre en évidence les réponses payment-required, suivre le chemin de retry et garder l'evidence de débogage locale et redaction-aware.
`Payment Required` · `Retry Flow` · `Headers` · `Redaction` · `Local First`
### Bundles d'evidence redigée `Bientôt disponible`
Partager les faits nécessaires pour reproduire un bug sans divulguer de secrets. Packager le trafic sélectionné avec des résumés de protocole, des aperçus de redaction et un contexte source-backed qu'un collègue peut auditer.
`Debug Bundles` · `Protocol Summary` · `Export Preview` · `Secret Redaction` · `Repro Context`
### Filtres et règles protocol-aware `Bientôt disponible`
Utiliser les métadonnées IA et Web3 là où Rockxy travaille déjà : filtres, badges, colonnes optionnelles, comparaison, règles, Developer Setup et résumés MCP locaux.
`Smart Filters` · `Request Badges` · `Optional Columns` · `Rules` · `Compare` · `Local MCP`
### 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
```bash
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
| | **Rockxy** | **Proxyman** | **Charles Proxy** |
|---|---|---|---|
| **Modèle de projet** | Projet open-source AGPL-3.0 | App commerciale propriétaire | App commerciale propriétaire |
| **Code source** | Public, auditable, forkable | Source fermée | Source fermée |
| **Compilation depuis la source** | Gratuite avec Xcode depuis ce repo | Non disponible depuis une source publique | Non disponible depuis une source publique |
| **Base native macOS** | Swift + SwiftNIO + SwiftUI/AppKit | App commerciale native macOS | App commerciale multiplateforme |
| **Capture local-first** | Proxy local, certificats, helper et données de capture restent sur votre Mac | App proxy desktop | App proxy desktop |
| **Workflow de setup développeur** | Developer Setup Hub intégré pour runtimes, clients, appareils, frameworks et environnements | Guides de setup propres au produit | Guides de setup propres au produit |
| **MCP/local automation bridge** | Intégré, authentifié par token, masquage par défaut | Non revendiqué dans les docs publiques consultées | Non revendiqué dans les docs publiques consultées |
| **Chemin de contribution ouvert** | Issues, discussions, roadmap et PRs publics | Produit contrôlé par le fournisseur | Produit contrôlé par le fournisseur |
Sur la feuille de route : workflows replay/diff/rules/scripting plus profonds, inspection WebSocket et GraphQL améliorée, débogage protocol-aware de l'IA et du Web3/RPC, visibilité des flows de paiement de type x402, 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](SECURITY.md). Voir l'[architecture de sécurité complète](docs/development/security.mdx) 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 visibilité du trafic de l'ère IA/Web3, la documentation et l'accueil des contributeurs.
- [ROADMAP.md](ROADMAP.md) : direction d'ingénierie publique de haut niveau
- [Rockxy Public Roadmap](https://github.com/orgs/RockxyApp/projects/1) : visibilité opérationnelle des issues suivies dans la feuille de route
## Documentation
Documentation complète disponible sur [Rockxy Docs](docs/index.mdx) :
- [Guide de démarrage rapide](docs/quickstart.mdx) — opérationnel en quelques minutes
- [Developer Setup Hub](docs/features/developer-setup-hub.mdx) — snippets runtime, guides appareil, sondes de validation et matrice de support
- [Architecture](docs/development/architecture.mdx) — moteur proxy, modèle Actor, flux de données
- [Modèle de sécurité](docs/development/security.mdx) — frontières de confiance, validation XPC, gestion des certificats
- [Décisions de conception](docs/development/design-decisions.mdx) — pourquoi SwiftNIO, NSTableView, les Actors
- [Compiler depuis les sources](docs/development/building.mdx) — compilation, tests, lint et débogage
- [Style de code](docs/development/code-style.mdx) — SwiftLint, SwiftFormat et conventions
- [Changelog](CHANGELOG.md) — travaux non publiés et historique des versions taguées
## Contribuer
Toutes les contributions sont les bienvenues — code, tests, documentation, rapports de bugs et retours UX.
Consultez **[CONTRIBUTING.md](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`](https://github.com/RockxyApp/Rockxy/labels/good%20first%20issue). En soumettant une PR, vous acceptez le [CLA](CLA.md).
## 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.
Made by Stephen. Construit avec Swift, SwiftNIO, SwiftUI et AppKit.