TransparentTorProxy — Ein Linux-CLI-Dienstprogramm, das den gesamten Systemverkehr transparent über das Tor-Netzwerk mittels nftables leitet. Es ermöglicht eine schnelle IP-Rotation und ein einfaches Umschalten globaler Proxy-Einstellungen für Datenschutzaufgaben. | Kitploit


Fail-closed durch Konstruktion	Eine isolierte `inet ttp` nftables-Tabelle mit einem Catch-all-Reject und `policy drop` beim Forwarding. Bei einem Absturz, einem Watchdog-Trigger oder einem unsauberen Beenden wird der Datenverkehr entweder über Tor geleitet oder blockiert - niemals freigegeben.
Nichts bleibt bestehen	Sitzungszustand, torrc, Lock-Datei und Logs liegen ausschließlich im `tmpfs` (`/run/ttp/`, `/run/tor/ttp/`). Ein Neustart hinterlässt keine Rückstände und keine veraltete Sperre.
Keine Einrichtung pro Anwendung	TCP und DNS werden auf der Netzwerkschicht abgefangen. Keine SOCKS5-Einstellungen, keine Proxy-Umgebungsvariablen, keine Anwendungsunterstützung erforderlich.
DNS ohne Neuschreiben Ihres Systems	Ein `mount --bind`-Overlay auf `/etc/resolv.conf` statt einer Bearbeitung, plus ein flüchtiger Drop-in, der `systemd-resolved` neutralisiert, gestützt auf einen Kernel-Level-Drop für jeglichen Nicht-Loopback-Resolver-Verkehr.
Die Leak-Behauptung ist gemessen	Jede Containment-Regel wird in einem isolierten Netzwerk-Namespace gegen den tatsächlich generierten Regelsatz getestet, und jeder Test beweist zuerst, dass er ein Leck sehen kann, bevor er behauptet, dass keines existiert. Siehe Verifikation.

Proxy starten:
```
sudo ttp start
```
Proxy stoppen:
```
sudo ttp stop
```
Aktuellen Sitzungsstatus prüfen:
```
ttp status
```
Tor-Routing und Latenz überprüfen:
```
ttp check
```
Neue Exit-IP anfordern (Circuits rotieren):
```
sudo ttp refresh
```

Klicken Sie, um die manuellen Verifikationsschritte zu erweitern

Um zu bestätigen, dass der Tunnel korrekt funktioniert und keine Lecks vorhanden sind:

Tor-Exit-IP überprüfen:

curl -s https://check.torproject.org/api/ip

DNS-Routing überprüfen:

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

DNS-Leak-Test (Terminal):
```
# This TXT query SHOULD return an EMPTY output
dig +short TXT whoami.ipv4.akahelp.net
```
Hinweis: Eine leere Ausgabe ist das erwartete Verhalten unter Tor. Tors transparenter Resolver unterstützt keine TXT-Einträge; wenn dieser Befehl die echte IP Ihres ISPs zurückgibt, haben Sie ein DNS-Leck.
Webbasierte Verifikation: Führen Sie stets zusätzliche Tests auf dnsleaktest.com und ipleak.net durch.

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"]

Szenario	Was passiert
`ttp stop`	Zero-Leak-Bereinigung: wendet Teardown-Lockdown an, fährt Tor ordnungsgemäß herunter, führt aktives Socket-Abschneiden aus, wartet 1,5 s, leert die Connection-Tracking-Tabelle, stellt Firewall und DNS wieder her (über Table-Flush und -Delete) und löscht die Lock-Datei
Ctrl+C / `kill`	Signal-Handler fängt `SIGINT`/`SIGTERM` ab und führt vor dem Beenden die normale Bereinigung aus
`kill -9` / Stromausfall	Das nächste `ttp start` erkennt die verwaiste Lock-Datei, räumt etwaige veraltete Mount-Stacks auf und stellt automatisch wieder her
Manueller Notfall	Führen Sie `sudo ./scripts/restore-network.sh` aus, um alle nftables-Regeln zu leeren, DNS zurückzusetzen und die Lock-Datei zu löschen

Befehl	Ziel
`make test`	Führt schnelle Unit-Tests lokal aus (kein Root erforderlich, vollständig gemockt).
`make integration-debian`	Führt vollständige Systemtests in einem privilegierten Docker-Container aus (Debian).
`make integration-all`	Führt Integrationstests für alle unterstützten Distributionen aus (Debian, Fedora, Arch).
`make verify`	Führt Unit-Tests + alle Integrationstests aus.
`make build`	Generiert native `.deb`- und `.rpm`-Pakete.
`make clean`	Entfernt alle Build-Artefakte, Caches und temporären Dateien.

# 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


Fehler und Funktionswünsche	GitHub Issues
Sicherheitslücken	SECURITY.md - bitte eröffnen Sie kein öffentliches Issue
Versionsunterstützung und EOL	SUPPORT.md
Releases und Pakete	GitHub Releases · PyPI

Beliebteste

TransparentTorProxy

Warum TTP?

Features

Anforderungen

Installation

1. Native Pakete (Empfohlen)

2. Manuelle Quellinstallation (Entwickler/Universal)

3. Alternative Installationsmethoden (Fallback)

Verwendung

Schnellstart

Ihre Sitzung überprüfen

Vollständige Deinstallation

Funktionsweise

Absturz-Wiederherstellung

Bekanntes Verhalten & Einschränkungen

Entwicklung & Testen

Die "Pre-Push"-Regel

Wesentliche Befehle

Verifikation

Fortgeschritten: Real-World-VM-Tests

Diagnose

Projektstruktur

Mitwirken

Lizenz