TransparentTorProxy — Una utilidad CLI de Linux que enruta de forma transparente todo el tráfico del sistema a través de la red Tor usando nftables. Permite la rotación rápida de IP y la activación/desactivación sencilla de la configuración global de proxy para tareas de privacidad. | Kitploit


Falla cerrado por construcción	Una tabla nftables aislada `inet ttp` con un rechazo general y `policy drop` en el reenvío. Ante un fallo, un disparador del watchdog o una salida no limpia, el tráfico se enruta a través de Tor o se bloquea - nunca se libera.
Nada persiste	El estado de la sesión, torrc, el archivo de bloqueo y los registros viven solo en `tmpfs` (`/run/ttp/`, `/run/tor/ttp/`). Un reinicio no deja residuos ni bloqueos obsoletos.
Sin configuración por aplicación	TCP y DNS se interceptan en la capa de red. Sin ajustes SOCKS5, sin variables de entorno de proxy, sin necesidad de soporte de aplicaciones.
DNS sin reescribir tu sistema	Una superposición `mount --bind` sobre `/etc/resolv.conf` en lugar de una edición, más un drop-in volátil que neutraliza `systemd-resolved`, respaldado por un descarte a nivel de kernel de cualquier tráfico hacia resolutores que no sean loopback.
La afirmación de no fuga se mide	Cada regla de contención se prueba en un espacio de nombres de red aislado contra el conjunto de reglas real generado, y cada prueba primero demuestra que puede ver una fuga antes de afirmar que no hay ninguna. Ver Verificación.

Iniciar el proxy:
```
sudo ttp start
```
Detener el proxy:
```
sudo ttp stop
```
Comprobar el estado de la sesión actual:
```
ttp status
```
Verificar el enrutamiento y la latencia de Tor:
```
ttp check
```
Solicitar una nueva IP de salida (rotar circuitos):
```
sudo ttp refresh
```

Haz clic para expandir los pasos de verificación manual

Para confirmar que el túnel funciona correctamente y que no hay fugas:

Verificar la IP de salida de Tor:
```
curl -s https://check.torproject.org/api/ip
```

Verificar el enrutamiento DNS:

# Should return a valid IP via Tor's DNSPort
dig +short A check.torproject.org

Prueba de fuga de DNS (Terminal):
```
# This TXT query SHOULD return an EMPTY output
dig +short TXT whoami.ipv4.akahelp.net
```
Nota: Una salida vacía es el comportamiento esperado bajo Tor. El resolutor transparente de Tor no admite registros TXT; si este comando devuelve la IP de tu ISP real, tienes una fuga de DNS.
Verificación basada en web: Realiza siempre pruebas adicionales en dnsleaktest.com y ipleak.net.

flowchart LR
    App["Application"] --> Local["Local Network"]
    Local --> DNS["systemd-resolved (Intercepted)"]
    DNS --> NFT["nftables (inet ttp table)"]
    NFT --> Tor["Tor Daemon"]
    Tor --> Internet["Internet"]

Escenario	Qué ocurre
`ttp stop`	Limpieza sin fugas: aplica el bloqueo de desmontaje, apaga Tor de forma ordenada, ejecuta la eliminación activa de sockets, espera 1.5s, vacía el seguimiento de conexiones, restaura el firewall y el DNS (mediante el vaciado y eliminación de tablas), y elimina el archivo de bloqueo
Ctrl+C / `kill`	El manejador de señales captura `SIGINT`/`SIGTERM` y ejecuta la limpieza normal antes de salir
`kill -9` / Corte de energía	El siguiente `ttp start` detecta el archivo de bloqueo huérfano, limpia cualquier pila de montaje obsoleta y se restaura automáticamente
Emergencia manual	Ejecuta `sudo ./scripts/restore-network.sh` para vaciar todas las reglas de nftables, restablecer el DNS y eliminar el archivo de bloqueo

Comando	Objetivo
`make test`	Ejecuta Pruebas unitarias rápidas localmente (no requiere root, totalmente simuladas).
`make integration-debian`	Ejecuta pruebas completas del sistema dentro de un contenedor Docker privilegiado (Debian).
`make integration-all`	Ejecuta pruebas de integración para todas las distros compatibles (Debian, Fedora, Arch).
`make verify`	Ejecuta pruebas unitarias + todas las pruebas de integración.
`make build`	Genera paquetes nativos `.deb` y `.rpm`.
`make clean`	Elimina todos los artefactos de compilación, cachés y archivos temporales.

# libpcap is required: the sniffer compiles a BPF filter, and Scapy dlopen()s
# the unversioned libpcap.so that only the -devel/-dev package ships.
sudo apt install nftables iproute2 conntrack libpcap0.8 libpcap-dev   # Debian/Ubuntu
sudo dnf install nftables iproute2 conntrack libpcap libpcap-devel    # Fedora/RHEL
pip install -e ".[nse]"
make test-nse            # runs as root; TTP_REQUIRE_NSE=1 so it cannot skip itself

# Start a specific VM (e.g., arch)
./scripts/vm/start.sh arch

# Sync current code to the VM
./scripts/vm/send.sh

# Snapshot management for easy rollbacks
./scripts/vm/snapshot.sh arch save before-risky-test

├── pyproject.toml          # Package metadata and dependencies
├── README.md
├── CONTRIBUTING.md         # Contribution guidelines
├── SECURITY.md             # Security policy
├── scripts/                # Installation, verification, and VM management scripts
├── assets/                 # Branding and demo assets
├── packaging/              # Packaging configurations (.deb, .rpm, Arch PKGBUILD)
├── ttp/                    # Main Python source package
│   └── resources/          # Internal package resources (SELinux policies, etc.)
├── tests/                  # Unit, integration, and leak testing suites
└── docs/                   # Technical documentation, threat models, and ADRs


Errores y solicitudes de funciones	GitHub Issues
Vulnerabilidades de seguridad	SECURITY.md - por favor, no abras un issue público
Soporte de versiones y EOL	SUPPORT.md
Versiones y paquetes	GitHub Releases · PyPI

Más Populares

TransparentTorProxy

¿Por qué TTP?

Características

Requisitos

Instalación

1. Paquetes nativos (recomendado)

2. Instalación manual desde el código fuente (Desarrollador/Universal)

3. Métodos de instalación alternativos (Respaldo)

Uso

Inicio rápido

Comprobar tu sesión

Desinstalación completa

Cómo funciona

Recuperación ante fallos

Comportamiento conocido y limitaciones

Desarrollo y pruebas

La regla "Pre-Push"

Comandos esenciales

Verificación

Avanzado: Pruebas en VM del mundo real

Diagnóstico

Estructura del proyecto

Contribuir

Licencia