What is aero?

Aero an innovative, first of its kind, interception-based web proxy from 2021, is now being open sourced! Aero has the best site compatibility and is the fastest proxy by far.

What is the purpose?

Aero was created out of the necessity for a proxy that can scale to millions of users. I want aero to be as easy to understand as possible being a great example of how a proxy should be made, while being modular and easy to modify or customize.

How is aero different from previous proxies?

Historical Context

Previously, proxies could barely handle more than one person, this was due to all the site's code being rewritten on the backend. Because the code was being rewritten on the backend, it required having to share backend rewrite code with frontend code. This was not only slow, but also allowed the possibility of malicious attacks against the proxies.

Difference

Aero takes a different approach by not only completely avoiding rewrites, but also by doing all the rewrites on the frontend with no parsers! This allows the response times to be O(1) with no speed delay. It does this by intercepting requests through a service worker, where the request is routed to the while also injecting important scripts. This prevents the need to hook into code that previously needed to be rewritten to redirect requests saving time and resources.

HTML Interception

HTML is intercepted and rewritten through a Mutation Observer where important elements are rewritten. Script elements with inline code and elements with integrity values set need to be cloned due to the browser's security restrictions.

Deep Scope Property Checking

Location objects are replaced with a fake Location api, and also in the case of the site trying to escape the location scoping bracket property accessors for certain objects are checked using our scope function that evaluates the expression in hopes of intercepting the attempted location or window call. Additionaly, this scoping is integrated into Eval, Function Class, and Reflect hooks. I hope you enjoy using aero on your site!

How do I use aero?

1. Make sure your backend serves aero's backend correctly
2. Make sure you included aero into your site
3. Create a config like this named config.js

const aeroPrefix = "/aero/";
const proxyPrefix = "/fetch";
const prefix = "/go/";
const codec = "plain";
const debug = {
	url: true,
	src: true,
	scoping: false,
};

export { aeroPrefix, proxyPrefix, prefix, codec, debug };

4. Create a service worker like this in the topmost directory

import handle from "./aero/handle.js";

self.addEventListener("install", event => self.skipWaiting());

self.addEventListener("fetch", async event =>
	event.respondWith(
		handle(event).catch(err => new Response(err.stack, { status: 500 }))
	)
);

5. Register the service worker in a script on your main page like this This example uses our sdk

import registerSw from "./sdk/registerSw.js";

registerSw("/sw.js", prefix);