Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
netward-standalone — User-space bot and DDoS deflection for small HTTP services | Kitploit
Tools/GitHubGitHub/dragon-lady/netward-standalone
Defensive ToolsWeb Proxies & InterceptionInformation GatheringWeb SecurityNetwork SecurityIntrusion DetectionAnti-BotAnomaly DetectionLog Analysis
GitHubdragon-lady/netward-standalone

netward-standalone

User-space bot and DDoS deflection for small HTTP services

1705 days agoNot yet reviewed
Share
View RepositoryWebsite

Net Ward

A user-space deception layer that turns DDoS and bot abuse into wasted effort.

License: Apache 2.0 Python Status

Net Ward sits in front of your HTTP service as a reverse proxy. Real traffic passes through untouched. Known probes and floods get harmless mirror responses that burn bot effort and never reach your app — no kernel hooks, no payloads, no retaliation, fail-open by design.

Why Net Ward

  • Deflects, doesn't fight back. Bots waste time on convincing-but-harmless mirrors; your upstream never sees the request.
  • User-space and fail-open. No kernel modules, no packet tampering. If classification or rendering fails, traffic passes through to upstream. Unmatched requests receive 503 when upstream cannot serve them. Storage failures use readable, cached, or bundled patterns while keeping the listener available.
  • Drops in anywhere. One Python process in front of any HTTP service. Point your load balancer at it and go.
  • Honest by design. No telemetry, no harvested credentials, operator owns every byte of local data. Apache-2.0.

Built and maintained by Dragon Lady — github.com/Dragon-Lady · X: @answerislove2 Independent security researcher tracking live supply-chain and bot-abuse campaigns in the wild.

Website: dragon-lady.github.io/netward-standalone

Version 0.5.0 expands probe matching, refreshes definitions while preserving operator settings and history, and returns 503 for unmatched requests when the upstream is unavailable. Stop the proxy and back up its database before upgrading; review the definition-refresh and rollback guidance below.


Quick Start

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

Version 0.5.0 or newer is the recommended baseline for new installations and upgrades. Older releases remain available for reproducibility; new deployments should use the current release.

Or from source:

git clone https://github.com/Dragon-Lady/netward-standalone
cd netward-standalone
pip install -e .

Net Ward listens on listen_address and forwards clean traffic to upstream_target.


Configuration

For a PyPI installation, use the minimal config.json above. The full example_config.json is a repository file, not an installed wheel resource. From a source checkout, copy it and edit the upstream target:

cp example_config.json config.json

Point upstream_target at a real HTTP service before you start Net Ward. If the upstream is unreachable, unmatched requests return 503 Service Unavailable. Matched probes continue to receive their configured decoys.

Required fields:

FieldMeaning
node_idStable name for this Net Ward instance
upstream_targetHTTP service being protected
listen_addressHost and port Net Ward binds

Optional fields control mirror intensity, local storage, mesh placeholders, alert channels, upstream timeouts, and probe-log retention. A pattern match or the start of a request flood records an alert in SQLite. Alerts are deduplicated by kind, source, and pattern for five minutes. An empty alert_channels list sends to stdout; select any combination of stdout, email, slack, and ntfy for explicit delivery. Outbound delivery runs in the background and retries failed channels. Recent undelivered alerts are retried on startup.

Email requires alert_email, alert_smtp_host, and alert_smtp_from. Set alert_smtp_port and alert_smtp_security (starttls, ssl, or none); none is permitted only for a loopback SMTP server. If authentication is needed, set alert_smtp_username and alert_smtp_password_env to the name of an environment variable containing the password. Slack requires alert_slack_webhook. ntfy requires alert_ntfy_topic (a topic on ntfy.sh or a full self-hosted topic URL); for a protected topic, set alert_ntfy_token_env to the name of an environment variable containing its bearer token. HTTP destinations must use HTTPS except on loopback. alert_timeout_secs defaults to five seconds. Net Ward checks requested destinations at startup and stores successful delivery receipts in the alerts table. Alert messages contain the source IP, pattern ID, and classification; they do not include raw request bodies or headers.

Optional fieldDefaultMeaning
upstream_timeout_total10Whole-request budget for the upstream call, in seconds
upstream_timeout_connect3Connect (DNS + TCP + TLS) timeout, in seconds
upstream_timeout_sock_read5Idle time between upstream socket reads, in seconds
upstream_max_concurrency64In-flight upstream requests
upstream_max_body_bytes8388608Max buffered upstream response body (8 MiB). Larger bodies on unmatched requests return 503
probe_retention_secs604800Probe-log TTL (7 days)
probe_max_rows10000Max probe-log rows after purge-on-write
alert_timeout_secs5Per-channel timeout for outbound alert delivery, in seconds

Run

python -m netward --config config.json

Example topology:

ComponentAddress
Net Ward127.0.0.1:8080
Upstream apphttp://127.0.0.1:9000
Storagenetward.db

Point your load balancer or web server at Net Ward. Keep the upstream app reachable only from the host or trusted network when possible. Set listen_address to 0.0.0.0:<port> only when you intentionally want Net Ward reachable beyond localhost. On Linux/macOS, keep storage_path non-world-writable. Example: chmod 600 netward.db, or chmod 644 netward.db only if you intentionally need read access for monitoring.

Resource Monitoring

Net Ward sustains its documented per-box capacity continuously, but Python runtime memory pools may retain working-set state after sustained heavy load. Operators running Net Ward under continuous heavy traffic should monitor process resource usage and restart the daemon periodically, for example weekly or when RSS exceeds 2x baseline. v0.5 will refine this guidance based on operator feedback and local test observations, not automatic telemetry.


Verify

Clean request should reach upstream:

curl -i http://127.0.0.1:8080/

Known probe should be mirrored:

curl -i http://127.0.0.1:8080/wp-admin/

The WordPress probe returns a fake login page for /wp-admin, /wp-admin/ and its subpaths (such as /wp-admin/login.php), plus /wp-login.php. Matching ignores case and does not include lookalikes such as /wp-administer. When rendering succeeds, the upstream service does not receive the request.

Before protecting a real admin panel: disable generic_admin_login_probe if your app uses /admin or /admin/login; disable wordpress_admin_probe if it serves the WordPress admin paths. See Operator Commands. A mirror-rendering error instead fails open to upstream and is logged at ERROR.

When upstream is unavailable

Inspection failure and an unavailable upstream are different cases:

Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    911
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    707
  • 3

    looking-glass

    anonghosty/looking-glass

    CSIRT platform that ingests Shadowserver reports into MongoDB and replays them as interactive maps, analysis, findings, advisories and executive dashboards.

    431
  • 4

    jumpserver

    jumpserver/jumpserver

    JumpServer is an open-source Privileged Access Management (PAM) platform that provides DevOps and IT teams with on-demand and secure access to SSH, RDP, Kubernetes, Database and RemoteApp endpoints through a web browser.

    405
  • 5

    SafeLine

    chaitin/safeline

    Self-hosted WAF and reverse proxy that filters malicious HTTP traffic, blocks SQL injection, XSS, and bot attacks, with rate limiting and dynamic HTML/JS encryption.

    352
  • 6

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    342

Explore all tools

Browse our collection of tools

View all tools →