# lowertop/shadowrocket

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/lowertop-shadowrocket).**

2,816 stars · 278 forks

## Links

- GitHub: https://github.com/LOWERTOP/Shadowrocket
- Homepage: https://LOWERTOP.github.io/Shadowrocket
- awesome-repositories: https://awesome-repositories.com/repository/lowertop-shadowrocket.md

## Topics

`shadowrocket` `shadowrocket-manual`

## Description

Shadowrocket is a proxy client application for mobile devices that functions as a multi-protocol proxy manager and a rule-based traffic router. It acts as a programmable network gateway, utilizing a virtual network interface to route system-level traffic through secure tunnels.

The project distinguishes itself through a programmable environment that executes JavaScript scripts and modules to automate DNS resolution and handle complex network request logic. It further provides an HTTPS traffic inspector capable of decrypting encrypted traffic using custom certificates to modify headers and rewrite URL content.

The system covers a broad range of traffic management capabilities, including multi-hop proxy chaining, app-level traffic splitting, and automated node failover. It manages network configurations via domain-to-IP mapping, encrypted DNS overrides, and remote rule set routing. Additionally, it includes tools for monitoring network activity, analyzing traffic statistics, and synchronizing configurations across devices via iCloud.

## Tags

### Mobile Development

- [Proxy Client Applications](https://awesome-repositories.com/f/mobile-development/proxy-client-applications.md) — Functions as a mobile application designed to route device traffic through remote proxy servers for privacy and access.

### Networking & Communication

- [Traffic Routing Rules](https://awesome-repositories.com/f/networking-communication/traffic-routing-rules.md) — Matches network requests against domain patterns and IP ranges to determine the appropriate proxy policy.
- [Proxy DNS Routers](https://awesome-repositories.com/f/networking-communication/dns-forwarding-routing/proxy-dns-routers.md) — Routes DNS resolution through a proxy's internal client to prevent leaks and bypass regional blocks. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [DNS Override Resolvers](https://awesome-repositories.com/f/networking-communication/dns-resolution/dns-override-resolvers.md) — Intercepts system DNS queries and routes them through proxy tunnels using encrypted protocols to prevent leaks. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Multi-Protocol Proxy Clients](https://awesome-repositories.com/f/networking-communication/multi-protocol-proxy-clients.md) — Provides a client-side manager capable of handling various proxy protocols for flexible communication and connectivity.
- [Programmable Gateways](https://awesome-repositories.com/f/networking-communication/network-gateways/programmable-gateways.md) — Implements a programmable network gateway that executes JavaScript to automate DNS resolution and network request logic.
- [Failover Proxy Routers](https://awesome-repositories.com/f/networking-communication/proxy-servers/failover-proxy-routers.md) — Automatically switches to a backup proxy server when the active connection fails to maintain uptime.
- [Rule-Based](https://awesome-repositories.com/f/networking-communication/traffic-routers/rule-based.md) — Directs network requests via proxy, direct, or reject policies using domain, IP, and GeoIP rules.
- [Local](https://awesome-repositories.com/f/networking-communication/vpn-tunnels/local.md) — Creates a virtual network interface on the device to intercept system-level traffic and route it through proxies.
- [Domain-to-IP Mappings](https://awesome-repositories.com/f/networking-communication/domain-to-ip-mappings.md) — Provides static associations between domain names and IP addresses to bypass DNS resolution. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Connection-Aware Routing Scenes](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/automated-traffic-routing/connection-aware-routing-scenes.md) — Switches routing modes and configurations automatically based on the active network connection. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Proxy Bypass Lists](https://awesome-repositories.com/f/networking-communication/proxy-bypass-lists.md) — Provides lists of domains and IP addresses configured to connect directly, bypassing the proxy server. ([source](https://lowertop.github.io/Shadowrocket/lazy_group.conf))
- [Proxy Connectivity Testing](https://awesome-repositories.com/f/networking-communication/proxy-connectivity-testing.md) — Measures network latency and reachability using various request types to identify the most responsive proxy servers. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Proxy Group Managers](https://awesome-repositories.com/f/networking-communication/proxy-group-managers.md) — Provides systems for organizing network nodes into logical groups with automated health checks and load balancing. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))
- [Proxy Node Aggregators](https://awesome-repositories.com/f/networking-communication/proxy-node-aggregators.md) — Supports importing server configurations and curated proxy node lists via QR codes and subscription URLs. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Proxy Chaining](https://awesome-repositories.com/f/networking-communication/proxy-protocols/proxy-chaining.md) — Sequentially routes network packets through multiple proxy servers to create a nested relay tunnel.
- [Proxy Subscription Updates](https://awesome-repositories.com/f/networking-communication/proxy-subscription-updates.md) — Automatically refreshes proxy server lists in the background or on launch via subscription URLs. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))
- [Regex-Based Request Modifications](https://awesome-repositories.com/f/networking-communication/traffic-interception/http-request-interceptors/production-traffic-modifications/regex-based-request-modifications.md) — Modifies URL patterns and HTTP headers using regular expressions to alter network traffic on the fly.
- [Dynamic Proxy Selection](https://awesome-repositories.com/f/networking-communication/traffic-proxying/proxy-traffic-management/dynamic-proxy-selection.md) — Automatically chooses the best proxy node based on latency testing, load balancing, or random selection. ([source](https://lowertop.github.io/Shadowrocket/lazy_group.conf))
- [UDP Proxies](https://awesome-repositories.com/f/networking-communication/udp-proxies.md) — Transmits UDP packets through proxy nodes to support real-time services like gaming and voice calls. ([source](https://lowertop.github.io/Shadowrocket/))

### Programming Languages & Runtimes

- [Embedded Script Execution](https://awesome-repositories.com/f/programming-languages-runtimes/embedded-script-execution.md) — Provides a programmable environment to run custom JavaScript scripts for HTTP requests and DNS resolution logic.
- [Sandboxed JavaScript Execution](https://awesome-repositories.com/f/programming-languages-runtimes/runtime-execution-environments/javascript-runtimes/sandboxed-javascript-execution.md) — Executes custom JavaScript to implement advanced logic for network requests, DNS resolution, and scheduled tasks. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))

### Security & Cryptography

- [App-Based Traffic Control](https://awesome-repositories.com/f/security-cryptography/app-based-traffic-control.md) — Assigns specific proxy strategies to individual applications by matching domain or IP fingerprints. ([source](https://lowertop.github.io/Shadowrocket/))
- [Traffic Decryption](https://awesome-repositories.com/f/security-cryptography/message-decryption/traffic-decryption.md) — Intercepts and decrypts TLS-encrypted HTTPS traffic using custom root certificates for analysis and modification. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))
- [HTTPS Filtering](https://awesome-repositories.com/f/security-cryptography/message-decryption/traffic-decryption/https-filtering.md) — Decrypts encrypted HTTPS traffic using custom certificates to modify headers and rewrite URL content.
- [Transparent HTTPS Inspections](https://awesome-repositories.com/f/security-cryptography/network-infrastructure-security/web-network-security/security-https/transparent-https-inspections.md) — Intercepts and decrypts HTTPS traffic using locally generated root certificates for debugging and analysis.

### Data & Databases

- [Proxy Node Failover](https://awesome-repositories.com/f/data-databases/database-management-systems/database-architectures/active-active-database-clusters/automatic-failover-mechanisms/proxy-node-failover.md) — Automatically switches to a functional proxy node when the current connection fails. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))

### Development Tools & Productivity

- [Configuration Inheritance](https://awesome-repositories.com/f/development-tools-productivity/configuration-inheritance.md) — Implements hierarchical configuration structures where secondary profiles inherit and override settings from a primary base file.

### DevOps & Infrastructure

- [File-Based Configuration](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/file-based-configuration.md) — Supports importing and editing text files to define network parameters, routing rules, and scripts. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))
- [On-Demand Tunnel Activation](https://awesome-repositories.com/f/devops-infrastructure/network-connection-managers/on-demand-tunnel-activation.md) — Triggers a VPN connection automatically when specific domains, DNS servers, or Wi-Fi networks are detected. ([source](https://LOWERTOP.github.io/Shadowrocket))

### Software Engineering & Architecture

- [Routing Extension Modules](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/plugin-architectures/developer-authoring-interfaces/custom-module-implementations/module-functionality-extenders/module-based-extensions/routing-extension-modules.md) — Allows the addition of functional modules that provide specialized rules, scripts, and certificates with high priority. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))

### System Administration & Monitoring

- [Network Traffic Logs](https://awesome-repositories.com/f/system-administration-monitoring/interaction-logs/interaction-capturers/network-traffic-logs.md) — Records request data and matching rules to provide persistent network traffic logs for debugging. ([source](https://LOWERTOP.github.io/Shadowrocket))
- [Protocol Debugging Logs](https://awesome-repositories.com/f/system-administration-monitoring/protocol-debugging-logs.md) — Provides detailed protocol debugging logs to troubleshoot network activity and traffic routing. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))

### Web Development

- [HTTP Header Manipulators](https://awesome-repositories.com/f/web-development/backend-development/request-response-handling/http-utilities/http-header-manipulators.md) — Provides utilities for adding, deleting, or replacing HTTP request and response headers using regular expressions. ([source](https://cdn.jsdelivr.net/gh/lowertop/shadowrocket@main/README.md))
- [URL Redirections](https://awesome-repositories.com/f/web-development/url-routing/redirection-rules/geographic-redirection/url-redirections.md) — Intercepts URL patterns and redirects them to different destinations via custom HTTP responses. ([source](https://lowertop.github.io/Shadowrocket/lazy_group.conf))