Files
fscan/web/api/scan.go
ZacharyZcR 71b92d4408 feat: v2.1.0 核心重构与功能增强
## 架构重构
- 全局变量消除,迁移至 Config/State 对象
- SMB 插件融合(smb/smb2/smbghost/smbinfo)
- 服务探测重构,实现 Nmap 风格 fallback 机制
- 输出系统重构,TXT 实时刷盘 + 双写机制
- i18n 框架升级至 go-i18n

## 性能优化
- 正则表达式预编译
- 内存优化 map[string]struct{}
- 并发指纹匹配
- SOCKS5 连接复用
- 滑动窗口调度 + 自适应线程池

## 新功能
- Web 管理界面
- 多格式 POC 适配(xray/afrog)
- 增强指纹库(3139条)
- Favicon hash 指纹识别
- 插件选择性编译(Build Tags)
- fscan-lab 靶场环境
- 默认端口扩展(62→133)

## 构建系统
- 添加 no_local tag 支持排除本地插件
- 多版本构建:fscan/fscan-nolocal/fscan-web
- CI 添加 snapshot 模式支持仅测试构建

## Bug 修复
- 修复 120+ 个问题,包括 RDP panic、批量扫描漏报、
  JSON 输出格式、Redis 检测、Context 超时等

## 测试增强
- 单元测试覆盖率 74-100%
- 并发安全测试
- 集成测试(Web/端口/服务/SSH/ICMP)
2026-01-11 20:16:23 +08:00

281 lines
6.4 KiB
Go

//go:build web
package api
import (
"encoding/json"
"net/http"
"sync"
"sync/atomic"
"time"
"github.com/shadow1ng/fscan/common"
"github.com/shadow1ng/fscan/core"
"github.com/shadow1ng/fscan/web/ws"
)
// ScanState 扫描状态
type ScanState int32
const (
ScanStateIdle ScanState = iota
ScanStateRunning
ScanStateStopping
)
// ScanRequest 扫描请求
type ScanRequest struct {
// 目标
Host string `json:"host"`
Ports string `json:"ports"`
ExcludeHosts string `json:"exclude_hosts"`
ExcludePorts string `json:"exclude_ports"`
// 扫描控制
ScanMode string `json:"scan_mode"`
ThreadNum int `json:"thread_num"`
Timeout int `json:"timeout"`
ModuleThreadNum int `json:"module_thread_num"`
DisablePing bool `json:"disable_ping"`
DisableBrute bool `json:"disable_brute"`
AliveOnly bool `json:"alive_only"`
// 认证
Username string `json:"username"`
Password string `json:"password"`
Domain string `json:"domain"`
// POC
PocPath string `json:"poc_path"`
PocName string `json:"poc_name"`
PocFull bool `json:"poc_full"`
DisablePoc bool `json:"disable_poc"`
}
// ScanStatus 扫描状态响应
type ScanStatus struct {
State string `json:"state"`
StartTime time.Time `json:"start_time,omitempty"`
Progress float64 `json:"progress"`
Stats ScanStats `json:"stats"`
}
// ScanStats 扫描统计
type ScanStats struct {
HostsScanned int `json:"hosts_scanned"`
PortsScanned int `json:"ports_scanned"`
ServicesFound int `json:"services_found"`
VulnsFound int `json:"vulns_found"`
}
// ScanHandler 扫描处理器
type ScanHandler struct {
hub *ws.Hub
state int32
startTime time.Time
stopChan chan struct{}
mu sync.RWMutex
results *ResultStore
}
// NewScanHandler 创建扫描处理器
func NewScanHandler(hub *ws.Hub) *ScanHandler {
return &ScanHandler{
hub: hub,
results: globalResultStore,
}
}
// Start 启动扫描
func (h *ScanHandler) Start(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
// 检查是否已在扫描
if !atomic.CompareAndSwapInt32(&h.state, int32(ScanStateIdle), int32(ScanStateRunning)) {
writeJSON(w, http.StatusConflict, map[string]string{
"error": "scan already running",
})
return
}
// 解析请求
var req ScanRequest
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
atomic.StoreInt32(&h.state, int32(ScanStateIdle))
writeJSON(w, http.StatusBadRequest, map[string]string{
"error": "invalid request: " + err.Error(),
})
return
}
// 验证必填参数
if req.Host == "" {
atomic.StoreInt32(&h.state, int32(ScanStateIdle))
writeJSON(w, http.StatusBadRequest, map[string]string{
"error": "host is required",
})
return
}
h.mu.Lock()
h.startTime = time.Now()
h.stopChan = make(chan struct{})
h.mu.Unlock()
// 清空旧结果
h.results.Clear()
// 广播扫描开始
h.hub.Broadcast(ws.MsgScanStarted, map[string]interface{}{
"host": req.Host,
"start_time": h.startTime,
})
// 异步执行扫描
go h.runScan(req)
writeJSON(w, http.StatusOK, map[string]interface{}{
"status": "started",
"start_time": h.startTime,
})
}
// runScan 执行扫描
func (h *ScanHandler) runScan(req ScanRequest) {
defer func() {
common.ClearResultCallback() // 清除回调
atomic.StoreInt32(&h.state, int32(ScanStateIdle))
h.hub.Broadcast(ws.MsgScanCompleted, map[string]interface{}{
"duration": time.Since(h.startTime).Seconds(),
"stats": h.results.Stats(),
})
}()
// 构建HostInfo
info := common.HostInfo{
Host: req.Host,
}
// 构建FlagVars
fv := &common.FlagVars{}
fv.Ports = req.Ports
if fv.Ports == "" {
fv.Ports = "21,22,23,25,80,110,135,139,143,443,445,465,587,993,995,1433,1521,3306,3389,5432,5900,6379,8080,8443,9000,27017"
}
fv.ExcludeHosts = req.ExcludeHosts
fv.ExcludePorts = req.ExcludePorts
fv.ScanMode = req.ScanMode
if fv.ScanMode == "" {
fv.ScanMode = "all"
}
fv.ThreadNum = req.ThreadNum
if fv.ThreadNum == 0 {
fv.ThreadNum = 600
}
fv.TimeoutSec = int64(req.Timeout)
if fv.TimeoutSec == 0 {
fv.TimeoutSec = 3
}
fv.ModuleThreadNum = req.ModuleThreadNum
if fv.ModuleThreadNum == 0 {
fv.ModuleThreadNum = 20
}
fv.DisablePing = req.DisablePing
fv.DisableBrute = req.DisableBrute
fv.AliveOnly = req.AliveOnly
fv.Username = req.Username
fv.Password = req.Password
fv.Domain = req.Domain
fv.PocPath = req.PocPath
fv.PocName = req.PocName
fv.PocFull = req.PocFull
fv.DisablePocScan = req.DisablePoc
fv.DisableSave = true // Web模式不保存到文件
fv.Silent = true // 静默模式
// 构建Config
config := common.BuildConfigFromFlags(fv)
state := common.NewState()
// 设置WebSocket结果回调
common.SetResultCallback(func(result interface{}) {
item := h.results.Add(result)
if item != nil {
h.hub.Broadcast(ws.MsgScanResult, item)
}
})
// 执行扫描
core.RunScan(info, config, state)
}
// Stop 停止扫描
func (h *ScanHandler) Stop(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
if atomic.LoadInt32(&h.state) != int32(ScanStateRunning) {
writeJSON(w, http.StatusBadRequest, map[string]string{
"error": "no scan running",
})
return
}
atomic.StoreInt32(&h.state, int32(ScanStateStopping))
h.mu.Lock()
if h.stopChan != nil {
close(h.stopChan)
}
h.mu.Unlock()
writeJSON(w, http.StatusOK, map[string]string{
"status": "stopping",
})
}
// Status 获取扫描状态
func (h *ScanHandler) Status(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodGet {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
state := atomic.LoadInt32(&h.state)
stateStr := "idle"
switch ScanState(state) {
case ScanStateRunning:
stateStr = "running"
case ScanStateStopping:
stateStr = "stopping"
}
h.mu.RLock()
startTime := h.startTime
h.mu.RUnlock()
// 从 ProgressManager 获取进度百分比
progress := common.GetProgressPercent()
status := ScanStatus{
State: stateStr,
StartTime: startTime,
Progress: progress,
Stats: h.results.Stats(),
}
writeJSON(w, http.StatusOK, status)
}
// writeJSON 写入JSON响应
func writeJSON(w http.ResponseWriter, status int, data interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(status)
json.NewEncoder(w).Encode(data)
}