Proxy Work | Scramjet
Understanding the Scramjet Proxy: A New Era of Web Interception
In the evolving landscape of digital privacy and internet freedom, traditional proxy methods often struggle against modern enterprise filters and sophisticated censorship. The Scramjet proxy, a flagship project by Mercury Workshop, has emerged as a powerful, interception-based solution designed to succeed older technologies like Ultraviolet.
By leveraging advanced browser technologies, Scramjet provides a versatile framework for evading restrictions while maintaining high performance and security. How Does a Scramjet Proxy Work?
Unlike simple URL redirectors, Scramjet operates through a sophisticated interception-based architecture. It doesn't just pass data through a server; it fundamentally rewrites how the browser interacts with web content.
Service Worker Interception: Scramjet uses a Service Worker to sit between the web browser and the network. This allows it to intercept every request made by a webpage—including images, scripts, and API calls—before they ever reach the open internet.
Sophisticated Rewriting: Once a request is intercepted, the Scramjet engine rewrites the outgoing URLs and incoming responses. This process ensures that all sub-resources (like a YouTube video's data stream or a Discord websocket) stay within the "proxied" environment, preventing "leaks" that could be blocked by a filter.
Sandboxing and Security: Scramjet sandboxes arbitrary web content to bypass CORS (Cross-Origin Resource Sharing) restrictions. This enables users to load and debug websites inside the browser that would otherwise be blocked by standard security policies.
WASM Optimization: Modern implementations often use WebAssembly (WASM) to handle the heavy lifting of data transformation, ensuring that the proxy remains fast enough for gaming and high-definition streaming. Key Benefits of Scramjet Technology
Scramjet is frequently cited as the "best school filter bypassing backend" due to its ability to handle complex, modern websites that older proxies cannot. petezah-games/scramjet CDN by jsDelivr
that uses surrogate models (proxies) to simulate hypersonic engine performance 1. Web Proxy Technology: The Scramjet Framework In modern web development and network security,
is a high-performance, interception-based web proxy developed by Mercury Workshop
. It is primarily used to evade internet censorship and bypass enterprise or school-level web filters. Service Worker Architecture
: It utilizes a service worker-based architecture to intercept and rewrite web traffic in real-time, allowing it to support complex sites like YouTube, Discord, and Google. Security & Performance
: Unlike older proxies like Ultraviolet, Scramjet focuses on maintaining a "developer-friendly" environment while prioritizing high execution speeds and security. Data Processing Hub : Beyond simple web browsing, the Scramjet Transform Hub
acts as a platform for serverless applications, allowing developers to run asynchronous data streams across multi-threaded environments. 2. Aerospace Engineering: Proxy and Surrogate Modeling
In the context of hypersonic propulsion, "proxy work" involves creating surrogate or reduced-order models
to simulate the behavior of Supersonic Combustion Ramjets (scramjets). Because physical testing at Mach 5+ speeds is prohibitively expensive, engineers use computational proxies to estimate performance. scramjet proxy work
is a modern, interception-based web proxy framework designed to bypass web browser restrictions and internet censorship. It functions by acting as middleware that intercepts network traffic, allowing it to support a wide range of sites even under strict enterprise or school filters. How Scramjet Works Scramjet operates through a Service Worker-based architecture
. Instead of just routing traffic through a different server, it reconstructs the web environment inside your browser: Request Interception
: It registers a Service Worker that "hooks" into every fetch request the browser makes. URL Rewriting : It uses custom
to encode real URLs into proxy-compatible URLs. This ensures that all sub-resources (like images, scripts, and links) stay within the proxy tunnel rather than trying to load from their original blocked domains. Cookie Emulation
: Because the proxy runs on a different domain than the original site, normal cookies would be blocked for security. Scramjet bypasses this by storing cookies in
and manually injecting them into headers whenever a request is sent. Transport Protocols : It utilizes the
system, which allows it to plug into different backend protocols like Wisp or Bare servers to handle HTTP and WebSocket traffic. Setting Up a Basic Piece
If you are looking to integrate Scramjet or host your own instance, here is the general workflow based on the official documentation Quickstart - Scramjet - Mintlify
Scramjet (by MercuryWorkshop) is a modern, interception-based web proxy designed primarily to bypass internet censorship and enterprise web filters. It is widely considered a faster, more secure successor to the popular Ultraviolet proxy. Key Performance & Features
Modern Architecture: Built using a service worker-based architecture, Scramjet intercepts and rewrites network requests in real-time, allowing it to function as a powerful middleware for web applications.
High Site Compatibility: It supports major platforms including YouTube, Discord, Reddit, Instagram, Spotify, and GeForce NOW.
CAPTCHA Support: Unlike many basic proxies, Scramjet includes built-in support for CAPTCHAs, which is essential for logging into Google and other high-security sites.
Speed & Efficiency: Users report it is significantly faster than older solutions, with optimized WASM-based rewriting to ensure smooth page loads. Use Cases
School/Work Unblocking: Specifically optimized to evade school filters and enterprise-level browser restrictions.
Privacy-Focused Apps: Developers use the Scramjet API to build custom, privacy-centric web browsers or applications.
Self-Hosting: It is designed to be easily deployable, with a Scramjet-App demo available for those who want to set up their own instance. Things to Consider Understanding the Scramjet Proxy: A New Era of
Development Stage: While highly advanced, it is still considered "experimental." Some users have reported issues with specific sites like Instagram or Facebook logins on mobile browsers.
Hosting Requirements: For features like YouTube and CAPTCHAs to work reliably, it is recommended not to host it on common datacenter IPs, which are often pre-blocked by those services. Summary Comparison Feature Ultraviolet (Older) Performance High (WASM Optimized) Compatibility Broad (Modern Web APIs) Limited for newer scripts Complexity Developer-friendly API Can be clunky to integrate Status Active development Frequently targeted/blocked Introduction to Scramjet - Mintlify
is an advanced interception-based web proxy developed by Mercury Workshop
to bypass browser restrictions and censorship. It is often regarded as the successor to Ultraviolet
, offering a more secure and performance-focused framework for creating custom proxy solutions. Core Architecture Scramjet operates primarily through a Service Worker-based architecture
that intercepts and rewrites web traffic directly within the browser. Request Interception
: It utilizes modern browser APIs to capture outgoing requests before they reach the network. WASM-Based Rewriting WebAssembly (WASM)
to perform efficient, low-latency rewriting of web content, ensuring fast page loads even with complex sites. Wisp Protocol Support : It integrates with the Wisp protocol
, which proxies multiple TCP/UDP sockets over a single WebSocket connection for improved efficiency. Key Features for Developers
Scramjet is designed as middleware, providing clean APIs and flexible configuration options: Site Compatibility : It supports major platforms including Built-in CAPTCHA Support
: Unlike many traditional proxies, Scramjet includes specific logic to handle CAPTCHAs on sites like Google. Customizable Behavior : Developers can control the proxy using feature flags strictRewrites captureErrors ) and custom URL codecs (e.g., Base64 or URI encoding). Modular API
: It allows developers to "trap" and modify specific browser behaviors, such as document.cookie requests, using a modular plugin system. Implementation Basics
To integrate Scramjet into a project, developers typically initialize a ScramjetController and register a service worker. javascript // Example Basic Setup scramjet = ScramjetController( prefix: "/scramjet/"
, codec: encode: (url) => btoa(url), decode: (url) => atob(url) ); // Create and navigate an iframe frame = scramjet.createFrame(); frame.navigate( "https://example.com" Use code with caution. Copied to clipboard For official documentation and source code, visit the Mercury Workshop GitHub Scramjet Mintlify Documentation on how to set up the Wisp server backend for Scramjet? Introduction to Scramjet - Mintlify
4.2 Header Completion Speculation
Instead of waiting for \r\n\r\n, the proxy uses a state machine that parses as data arrives. If the end of headers is not yet seen, it still forwards partial data, tagging it as "unparsed" — an approach called speculative forwarding.
References (select)
- Classic scramjet and hypersonic propulsion texts and review articles on high-enthalpy test techniques, turbulence–chemistry modeling, and experimental diagnostics. (Cite standard works such as Anderson, Heiser & Pratt, recent review papers on scramjet testing, and articles on shock-tunnel diagnostics, LES of high-speed combustion, and uncertainty quantification in propulsion.)
The following essay outlines the technical architecture and "work" performed by the Scramjet proxy system. The Architecture of Scramjet Proxy Classic scramjet and hypersonic propulsion texts and review
Unlike traditional proxies that simply forward requests, Scramjet is an interception-based proxy. Its core work is centered on three primary pillars: service worker integration, deep request rewriting, and sandbox isolation.
Service Worker Interception: Scramjet's primary mechanism for "work" is its use of a service worker-based architecture. By installing a service worker in the client's browser, Scramjet can intercept all network requests (fetch, XHR, etc.) before they leave the browser, allowing it to modify them in real-time.
Dynamic Content Rewriting: A significant portion of Scramjet's work involves its sophisticated rewriting system. It modifies HTML, CSS, and JavaScript on the fly to ensure that all internal links, script sources, and API calls are redirected through the proxy server rather than the blocked original host. This process is essential for bypassing filters that look for specific blacklisted domains.
Isolated Browsing Contexts: The framework enables the creation of isolated browsing contexts. This allows users to browse multiple sites simultaneously within a single web application without session leakage, as Scramjet manages a centralized cookie jar and unique request routing for each session. Core Functionalities and "Work" Mechanisms
To achieve its goal of evading censorship, Scramjet performs several high-level tasks:
URL Encoding/Decoding: To hide destination URLs from network monitors, Scramjet uses custom codecs to encode and decode web addresses.
RPC Communication: It facilitates two-way Remote Procedure Call (RPC) communication between the main web page, the service worker, and the transport layers. This ensures that complex browser operations, like DOM manipulation or navigation, remain functional even while proxied.
WASM-Based Performance: To maintain high speed despite heavy rewriting, Scramjet utilizes WebAssembly (WASM)-based rewriting. This allows the proxy to process large amounts of JavaScript and HTML with minimal latency, making it faster than older proxy technologies like Ultraviolet. Applications and Use Cases
The work performed by Scramjet is most frequently applied in environments with strict internet restrictions, such as schools or corporate networks. Because it is highly developer-friendly and supports TypeScript, it serves as a foundation for building privacy-focused web applications and custom proxy solutions with full developer control.
Scramjet is a versatile web proxy designed to bypass ... - GitHub
Since "Proxy Work" in the context of Scramjet (a framework for running sequence-based data processing apps) usually refers to the mechanism of routing external traffic into running application instances, this feature focuses on enabling secure, dynamic ingress for running sequences.
4. Secure Browsing & Anonymity
For privacy-focused users, traditional VPNs or SOCKS proxies create a single point of bottleneck. A Scramjet Proxy can be chained (proxy to proxy) with minimal latency increase, allowing multi-hop anonymization without noticeable slowdown.
Component 3: Stream Processor
- Zero-copy ring buffers (via
io_uringon Linux 5.8+). - Pluggable transformers (gzip, header remap, token bucket rate limiter).
Abstract
Scramjet (supersonic combustion ramjet) propulsion promises efficient hypersonic flight by enabling combustion in supersonic airflow. However, testing and development face practical constraints—full-scale flight tests are costly, risky, and infrequent—so researchers use proxy methods (scaled experiments, ground-test surrogates, numerical models, and hybrid approaches) to emulate scramjet conditions. This paper surveys the physics of scramjet operation, identifies key challenges for proxy fidelity, reviews proxy methodologies, analyzes their strengths and limitations, and proposes a unified framework and roadmap to improve proxy-to-flight correlation for design, validation, and certification.
11. Recommended Framework for Improved Proxy Work
- Explicit goal definition: choose observables and fidelity metrics aligned with project stage (discovery vs. certification).
- Multi-fidelity design loop:
- Use high-fidelity LES/DNS for canonical fundamental cases (mixing, ignition) to generate datasets.
- Create reduced-order and machine-learned surrogates constrained by physics (conservative, Galilean invariants).
- Design targeted ground tests that maximize information gain for the most sensitive model parameters (optimal experimental design).
- Assimilate experimental data to update model priors via Bayesian inference; propagate uncertainties to performance metrics.
- Validate on integrated subscale or flight tests for system-level coupling.
- Facility innovations: variable-enthalpy tunnels, longer-duration transients, better replication of freestream chemistry.
- Standardize reporting: common datasets, benchmarks, and open repositories for scramjet proxy data.
- Investment in diagnostics: non-intrusive, time-resolved species and temperature measurements.
4. Built-in Stream Transformation
Unlike a conventional proxy that simply relays bytes, a Scramjet Proxy can transform streams in real time. Common transformations include:
- Header injection/removal for authentication.
- Payload compression (Brotli, Zstd) on the fly.
- Response caching based on content hash, not just URL.
- Traffic mirroring to shadow environments.
Because these operations happen inside the proxy’s zero-copy pipeline, they add minimal overhead—often less than 50 microseconds per megabyte.




