NetLens Proxy

Proxy interceptador para monitoramento e analise de trafego de rede. Captura HTTP, HTTPS, WS/WSS, TCP e UDP com saida em JSONL ou HAR.

Requisitos

• Node.js 18+
• npm 9+

Instalacao

npm install
npm run build

Execucao

# modo producao
npm start

# modo desenvolvimento
npm run dev

Por padrao, o proxy sobe em 0.0.0.0:8080.

CLI

node dist/index.js [opcoes]

Opcoes principais:

• -p, --port porta HTTP/HTTPS (padrao: 8080)
• --udp-port porta UDP relay (padrao: 8081)
• -b, --bind interface de rede (padrao: 0.0.0.0)
• -f, --format formato de saida: json ou har (padrao: json)
• --no-console desativa log no console

Exemplo:

node dist/index.js --port 9090 --bind 127.0.0.1 --format har

Configuracao por arquivo

Copie o exemplo e ajuste:

cp netlens.config.example.json netlens.config.json

Certificado CA

Na primeira execucao, o projeto gera certificados em certs/. Para inspecionar HTTPS/WSS, instale o CA (certs/ca.pem) no dispositivo/navegador de teste.

Saida de logs

As capturas sao gravadas em logs/ no formato escolhido:

• json -> JSON Lines (.jsonl)
• har -> HAR compativel com ferramentas como DevTools

Scripts npm

• npm run build compila TypeScript para dist/
• npm start executa dist/index.js
• npm run dev executa via ts-node
• npm run clean remove dist/

Estrutura

src/
  certs/
  config/
  formatters/
  logger/
  proxy/
  utils/
  index.ts

Aviso

Use este proxy apenas em ambientes autorizados. Inspecao de trafego sem permissao pode violar politicas internas e legislacao local.