https://github.com/hacker1024/mitmproxy_remote_interceptions
A mitmproxy addon that provides a WebSocket-based API for remote interceptions.
https://github.com/hacker1024/mitmproxy_remote_interceptions
mitm mitmproxy mitmproxy-addons proxy proxy-server python python3 websocket websocket-server
Last synced: about 2 months ago
JSON representation
A mitmproxy addon that provides a WebSocket-based API for remote interceptions.
- Host: GitHub
- URL: https://github.com/hacker1024/mitmproxy_remote_interceptions
- Owner: hacker1024
- License: mit
- Created: 2022-05-28T12:28:25.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-23T05:30:56.000Z (about 3 years ago)
- Last Synced: 2025-06-28T10:46:54.750Z (12 months ago)
- Topics: mitm, mitmproxy, mitmproxy-addons, proxy, proxy-server, python, python3, websocket, websocket-server
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mitmproxy Remote Interceptions
A [mitmproxy] addon that provides a WebSocket-based API for remote interceptions.
## Usage
This addon requires [Python] 3.10 or newer.
```shell
# Install the addon requirements
pip install -r requirements.txt
# Launch mitmdump (or any addon-capable mitmproxy tool) with the addon
mitmdump -s src/mitmproxy_remote_interceptions.py
```
The addon will start a WebSocket server on port `8082` by default, but this can be customized with the `ws_port` option.
```shell
mitmdump -s src/mitmproxy_remote_interceptions.py --set ws_port=8000
```
### Nix
A [Nix](https://nixos.org) derivation is included.
```shell
nix-shell -p 'callPackage ./. { }'
mitmridump
```
### WebSocket API
WebSocket API documentation can be found in [`API.md`](API.md).
## Known client libraries
| Language/framework | Client library |
|------------------------------------------|---------------------------------------------------------------------|
| [Dart](https://dart.dev) (native and JS) | [mitmproxy_ri_client](https://pub.dev/packages/mitmproxy_ri_client) |
[mitmproxy]: https://mitmproxy.org
[python]: https://www.python.org