Files
fscan/plugins/services/findnet.go
T
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

358 lines
8.4 KiB
Go

//go:build plugin_findnet || !plugin_selective
package services
import (
"bytes"
"context"
"encoding/hex"
"fmt"
"net"
"regexp"
"strconv"
"strings"
"time"
"unicode"
"github.com/shadow1ng/fscan/common"
"github.com/shadow1ng/fscan/plugins"
)
// 预编译正则表达式
var validHostnameRegex = regexp.MustCompile(`^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$`)
// FindNetPlugin Windows网络发现插件 - 通过RPC端点映射服务收集网络信息
type FindNetPlugin struct {
plugins.BasePlugin
}
// NewFindNetPlugin 创建FindNet插件
func NewFindNetPlugin() *FindNetPlugin {
return &FindNetPlugin{
BasePlugin: plugins.NewBasePlugin("findnet"),
}
}
// GetPorts 实现Plugin接口
// Scan 执行FindNet扫描 - Windows网络信息收集
func (p *FindNetPlugin) Scan(ctx context.Context, info *common.HostInfo, config *common.Config, state *common.State) *ScanResult {
target := info.Target()
// 检查是否为RPC端口
if info.Port != 135 {
return &ScanResult{
Success: false,
Service: "findnet",
Error: fmt.Errorf("FindNet插件仅支持RPC端口135"),
}
}
// WrapperTcpWithTimeout内部已包含发包限制检查
conn, err := common.WrapperTcpWithTimeout("tcp", target, config.Timeout)
if err != nil {
state.IncrementTCPFailedPacketCount()
return &ScanResult{
Success: false,
Service: "findnet",
Error: fmt.Errorf("连接RPC端口失败: %w", err),
}
}
defer func() { _ = conn.Close() }()
// 设置超时
_ = conn.SetDeadline(time.Now().Add(config.Timeout))
// 执行RPC网络发现
networkInfo, err := p.performNetworkDiscovery(conn)
if err != nil {
state.IncrementTCPFailedPacketCount()
return &ScanResult{
Success: false,
Service: "findnet",
Error: err,
}
}
state.IncrementTCPSuccessPacketCount()
// 记录发现的网络信息 (简洁单行格式,方便复制)
if networkInfo.Valid {
common.LogSuccess(fmt.Sprintf("NetInfo %s %s", target, networkInfo.OneLine()))
}
return &ScanResult{
Success: networkInfo.Valid,
Service: "findnet",
Banner: networkInfo.Summary(),
}
}
// NetworkInfo 网络信息结构
type NetworkInfo struct {
Valid bool
Hostname string
IPv4Addrs []string
IPv6Addrs []string
}
// OneLine 返回单行格式(便于复制)
func (ni *NetworkInfo) OneLine() string {
if !ni.Valid {
return ""
}
var parts []string
if ni.Hostname != "" {
parts = append(parts, fmt.Sprintf("[%s]", ni.Hostname))
}
if len(ni.IPv4Addrs) > 0 {
parts = append(parts, strings.Join(ni.IPv4Addrs, ","))
}
return strings.Join(parts, " ")
}
// Summary 返回网络信息摘要
func (ni *NetworkInfo) Summary() string {
if !ni.Valid {
return "网络发现失败"
}
var parts []string
if ni.Hostname != "" {
parts = append(parts, fmt.Sprintf("主机名: %s", ni.Hostname))
}
if len(ni.IPv4Addrs) > 0 {
parts = append(parts, fmt.Sprintf("IPv4: %d个", len(ni.IPv4Addrs)))
}
if len(ni.IPv6Addrs) > 0 {
parts = append(parts, fmt.Sprintf("IPv6: %d个", len(ni.IPv6Addrs)))
}
if len(parts) == 0 {
return "网络信息收集完成"
}
return strings.Join(parts, ", ")
}
// TreeFormat 返回tree格式的详细网络信息
func (ni *NetworkInfo) TreeFormat() string {
if !ni.Valid {
return "网络发现失败"
}
var result strings.Builder
// 主机名信息
if ni.Hostname != "" {
result.WriteString(fmt.Sprintf("主机名: %s\n", ni.Hostname))
}
// IPv4地址树形显示
if len(ni.IPv4Addrs) > 0 {
result.WriteString(fmt.Sprintf("IPv4接口 (%d个):\n", len(ni.IPv4Addrs)))
for i, addr := range ni.IPv4Addrs {
if i == len(ni.IPv4Addrs)-1 {
result.WriteString(fmt.Sprintf(" └── %s\n", addr))
} else {
result.WriteString(fmt.Sprintf(" ├── %s\n", addr))
}
}
}
// IPv6地址树形显示
if len(ni.IPv6Addrs) > 0 {
result.WriteString(fmt.Sprintf("IPv6接口 (%d个):\n", len(ni.IPv6Addrs)))
for i, addr := range ni.IPv6Addrs {
if i == len(ni.IPv6Addrs)-1 {
result.WriteString(fmt.Sprintf(" └── %s\n", addr))
} else {
result.WriteString(fmt.Sprintf(" ├── %s\n", addr))
}
}
}
return strings.TrimRight(result.String(), "\n")
}
// RPC数据包定义
var (
rpcBuffer1, _ = hex.DecodeString("05000b03100000004800000001000000b810b810000000000100000000000100c4fefc9960521b10bbcb00aa0021347a00000000045d888aeb1cc9119fe808002b10486002000000")
rpcBuffer2, _ = hex.DecodeString("050000031000000018000000010000000000000000000500")
rpcBuffer3, _ = hex.DecodeString("0900ffff0000")
)
// performNetworkDiscovery 执行RPC网络发现
func (p *FindNetPlugin) performNetworkDiscovery(conn net.Conn) (*NetworkInfo, error) {
// 发送第一个RPC请求
if _, err := conn.Write(rpcBuffer1); err != nil {
return nil, fmt.Errorf("发送RPC请求1失败: %w", err)
}
// 读取响应
reply := make([]byte, 4096)
if _, err := conn.Read(reply); err != nil {
return nil, fmt.Errorf("读取RPC响应1失败: %w", err)
}
// 发送第二个RPC请求
if _, err := conn.Write(rpcBuffer2); err != nil {
return nil, fmt.Errorf("发送RPC请求2失败: %w", err)
}
// 读取网络信息响应
n, err := conn.Read(reply)
if err != nil || n < 42 {
return nil, fmt.Errorf("读取RPC响应2失败: %w", err)
}
// 解析响应数据
responseData := reply[42:]
// 查找响应结束标记
for i := 0; i < len(responseData)-5; i++ {
if bytes.Equal(responseData[i:i+6], rpcBuffer3) {
responseData = responseData[:i-4]
break
}
}
// 解析网络信息
return p.parseNetworkInfo(responseData), nil
}
// parseNetworkInfo 解析RPC响应中的网络信息
func (p *FindNetPlugin) parseNetworkInfo(data []byte) *NetworkInfo {
info := &NetworkInfo{
Valid: false,
IPv4Addrs: []string{},
IPv6Addrs: []string{},
}
encodedStr := hex.EncodeToString(data)
// 解析主机名
var hostName string
for i := 0; i < len(encodedStr)-4; i += 4 {
if encodedStr[i:i+4] == "0000" {
break
}
hostName += encodedStr[i : i+4]
}
if hostName != "" {
name := p.hexUnicodeToString(hostName)
if p.isValidHostname(name) {
info.Hostname = name
info.Valid = true
}
}
// 用于去重的地址集合
seenAddresses := make(map[string]struct{})
// 解析网络信息
netInfo := strings.ReplaceAll(encodedStr, "0700", "")
segments := strings.Split(netInfo, "000000")
// 处理每个网络地址段
for _, segment := range segments {
if len(segment) == 0 {
continue
}
if len(segment)%2 != 0 {
segment = segment + "0"
}
addrBytes, err := hex.DecodeString(segment)
if err != nil {
continue
}
addr := p.cleanAndValidateAddress(addrBytes)
if _, exists := seenAddresses[addr]; addr != "" && !exists {
seenAddresses[addr] = struct{}{}
info.Valid = true
if strings.Contains(addr, ":") {
info.IPv6Addrs = append(info.IPv6Addrs, addr)
} else if net.ParseIP(addr) != nil {
info.IPv4Addrs = append(info.IPv4Addrs, addr)
}
}
}
return info
}
// hexUnicodeToString 将十六进制Unicode字符串转换为普通字符串
func (p *FindNetPlugin) hexUnicodeToString(src string) string {
if len(src)%4 != 0 {
src += strings.Repeat("0", 4-len(src)%4)
}
var result strings.Builder
for i := 0; i < len(src); i += 4 {
if i+4 > len(src) {
break
}
charCode, err := strconv.ParseInt(src[i+2:i+4]+src[i:i+2], 16, 32)
if err != nil {
continue
}
if unicode.IsPrint(rune(charCode)) {
result.WriteRune(rune(charCode))
}
}
return result.String()
}
// isValidHostname 检查是否为有效主机名
func (p *FindNetPlugin) isValidHostname(name string) bool {
if len(name) == 0 || len(name) > 255 {
return false
}
return validHostnameRegex.MatchString(name)
}
// isValidNetworkAddress 检查是否为有效网络地址
func (p *FindNetPlugin) isValidNetworkAddress(addr string) bool {
// 检查是否为IPv4或IPv6
if ip := net.ParseIP(addr); ip != nil {
return true
}
// 检查是否为有效主机名
return p.isValidHostname(addr)
}
// cleanAndValidateAddress 清理并验证地址
func (p *FindNetPlugin) cleanAndValidateAddress(data []byte) string {
// 转换为字符串并清理不可打印字符
addr := strings.Map(func(r rune) rune {
if unicode.IsPrint(r) {
return r
}
return -1
}, string(data))
// 移除前后空白
addr = strings.TrimSpace(addr)
if p.isValidNetworkAddress(addr) {
return addr
}
return ""
}
// init 自动注册插件
func init() {
// 使用高效注册方式:直接传递端口信息,避免实例创建
RegisterPluginWithPorts("findnet", func() Plugin {
return NewFindNetPlugin()
}, []int{135})
}