@kszongic/port-scan

⚡ Fast concurrent port scanner for your local machine. Zero dependencies. Shows open ports, services, and process info.

Install

npm i -g @kszongic/port-scan

Or run directly:

npx @kszongic/port-scan

Usage

# Scan default ports (1-1024)
port-scan

# Scan a specific range
port-scan 3000-9000

# Scan common well-known ports only
port-scan --common

# Scan ALL ports
port-scan --range 1-65535

# JSON output (great for piping)
port-scan --json

# Custom timeout and concurrency
port-scan --timeout 2000 --concurrency 1000

Example Output

⚡ Scanning 1024 ports...

  PORT     STATUS    SERVICE          PID      PROCESS
  ────────────────────────────────────────────────────────────
  22       ●  open   SSH              1234     sshd
  80       ●  open   HTTP             5678     nginx
  443      ●  open   HTTPS            5678     nginx
  3000     ●  open   Dev Server       9012     node
  5432     ●  open   PostgreSQL       3456     postgres

  Found 5 open port(s) out of 1024 scanned

Options

| Option | Alias | Description | Default | |---|---|---|---| | --range <start-end> | -r | Port range to scan | 1-1024 | | --common | -c | Scan well-known ports only | off | | --json | -j | Output as JSON | off | | --timeout <ms> | -t | Connection timeout per port | 1000 | | --concurrency <n> | | Max concurrent connections | 500 | | --help | -h | Show help | |

Features

• 🚀 Fast — concurrent scanning (500 ports at a time by default)
• 🔍 Process info — shows PID and process name (Windows, Linux, macOS)
• 🏷️ Service names — identifies common services (HTTP, SSH, MySQL, etc.)
• 🎨 Colorful output — easy to read terminal display
• 📦 Zero dependencies — just Node.js built-ins
• 💻 Cross-platform — Windows, Linux, macOS

License

MIT