# monkeywie/proxyee

**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/monkeywie-proxyee).**

1,630 stars · 579 forks · Java · MIT

## Links

- GitHub: https://github.com/monkeyWie/proxyee
- awesome-repositories: https://awesome-repositories.com/repository/monkeywie-proxyee.md

## Topics

`http` `https` `java` `mitm` `mitmproxy` `netty` `proxy` `proxy-server`

## Description

Proxyee is a Java-based network proxy library designed for building custom proxy servers that support traffic interception, inspection, and modification. It functions as a programmable framework for handling HTTP, HTTPS, and WebSocket traffic, providing the necessary tools to analyze and alter request and response data in real time.

The project distinguishes itself through its man-in-the-middle capabilities, which include dynamic certificate generation to facilitate the decryption and re-encryption of secure traffic streams. This allows for granular control over network communications, supported by domain-based filtering that enables users to target specific traffic for inspection while leaving other connections untouched.

Beyond core interception, the library includes features for securing proxy infrastructure through client authentication and supports complex network topologies by chaining traffic through upstream proxy servers. The implementation utilizes an asynchronous event loop and a pipeline-based processing model to manage concurrent connections and packet handling.

## Tags

### Networking & Communication

- [HTTP Proxies](https://awesome-repositories.com/f/networking-communication/http-proxies.md) — Acts as a programmable intermediary for HTTP and HTTPS requests between clients and destination servers.
- [Custom Proxy Frameworks](https://awesome-repositories.com/f/networking-communication/traffic-proxying/custom-proxy-frameworks.md) — Provides a foundational framework for building custom network proxies with programmable routing and request manipulation logic.
- [Domain Traffic Filters](https://awesome-repositories.com/f/networking-communication/domain-traffic-filters.md) — Limits traffic modifications to specific domains by applying matching rules to identify which requests to process. ([source](https://github.com/monkeywie/proxyee#readme))
- [HTTP Traffic Inspection](https://awesome-repositories.com/f/networking-communication/http-traffic-inspection.md) — Provides real-time monitoring and analysis of HTTP request and response headers and bodies for debugging.
- [WebSocket and TCP Messaging Gateways](https://awesome-repositories.com/f/networking-communication/websocket-services/multi-protocol-gateways/persistent-websocket-gateways/websocket-and-tcp-messaging-gateways.md) — Monitors and tampers with real-time WebSocket message streams to debug persistent network connections.

### Security & Cryptography

- [Man-in-the-Middle Frameworks](https://awesome-repositories.com/f/security-cryptography/man-in-the-middle-frameworks.md) — Intercepts and manipulates encrypted network traffic between endpoints for security analysis and protocol testing.
- [Dynamic Certificate Generators](https://awesome-repositories.com/f/security-cryptography/certificate-handling/dynamic-certificate-generators.md) — Generates and installs root certificates on the fly to enable transparent HTTPS decryption for traffic interception.

### System Administration & Monitoring

- [Traffic Interception and Modification](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/linux-system-administration/networking/traffic-interception-modification.md) — Enables real-time inspection and alteration of HTTP, HTTPS, and WebSocket request or response data. ([source](https://github.com/monkeywie/proxyee#readme))

### Graphics & Multimedia

- [Traffic Processing Pipelines](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-streaming-engines/audio-stream-filtering/configurable-filter-chain-pipelines/traffic-processing-pipelines.md) — Routes network data through configurable sequences of filters to inspect and transform traffic in real time.