web页面：/API/ports/index.html

端口扫描接口文档（SSE 流式接口）

一、接口概述

该接口为纯 SSE 流式长连接接口

实时端口扫描

自定义端口、端口范围、超时时间。

全程单一长连接流式返回，实时推送进度、单端口结果、最终统计

所有错误统一通过 SSE 事件返回，不使用 HTTP 状态码

二、请求信息

项目	内容
请求方式	GET
协议	SSE（`text/event-stream`）
编码	UTF-8
跨域	支持全部跨域

三、请求参数（GET）

参数名	是否必填	类型	说明
`address`	是	string	扫描目标 IP / 域名，为空直接返回 SSE 参数错误
`timeout`	否	float	单端口超时时间，限制区间：`0.1 ~ 10` 秒，默认跟随系统
`port`	否	string	自定义扫描端口，支持三种格式： 1. 单端口：`80` 2. 多端口：`80,443,3306` 3. 端口范围：`1-1000` 不传默认扫描内置常用端口列表

四、SSE 推送事件列表

接口所有数据均以 SSE 事件流返回，前端通过 EventSource 监听对应事件。

1. `scan_start` – 扫描开始

连接建立、参数校验通过后第一条消息。

{
    "code": 200,
    "message": "端口扫描开始",
    "address": "xxx",
    "total": 10,
    "timeout": 1.0,
    "start_time": 1723456789,
    "ports": [80, 443, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
}

2. `scan_item` – 单端口扫描结果（循环推送）

每扫描完一个端口推送一次。

{
    "port": 80,
    "is_open": true,
    "service": "HTTP",
    "port_cost_sec": 0.12
}

3. `scan_progress` – 实时进度

每扫描一个端口更新一次进度百分比、已完成数量、耗时。

{
    "message": "扫描进度",
    "finished": 5,
    "percent": 41.67,
    "execution_time_sec": 4.23
}

4. `scan_finish` – 扫描结束

全部端口扫描完毕，最终统计结果。

{
    "message": "端口扫描全部完成",
    "open_count": 1,
    "close_count": 11,
    "end_time": 1723456799,
    "cost_time": 11.23
}

端口扫描+

端口扫描接口文档（SSE 流式接口）

一、接口概述

二、请求信息

三、请求参数（GET）

四、SSE 推送事件列表

1. `scan_start` – 扫描开始

2. `scan_item` – 单端口扫描结果（循环推送）

3. `scan_progress` – 实时进度

4. `scan_finish` – 扫描结束

请求参数

请求示例代码

返回响应

端口扫描+

端口扫描接口文档（SSE 流式接口）#

一、接口概述#

二、请求信息#

三、请求参数（GET）#

四、SSE 推送事件列表#

1. scan_start – 扫描开始#

2. scan_item – 单端口扫描结果（循环推送）#

3. scan_progress – 实时进度#

4. scan_finish – 扫描结束#

请求参数

请求示例代码

返回响应

端口扫描接口文档（SSE 流式接口）

一、接口概述

二、请求信息

三、请求参数（GET）

四、SSE 推送事件列表

1. `scan_start` – 扫描开始

2. `scan_item` – 单端口扫描结果（循环推送）

3. `scan_progress` – 实时进度

4. `scan_finish` – 扫描结束