Skip to content

Web Dashboard

Jump to bottom
katana edited this page May 15, 2026 · 2 revisions

Web Dashboard

The web dashboard is embedded directly in the server binary and served at http://<server-ip>:1024. It provides a real-time view of all connected agents and full control over routing, forwards, SOCKS5 proxies, and server settings.

Accessing the Dashboard

Open a browser and navigate to:

http://<server-ip>:1024

Log in with your AES key. Sessions expire after 30 minutes of inactivity.

Views

Agent Graph View

An interactive network graph built with Cytoscape.js.

  • Each connected agent appears as a node
  • Edges between agents indicate shared subnets
  • Clicking a node opens the agent context menu
  • The graph automatically lays out agents and visualizes multi-hop relationships

Agent Table View

A tabular list of all connected agents showing:

  • OS icon and platform
  • Hostname and username
  • Discovered subnets
  • Internet access status
  • Connection duration
  • Custom tag (if set)

Switch between graph and table view using the toggle in the top bar.

Agent Actions

Click any agent in the graph or table to access per-agent actions:

Action Description
Tag Set a display name for the agent
Port Forward Create a TCP or UDP port forward through the agent
Reverse Forward Create a reverse port forward (server listens, agent dials)
SOCKS5 Start a SOCKS5 proxy through the agent
Ping Ping a host via the agent
Port Scan Run a TCP or UDP port scan via the agent
Reconnect Force the agent to reconnect
Disconnect Disconnect the agent

Routing Table

The routing table panel shows all subnets registered by connected agents.

  • Toggle individual routes on or off without disconnecting the agent
  • View which agent owns each subnet
  • See the current egress agent

Port Forwards Panel

View and manage all active TCP and UDP port forwards:

  • Create new forwards by selecting an agent, local port, target host, and target port
  • Delete forwards with one click
  • See the status of each forward

Reverse Forwards Panel

View and manage reverse port forwards:

  • Server listens on a local port
  • Agent dials out to the specified host and port
  • Useful for exposing services on the server side through the agent

SOCKS5 Panel

View and manage SOCKS5 proxies:

  • Start a proxy on any local port through any connected agent
  • Optional username and password authentication
  • Stop proxies individually

Settings Modal

Configure the server without restarting:

Setting Description
HTTP port Dashboard and API port
TCP proxy port Transparent TCP proxy port
UDP proxy port TPROXY UDP port
DNS proxy port DNS intercept port
Encryption key AES-256 key (base64url)
Session timeout Idle session expiry in minutes
Agent port QUIC/UDP agent transport port

Changes take effect immediately. The new config can be saved to a file from the REPL.

API Tokens Panel

Create and manage REST API tokens with granular permissions:

  • Set scope: read, write, or admin
  • Set an optional TTL in minutes
  • View and revoke existing tokens

CLI Panel

A built-in terminal panel that streams the server REPL output in real time over a WebSocket connection. Supports sending any REPL command directly from the browser.

Real-Time Updates

The dashboard connects to /api/dashboard-ws on load. The server pushes the full dashboard state every 200ms when there are changes, using a coalescing window to avoid flooding the browser during bursts of agent activity. No polling required.

Theme

The dashboard supports light and dark themes. Toggle using the button in the top bar. The preference is saved in the browser.

Use only on systems you own or have explicit written permission to test. Unauthorized use is prohibited.

Clone this wiki locally