Skip to main content
The Network Tester lets you deploy agents onto hosts inside a target environment and interact with them directly from Pwnbook. Once an agent is running, you can issue commands, view output in real time, and send crafted network packets — all without leaving the project.
Network Tester is available on select plans. Contact your administrator if the feature is not visible in your project.

​
Overview

Network Tester has two main capabilities:
  • Agents — Lightweight processes you deploy on target hosts. Agents check in with Pwnbook, receive commands, and return results. Useful for running reconnaissance, scripts, or arbitrary commands from inside a network segment.
  • Packet crafting — Build and send custom network packets (TCP, UDP, ICMP, and more) with full control over headers and payloads. Supports reusable templates and a community template library.

​
Deploying an agent

1

Open the deployment wizard

Navigate to Network Tester inside your project and click Deploy Agent. The wizard walks you through naming the agent and selecting a deployment method.
2

Choose a runtime

Agents are available in multiple runtimes to match what’s available on the target host:
RuntimeRequirements
PythonPython 3.9+, no external dependencies
BashAny POSIX shell
PowerShellPowerShell 5.1+ (Windows or cross-platform)
GoPre-compiled binary, no runtime needed
3

Run the agent on the target host

Copy the generated command or script and run it on the target host. The agent connects back to Pwnbook and appears in the agent list once it checks in.

​
Managing agents

The Agents tab lists all agents for the current project, along with their status, last seen time, and host details (hostname, OS, IP address). From the agent list you can:
  • Issue commands — Send a shell command and view stdout, stderr, and exit code in the results panel.
  • View history — Browse all previously issued commands and their output.
  • Configure check-in interval — Control how frequently the agent polls for new commands.
  • Delete an agent — Removes the agent record. The process on the target host will stop receiving commands.
Agents continue running on the target host until stopped manually. After deleting an agent in Pwnbook, terminate the agent process on the host.

​
Packet crafting

The Packet Crafter lets you build and send network packets directly from Pwnbook or via a deployed agent.

​
Supported protocols

  • TCP — Configure flags (SYN, ACK, FIN, RST, PSH, URG), window size, and options.
  • UDP — Set checksum behavior and payload.
  • ICMP — Type and code selection, payload.
  • Raw / custom — Manual header construction for other protocols.
Both IPv4 and IPv6 are supported.

​
Templates

Save packet configurations as templates to reuse across tests. Templates can be:
  • Custom — Private to your organization.
  • Community — Shared templates published by the Pwnbook community. You can import community templates and customize them before use.
To save a new template, configure your packet and click Save as Template. Templates appear in the template catalog and can be launched directly from there in future sessions.

​
Running scripts

The Script Runner tab lets you send multi-line scripts to a connected agent and stream the output back as it executes. Useful for longer automation tasks or when you need to run a sequence of commands in a single session.