
Bot en espace utilisateur et déviation DDoS pour les petits services HTTP
Une couche de tromperie en espace utilisateur qui transforme les DDoS et les abus de bots en efforts inutiles.
Net Ward se place devant votre service HTTP en tant que proxy inverse. Le trafic réel passe sans être modifié. Les sondes et les floods connus reçoivent des réponses miroir inoffensives qui consument l'effort des bots et n'atteignent jamais votre application — aucun hook noyau, aucune charge utile, aucune représaille, fail-open par conception.
Conçu et maintenu par Dragon Lady — github.com/Dragon-Lady · X : @answerislove2 Chercheuse indépendante en sécurité qui suit les campagnes actives de chaîne d'approvisionnement et d'abus de bots dans la nature.
Site web : dragon-lady.github.io/netward-standalone
Version 0.5.0 étend la correspondance des sondes, actualise les définitions tout en préservant les paramètres et l'historique de l'opérateur, et renvoie un 503 pour les requêtes non appariées lorsque l'amont est indisponible. Arrêtez le proxy et sauvegardez sa base de données avant de mettre à niveau ; consultez les indications ci-dessous sur l'actualisation des définitions et le retour arrière.
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
La version 0.5.0 ou plus récente est la base recommandée pour les nouvelles installations et les mises à niveau. Les versions plus anciennes restent disponibles pour la reproductibilité ; les nouveaux déploiements doivent utiliser la version actuelle.
Ou depuis les sources :
git clone https://github.com/Dragon-Lady/netward-standalone
cd netward-standalone
pip install -e .
Net Ward écoute sur listen_address et transmet le trafic propre vers upstream_target.
Pour une installation via PyPI, utilisez le config.json minimal ci-dessus. Le fichier complet
example_config.json est un fichier du dépôt, et non une ressource installée dans le wheel.
Depuis une copie du code source, copiez-le et modifiez la cible en amont :
cp example_config.json config.json
Avant de démarrer Net Ward, pointez upstream_target vers un véritable service HTTP. Si
l'upstream est injoignable, les requêtes non appariées renvoient 503 Service Unavailable.
Les sondes appariées continuent de recevoir leurs leurres configurés.
Champs obligatoires :
| Champ | Signification |
|---|---|
node_id | Nom stable de cette instance Net Ward |
upstream_target | Service HTTP protégé |
listen_address | Hôte et port sur lesquels Net Ward se lie |
Les champs facultatifs contrôlent l'intensité du miroir, le stockage local, les espaces réservés du maillage, les canaux d'alerte, les délais d'attente upstream et la rétention du journal des sondes. Une correspondance de motif ou le début d'un afflux de requêtes enregistre une alerte dans SQLite. Les alertes sont dédupliquées par type, source et motif pendant cinq minutes. Une liste alert_channels vide envoie vers stdout ; sélectionnez toute combinaison de stdout, email, slack et ntfy pour une livraison explicite. La livraison sortante s'exécute en arrière-plan et réessaie les canaux en échec. Les alertes récentes non livrées sont réessayées au démarrage.
L'e-mail nécessite alert_email, alert_smtp_host et alert_smtp_from. Définissez alert_smtp_port et alert_smtp_security (starttls, ssl ou none) ; none n'est autorisé que pour un serveur SMTP en boucle locale. Si une authentification est nécessaire, définissez alert_smtp_username et alert_smtp_password_env avec le nom d'une variable d'environnement contenant le mot de passe. Slack nécessite alert_slack_webhook. ntfy nécessite alert_ntfy_topic (un sujet sur ntfy.sh ou une URL complète de sujet auto-hébergé) ; pour un sujet protégé, définissez alert_ntfy_token_env avec le nom d'une variable d'environnement contenant son jeton bearer. Les destinations HTTP doivent utiliser HTTPS, sauf en boucle locale. alert_timeout_secs vaut cinq secondes par défaut. Net Ward vérifie les destinations demandées au démarrage et stocke les accusés de livraison réussis dans la table des alertes. Les messages d'alerte contiennent l'IP source, l'ID du motif et la classification ; ils n'incluent ni les corps ni les en-têtes bruts des requêtes.
| Champ facultatif | Valeur par défaut | Signification |
|---|---|---|
upstream_timeout_total | 10 | Budget total de la requête pour l'appel upstream, en secondes |
upstream_timeout_connect | 3 | Délai de connexion (DNS + TCP + TLS), en secondes |
upstream_timeout_sock_read | 5 | Temps d'inactivité entre les lectures de socket upstream, en secondes |
upstream_max_concurrency | 64 | Requêtes upstream en cours |
upstream_max_body_bytes | 8388608 | Taille maximale du corps de réponse upstream mis en tampon (8 MiB). Les corps plus volumineux sur les requêtes non appariées renvoient 503 |
probe_retention_secs | 604800 | TTL du journal des sondes (7 jours) |
probe_max_rows | 10000 | Nombre maximal de lignes du journal des sondes après purge à l'écriture |
alert_timeout_secs | 5 | Délai d'attente par canal pour la livraison sortante des alertes, en secondes |
python -m netward --config config.json
Exemple de topologie :
| Composant | Adresse |
|---|---|
| Net Ward | 127.0.0.1:8080 |
| Application en amont | http://127.0.0.1:9000 |
| Stockage | netward.db |
Pointez votre équilibreur de charge ou votre serveur web vers Net Ward. Gardez l'application en amont accessible uniquement depuis l'hôte ou un réseau de confiance lorsque c'est possible.
Définissez listen_address sur 0.0.0.0:<port> uniquement lorsque vous souhaitez intentionnellement que Net Ward soit accessible au-delà de localhost.
Sous Linux/macOS, gardez storage_path non accessible en écriture à tous. Exemple : chmod 600 netward.db, ou chmod 644 netward.db uniquement si vous avez intentionnellement besoin d'un accès en lecture pour la supervision.