
Bot em espaço de usuário e deflexão de DDoS para pequenos serviços HTTP
Uma camada de decepção em espaço de usuário que transforma DDoS e abuso de bots em esforço desperdiçado.
O Net Ward fica à frente do seu serviço HTTP como um proxy reverso. O tráfego real passa intacto. Sondagens e inundações conhecidas recebem respostas espelhadas inofensivas que consomem o esforço dos bots e nunca chegam à sua aplicação — sem hooks de kernel, sem payloads, sem retaliação, fail-open por design.
Criado e mantido por Dragon Lady — github.com/Dragon-Lady · X: @answerislove2 Investigadora de segurança independente que acompanha campanhas ativas de supply-chain e abuso de bots em ambiente real.
Website: dragon-lady.github.io/netward-standalone
Versão 0.5.0 expande a correspondência de sondagens, atualiza as definições preservando as configurações e o histórico do operador, e devolve 503 para pedidos não correspondidos quando o upstream está indisponível. Pare o proxy e faça backup da sua base de dados antes de atualizar; reveja as orientações de atualização de definições e de rollback abaixo.
python -m pip install --upgrade "netward>=0.5.0"
# Create config.json in a directory owned by your user (not directly in /tmp).
cat > config.json <<'JSON'
{
"node_id": "netward-local",
"upstream_target": "http://127.0.0.1:9000",
"listen_address": "127.0.0.1:8080",
"storage_path": "netward.db"
}
JSON
# Edit upstream_target to point at your running app before starting.
python -m netward --config config.json
A versão 0.5.0 ou mais recente é a base recomendada para novas instalações e atualizações. Versões mais antigas permanecem disponíveis para fins de reprodutibilidade; novas implantações devem usar a versão atual.
Ou a partir do código-fonte:
git clone https://github.com/Dragon-Lady/netward-standalone
cd netward-standalone
pip install -e .
O Net Ward escuta em listen_address e encaminha o tráfego limpo para upstream_target.
Para uma instalação via PyPI, use o config.json mínimo acima. O
example_config.json completo é um arquivo do repositório, não um recurso
instalado no wheel. A partir de um checkout do código-fonte, copie-o e edite o alvo upstream:
cp example_config.json config.json
Aponte upstream_target para um serviço HTTP real antes de iniciar o Net Ward. Se
o upstream estiver inacessível, requisições não correspondidas retornam 503 Service Unavailable.
Sondagens correspondidas continuam a receber seus decoys configurados.
Campos obrigatórios:
| Campo | Significado |
|---|---|
node_id | Nome estável para esta instância do Net Ward |
upstream_target | Serviço HTTP sendo protegido |
listen_address | Host e porta em que o Net Ward escuta |
Campos opcionais controlam a intensidade do mirror, armazenamento local, placeholders de mesh, canais de alerta, timeouts do upstream e retenção do log de sondagens. Uma correspondência de padrão ou o início de uma inundação de requisições registra um alerta no SQLite. Alertas são deduplicados por tipo, origem e padrão durante cinco minutos. Uma lista alert_channels vazia envia para stdout; selecione qualquer combinação de stdout, email, slack e ntfy para entrega explícita. A entrega de saída é executada em segundo plano e repete tentativas para canais com falha. Alertas recentes não entregues são reprocessados na inicialização.
Email requer alert_email, alert_smtp_host e alert_smtp_from. Defina alert_smtp_port e alert_smtp_security (starttls, ssl ou none); none é permitido apenas para um servidor SMTP em loopback. Se autenticação for necessária, defina alert_smtp_username e alert_smtp_password_env com o nome de uma variável de ambiente que contém a senha. Slack requer alert_slack_webhook. ntfy requer alert_ntfy_topic (um tópico em ntfy.sh ou uma URL completa de tópico auto-hospedado); para um tópico protegido, defina alert_ntfy_token_env com o nome de uma variável de ambiente que contém seu bearer token. Destinos HTTP devem usar HTTPS, exceto em loopback. alert_timeout_secs tem como padrão cinco segundos. O Net Ward verifica os destinos solicitados na inicialização e armazena recibos de entrega bem-sucedidos na tabela de alertas. As mensagens de alerta contêm o IP de origem, o ID do padrão e a classificação; elas não incluem corpos ou cabeçalhos de requisição brutos.
| Campo opcional | Padrão | Significado |
|---|---|---|
upstream_timeout_total | 10 | Orçamento total da requisição para a chamada ao upstream, em segundos |
upstream_timeout_connect | 3 | Timeout de conexão (DNS + TCP + TLS), em segundos |
upstream_timeout_sock_read | 5 | Tempo ocioso entre leituras do socket do upstream, em segundos |
upstream_max_concurrency | 64 | Requisições ao upstream em andamento |
upstream_max_body_bytes | 8388608 | Corpo máximo de resposta do upstream em buffer (8 MiB). Corpos maiores em requisições não correspondidas retornam 503 |
probe_retention_secs | 604800 | TTL do log de sondagens (7 dias) |
probe_max_rows | 10000 | Máximo de linhas do log de sondagens após purga na escrita |
alert_timeout_secs | 5 | Timeout por canal para entrega de alertas de saída, em segundos |
python -m netward --config config.json
Exemplo de topologia:
| Componente | Endereço |
|---|---|
| Net Ward | 127.0.0.1:8080 |
| Aplicação upstream | http://127.0.0.1:9000 |
| Armazenamento | netward.db |
Aponte seu balanceador de carga ou servidor web para o Net Ward. Mantenha a aplicação upstream acessível apenas a partir do host ou de uma rede confiável quando possível.
Defina listen_address como 0.0.0.0:<port> apenas quando você quiser intencionalmente que o Net Ward seja acessível além do localhost.
No Linux/macOS, mantenha storage_path sem permissão de escrita para todos os usuários. Exemplo: chmod 600 netward.db, ou chmod 644 netward.db apenas se você precisar intencionalmente de acesso de leitura para monitoramento.
O Net Ward sustenta continuamente sua capacidade documentada por caixa, mas os pools de memória do runtime Python podem reter o estado do working-set após carga pesada sustentada. Operadores que executam o Net Ward sob tráfego pesado contínuo devem monitorar o uso de recursos do processo e reiniciar o daemon periodicamente, por exemplo semanalmente ou quando o RSS exceder 2x a linha de base. A v0.5 refinará esta orientação com base no feedback dos operadores e em observações de testes locais, não em telemetria automática.
Uma requisição limpa deve chegar ao upstream:
curl -i http://127.0.0.1:8080/
Sonda conhecida deve ser espelhada:
curl -i http://127.0.0.1:8080/wp-admin/