La instalación recomendada es mediante pip. Es la forma más simple de desplegar HexProxy, mantener consistencia entre entornos y adoptar el proyecto como herramienta estable de trabajo. El source queda disponible en GitHub para quienes necesitan revisar el código, contribuir o trabajar sobre la rama principal.
Para la mayoría de los usuarios, la vía recomendada es instalar HexProxy directamente desde PyPI. Esta ruta reduce fricción, evita tener que clonar el repositorio solo para ejecutar la herramienta y deja más clara la operación cotidiana del producto.
pip install hexproxy
hexproxy --listen-port 8080HexProxy está orientado a Python 3.12 o superior. Para la inspección HTTPS mediante MITM local, se requiere disponer de OpenSSL en PATH, ya que la herramienta necesita generar una CA local y certificados por host. Además, se asume una terminal compatible con curses.
Python 3.12+ para ejecutar el runtime publicado y sus dependencias.
Necesario para CA local y certificados de host en escenarios HTTPS.
Una terminal capaz de trabajar correctamente con una TUI basada en curses.
Una vez instalada la herramienta, el arranque básico puede hacerse con un puerto explícito. Si el puerto solicitado está ocupado, HexProxy intenta puertos cercanos y muestra el puerto final dentro de la TUI.
hexproxy --listen-port 8080Si quieres trabajar con proyectos persistentes, guarda el estado de la sesión desde el inicio:
hexproxy --listen-port 8080 --project projects/demo.hexproxy.jsonLa ruta desde source es útil para desarrollo, revisión del código, pruebas sobre ramas de trabajo o contribuciones. No es la recomendación principal para un despliegue normal de uso diario, pero sigue siendo la vía correcta cuando el equipo necesita visibilidad total del proyecto.
git clone https://github.com/Secure-Hex/HexProxy.git
cd HexProxy
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
hexproxy --listen-port 8080También puedes ejecutar el módulo directamente cuando trabajas con el árbol fuente:
PYTHONPATH=src python3 -m hexproxy --listen-port 8080La inspección HTTPS en HexProxy funciona mediante MITM local. El flujo es claro: HexProxy genera una CA local, el cliente debe confiar esa CA y el navegador o cliente HTTP debe usar HexProxy como proxy HTTP explícito. Si el cliente no confía esa CA, el flujo HTTPS no podrá inspeccionarse correctamente.
| Elemento | Descripción |
|---|---|
| CA local | Se puede generar o regenerar desde Settings dentro de la TUI. |
| Descarga | La CA puede descargarse desde la página local servida por HexProxy. |
| Firefox | Debe configurarse como HTTP Proxy, no como HTTPS Proxy. |
| Regeneración | Si regeneras la CA, debes reimportarla en el cliente. |
En Windows, windows-curses se instala como dependencia del proyecto. Para MITM HTTPS también se requiere openssl.exe accesible desde PATH. Si necesitas decodificación Brotli, puedes agregar la dependencia opcional correspondiente.