TransparentTorProxy — Um utilitário de CLI Linux que encaminha de forma transparente todo o tráfego do sistema através da rede Tor usando nftables. Ele permite rotação rápida de IP e alternância fácil das configurações globais de proxy para tarefas de privacidade. | Kitploit


Falha fechada por construção	Uma tabela nftables isolada `inet ttp` com um reject abrangente e `policy drop` no encaminhamento. Em caso de travamento, acionamento do watchdog ou saída anormal, o tráfego é roteado pelo Tor ou bloqueado - nunca liberado.
Nada persiste	O estado da sessão, torrc, arquivo de lock e logs vivem apenas em `tmpfs` (`/run/ttp/`, `/run/tor/ttp/`). Um reboot não deixa resíduos nem lock obsoleto.
Sem configuração por aplicação	TCP e DNS são interceptados na camada de rede. Sem configurações SOCKS5, sem variáveis de ambiente de proxy, sem necessidade de suporte da aplicação.
DNS sem reescrever seu sistema	Uma sobreposição `mount --bind` em `/etc/resolv.conf` em vez de uma edição, além de um drop-in volátil que neutraliza o `systemd-resolved`, respaldado por um drop em nível de kernel em qualquer tráfego de resolver que não seja loopback.
A alegação de vazamento é medida	Cada regra de contenção é testada em um namespace de rede isolado contra o conjunto de regras real gerado, e cada teste primeiro prova que consegue ver um vazamento antes de afirmar que não há nenhum. Veja Verificação.

Iniciar o proxy:
```
sudo ttp start
```
Parar o proxy:
```
sudo ttp stop
```
Verificar o status da sessão atual:
```
ttp status
```
Verificar o roteamento e a latência do Tor:
```
ttp check
```
Solicitar um novo IP de saída (rotacionar circuitos):
```
sudo ttp refresh
```

Clique para expandir os passos de verificação manual

Para confirmar que o túnel está funcionando corretamente e que não há vazamentos:

Verificar o IP de Saída do Tor:
```
curl -s https://check.torproject.org/api/ip
```

Verificar o Roteamento de DNS:

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

Teste de Vazamento de DNS (Terminal):
```
# This TXT query SHOULD return an EMPTY output
dig +short TXT whoami.ipv4.akahelp.net
```
Nota: Uma saída vazia é o comportamento esperado sob o Tor. O resolvedor transparente do Tor não suporta registros TXT; se este comando retornar o IP do seu ISP real, você tem um vazamento de DNS.
Verificação Baseada na Web: Sempre realize testes adicionais em dnsleaktest.com e 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"]

Cenário	O que acontece
`ttp stop`	Limpeza sem vazamentos: aplica bloqueio de desmontagem, encerra o Tor graciosamente, executa o abate ativo de sockets, aguarda 1,5s, limpa o rastreamento de conexões, restaura firewall e DNS (via flush e delete da tabela), e exclui o arquivo de lock
Ctrl+C / `kill`	O manipulador de sinais captura `SIGINT`/`SIGTERM` e executa a limpeza normal antes de sair
`kill -9` / Queda de Energia	O próximo `ttp start` detecta o arquivo de lock órfão, limpa quaisquer pilhas de mount obsoletas e restaura automaticamente
Emergência manual	Execute `sudo ./scripts/restore-network.sh` para limpar todas as regras nftables, redefinir o DNS e excluir o arquivo de lock

Comando	Objetivo
`make test`	Executa Testes Unitários rápidos localmente (sem necessidade de root, totalmente mockados).
`make integration-debian`	Executa testes completos de sistema dentro de um contêiner Docker privilegiado (Debian).
`make integration-all`	Executa testes de integração para todas as distros suportadas (Debian, Fedora, Arch).
`make verify`	Executa Testes Unitários + Todos os Testes de Integração.
`make build`	Gera pacotes nativos `.deb` e `.rpm`.
`make clean`	Remove todos os artefatos de build, caches e arquivos temporários.

# 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


Bugs e solicitações de recursos	GitHub Issues
Vulnerabilidades de segurança	SECURITY.md - por favor, não abra uma issue pública
Suporte de versão e EOL	SUPPORT.md
Releases e pacotes	GitHub Releases · PyPI

Mais Populares

TransparentTorProxy

Por que o TTP?

Recursos

Requisitos

Instalação

1. Pacotes Nativos (Recomendado)

2. Instalação Manual a partir do Código-Fonte (Desenvolvedor/Universal)

3. Métodos Alternativos de Instalação (Fallback)

Uso

Início Rápido

Verificando Sua Sessão

Desinstalação Completa

Como Funciona

Recuperação de Falhas

Comportamento Conhecido e Limitações

Desenvolvimento e Testes

A Regra do "Pre-Push"

Comandos Essenciais

Verificação

Avançado: Testes em VM do Mundo Real

Diagnósticos

Estrutura do Projeto

Contribuindo

Licença