mirror of
https://github.com/shadow1ng/fscan.git
synced 2026-02-15 13:19:17 +08:00
## 架构重构
- 全局变量消除,迁移至 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)
281 lines
6.4 KiB
Go
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)
|
|
}
|