Firegex Python Library and CLI
This is the Python library for Firegex, a firewall built for CTF Attack-Defense competitions. It provides the firegex.nfproxy package used to write Netfilter Proxy Python packet filters, the fgex CLI, and a local proxy simulator (proxysim) for testing filters without a running Firegex instance.
Installation
pip install -U firegex
fgex is an alias package for firegex: installing either one gives you the same firegex module and the fgex/firegex CLI commands.
Documentation
➡️ Netfilter Proxy: writing and testing @pyfilter scripts — the pyfilter decorator, every data structure (RawPacket, TCPInputStream/TCPOutputStream, HttpRequest/HttpResponse and their variants, HttpHistory), packet statements, stream limits, the fgex nfproxy CLI simulator, and a full worked example.
That page is also what's shown in the Firegex web UI itself (the docs button on the nfproxy pages) — both are generated from that single file, so they can never drift out of sync.
Firegex's other filtering modules
This library only covers Netfilter Proxy. Firegex ships several other independent modules, each with its own guide:
- Netfilter Regex — fast, PCRE2/hyperscan-based regex matching against raw traffic.
- Hijack Port to Proxy — redirect traffic to your own external proxy without touching the target service.
- Firewall Rules — plain nftables allow/drop/reject rules.
- TLS Decryption — decrypt-and-reinspect bridge for services that speak TLS natively.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file firegex-4.0.4.tar.gz.
File metadata
- Download URL: firegex-4.0.4.tar.gz
- Upload date:
- Size: 19.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8078fecda8fe40bf74ac92d1e0d03d6cd559cdaf1d29510e7d7c3a10b2d488c9
|
|
| MD5 |
dfa1020a482250c7a5fd35f94c39da0c
|
|
| BLAKE2b-256 |
d12e6262ab75d69099e9080afa0e323ed02adab01e94aaf22260eeba29648880
|
File details
Details for the file firegex-4.0.4-py3-none-any.whl.
File metadata
- Download URL: firegex-4.0.4-py3-none-any.whl
- Upload date:
- Size: 21.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
75c74a17f36d04cf79b4c3088ce53e1c160aceff592692e77b8fe05403f15bb3
|
|
| MD5 |
8420c84f5ed2d9e6632a6446ead63fe9
|
|
| BLAKE2b-256 |
623f71eaec29a78b8c0c3f76c1254ce5a6b8c76abbce0712a8b218dd07303c10
|
