🔍 portscan

Fast, colorful CLI port scanner — zero dependencies, pure Node.js net module.

Install

# via npm (after publish)
npm install -g @mazhu/portscan

# or run directly
npx @mazhu/portscan scan localhost

Usage

portscan scan <host>              # 扫描常用端口
portscan scan <host> --range 1-1000  # 指定范围
portscan scan <host> --top 100    # Top 100 端口
portscan local                    # 扫描本地监听端口
portscan whois <port>             # 查询端口用途
portscan watch <port>             # 监控端口变化

Examples

# 扫描本机常用端口
portscan scan localhost

# 扫描 1-1024
portscan scan 192.168.1.1 --range 1-1024

# Top 100
portscan scan example.com --top 100

# 本地端口
portscan local

# 查端口
portscan whois 3306
portscan whois 443

# 监控
portscan watch 8080

Options

| Flag | Description | |-------------------|-----------------------| | --range N-N | 指定端口范围 | | --top N | 扫描 Top N 常用端口 |

Output Preview

🔍  Scanning localhost — 30 ports
────────────────────────────────────────────────
[████████████████████████████] 100%  30/30 ports scanned
────────────────────────────────────────────────

  ✅  2 open port(s) found on localhost

    OPEN        22/tcp    SSH          (SSH)
    OPEN       3306/tcp    MySQL        (MySQL)

  Scan complete in 1.2s  (2 open / 28 closed)

Features

• ⚡ 零依赖 — 仅用 Node.js 内置 net 模块
• 🎨 彩色输出 — 状态一目了然 (绿=OPEN，红=CLOSED，黄=TIMEOUT)
• 🚀 并发扫描 — 高效批量检测
• 📦 轻量 — 单文件，体积小
• 🖥 跨平台 — macOS / Linux / Windows

API (library mode)

const { scanPort, scanPorts, getLocalPorts } = require('@mazhu/portscan');

// 扫描单个端口
const result = await scanPort('localhost', 80, 1000);
// { port: 80, status: 'OPEN' }

// 并发扫描多个端口
const results = await scanPorts('localhost', [22, 80, 443, 3306], 20, 1000);

// 获取本地监听端口
const local = await getLocalPorts();

License

MIT © mazhu team