Skip to content

SKILL.md

Latest commit

 

History

History
304 lines (238 loc) · 9.65 KB

SKILL.md

File metadata and controls

304 lines (238 loc) · 9.65 KB
name fscan-agent
description 使用 fscan 进行网络扫描和安全评估。当用户要求扫描网段、探测主机存活、发现开放端口、识别服务、检测漏洞或弱口令时使用。支持 NDJSON 结构化输出，适合 AI agent 管道消费。
argument-hint <目标IP/网段> [附加参数]
allowed-tools Bash, Read, Agent

Fscan AI Agent Skill

工具概述

Fscan 是一款内网综合扫描工具，功能包括：

  • 主机存活探测（ICMP / TCP）
  • 端口扫描与服务识别
  • 漏洞检测（MS17-010、Redis 未授权等）
  • 弱口令爆破（SSH、SMB、MySQL、MSSQL、FTP、RDP 等）
  • Web 指纹识别与 POC 扫描
  • NetBIOS / SMB 信息收集
  • 本地信息收集（杀软检测、系统信息等）

二进制路径：当前项目编译产物 fscan_cli，或系统 PATH 中的 fscan。

调用格式

# AI agent 标准用法：NDJSON 输出，无人类日志干扰
fscan -h <目标> -silent [其他参数]

# 解析输出
fscan -h 192.168.1.0/24 -silent | jq 'select(.type=="VULN")'

核心参数

目标指定

参数 说明 示例
-h 目标主机（IP / CIDR / 范围） -h 192.168.1.0/24 -h 10.0.0.1-10.0.0.100
-hf 从文件读取目标 -hf targets.txt
-p 指定端口（逗号/范围） -p 22,80,443,445,3306 -p 1-1000
-ep 排除端口 -ep 25,110
-eh 排除主机 -eh 192.168.1.1
-u 指定 URL（Web 扫描） -u https://example.com
-uf URL 文件 -uf urls.txt

扫描控制

参数 说明 默认值
-m 扫描模式 all
-t 端口扫描线程数 600
-mt 模块线程数 20
-time 连接超时（秒） 3
-gt 全局超时（秒） 180
-np 跳过存活检测 false
-ntp 禁用 TCP 补充探测 false
-ao 仅存活检测 false
-nobr 禁用暴力破解 false
-full 全量 POC 扫描 false
-max-retries 最大重试次数 1

认证

参数 说明
-user 用户名
-pwd 密码
-usera 追加用户名
-pwda 追加密码，支持逗号或空格分隔多个值
-userf 用户名字典文件
-pwdf 密码字典文件
-domain 域名（SMB/WMI）
-sshkey SSH 私钥文件
-hash / -hashf NTLM Hash / Hash 文件

代理

参数 说明
-socks5 SOCKS5 代理 (127.0.0.1:1080)
-proxy HTTP 代理 (http://127.0.0.1:8080)
-iface 指定本地网卡 IP（VPN 场景）

输出

参数 说明
-silent 静默模式：stdout 仅输出 NDJSON
-o 输出文件路径（默认 result.txt）
-f 输出格式：txt / json / csv
-no 禁用文件保存
-debug 调试模式：日志写入 fscan_debug.log
-log 日志级别（debug / info / base / error）

扫描模式 -m 的取值

值 说明
all 全部扫描（默认）
icmp 仅 ICMP 存活检测
插件名 仅运行指定插件（如 ssh、smb、ms17010、webtitle）

服务插件列表

插件 默认端口 功能
ftp 21 FTP 弱口令
ssh 22 SSH 弱口令
telnet 23 Telnet 弱口令
smtp 25 SMTP 弱口令
findnet 135 RPC 网络信息发现（NetInfo）
netbios 139 NetBIOS 信息收集
smb 445 SMB 弱口令
ms17010 445 MS17-010 永恒之蓝检测
ldap 389 LDAP 弱口令
mssql 1433 MSSQL 弱口令
oracle 1521 Oracle 弱口令
mysql 3306 MySQL 弱口令
rdp 3389 RDP 弱口令 + 系统信息
postgresql 5432 PostgreSQL 弱口令
vnc 5900 VNC 弱口令
redis 6379 Redis 未授权 + 弱口令
elasticsearch 9200 ES 未授权
mongodb 27017 MongoDB 未授权 + 弱口令
memcached 11211 Memcached 未授权
kafka 9092 Kafka 未授权
activemq 61616 ActiveMQ 弱口令
rabbitmq 5672 RabbitMQ 弱口令
cassandra 9042 Cassandra 弱口令
neo4j 7687 Neo4j 弱口令
rsync 873 Rsync 未授权
webtitle 80/443 Web 标题 + 指纹识别
webpoc 80/443 Web 漏洞 POC

本地插件（-local）

fscan -local avdetect    # 杀软检测
fscan -local systeminfo  # 系统信息收集
fscan -local envinfo     # 环境变量信息
fscan -local dcinfo      # 域控信息
fscan -local fileinfo    # 敏感文件搜索

NDJSON 输出 Schema（-silent 模式）

每行一个 JSON 对象，所有字段定义：

字段 类型 出现条件 说明
type string 必有 HOST / PORT / SERVICE / VULN
target string 必有 原始目标 host 或 host:port
status string 必有 状态描述
host string 必有 IP 地址
port int PORT/SERVICE/VULN 端口号
service string SERVICE/VULN 服务名（ssh, smb, http 等）
protocol string HOST/SERVICE 协议（ICMP, TCP, http, https）
banner string SERVICE 服务 Banner
title string SERVICE (web) 网页标题
url string SERVICE (web) 完整 URL
vulnerability string VULN 漏洞名称
username string VULN (弱口令) 用户名
password string VULN (弱口令) 密码
plugin string SERVICE/VULN 产生结果的插件名
version string SERVICE 服务版本号
os string SERVICE 操作系统信息

输出示例

{"type":"HOST","target":"192.168.1.5","status":"alive","host":"192.168.1.5","protocol":"ICMP"}
{"type":"PORT","target":"192.168.1.5","status":"open","host":"192.168.1.5","port":22}
{"type":"PORT","target":"192.168.1.5","status":"open","host":"192.168.1.5","port":445}
{"type":"SERVICE","target":"192.168.1.5:22","status":"identified","host":"192.168.1.5","port":22,"service":"ssh","banner":"SSH-2.0-OpenSSH_8.9p1","version":"8.9p1","plugin":"portscan"}
{"type":"SERVICE","target":"192.168.1.5:80","status":"web","host":"192.168.1.5","port":80,"service":"http","protocol":"http","url":"http://192.168.1.5:80","title":"Welcome","plugin":"webtitle"}
{"type":"VULN","target":"192.168.1.5:445","status":"MS17-010 (Windows Server 2012 R2 Standard 9600)","host":"192.168.1.5","port":445,"vulnerability":"MS17-010","service":"smb","plugin":"ms17010"}
{"type":"VULN","target":"192.168.1.5:22","status":"weak_credential: root:123456","host":"192.168.1.5","port":22,"service":"ssh","username":"root","password":"123456","plugin":"ssh"}
{"type":"VULN","target":"192.168.1.5:6379","status":"Redis unauthorized","host":"192.168.1.5","port":6379,"vulnerability":"Redis unauthorized access","service":"redis","plugin":"redis"}

结果产出顺序

  1. HOST — 存活探测阶段
  2. PORT — 端口扫描阶段（与 SERVICE 可能交错）
  3. SERVICE — 服务识别阶段
  4. VULN — 漏洞/弱口令检测阶段

同一 host:port 可产生多条结果（PORT + SERVICE + VULN）。

常用场景参数组合

全网段快速扫描

fscan -h 192.168.1.0/24 -silent

跳过存活检测直接扫端口（目标明确时）

fscan -h 192.168.1.0/24 -silent -np

指定端口精确扫描

fscan -h 10.0.0.0/24 -silent -p 22,80,443,445,3389,3306,6379

仅存活探测

fscan -h 172.16.0.0/16 -silent -m icmp

低速隐蔽扫描

fscan -h 192.168.1.0/24 -silent -t 30 -time 5

通过 SOCKS5 代理扫描内网

fscan -h 10.0.0.0/24 -silent -socks5 127.0.0.1:1080

仅做弱口令检测

fscan -h 192.168.1.10 -silent -m ssh -user root -pwdf /path/to/passwords.txt

Web 目标扫描

fscan -u https://target.com -silent -full

多目标文件批量扫描

fscan -hf targets.txt -silent -o results.json -f json

带调试日志的排障扫描

# NDJSON 到 stdout，debug 日志到文件，互不干扰
fscan -h 192.168.1.0/24 -silent -debug
# 事后查看：cat fscan_debug.log

AI Agent 结果处理

Python 管道消费

import json, subprocess

proc = subprocess.Popen(
    ["fscan", "-h", "192.168.1.0/24", "-silent"],
    stdout=subprocess.PIPE, text=True
)

hosts, services, vulns = [], [], []
for line in proc.stdout:
    r = json.loads(line)
    if r["type"] == "HOST":
        hosts.append(r["host"])
    elif r["type"] == "SERVICE":
        services.append(r)
    elif r["type"] == "VULN":
        vulns.append(r)

proc.wait()

jq 过滤

# 提取所有弱口令
fscan -h 10.0.0.0/24 -silent | jq -r 'select(.username != null) | "\(.host):\(.port) \(.service) \(.username):\(.password)"'

# 提取所有漏洞
fscan -h 10.0.0.0/24 -silent | jq -r 'select(.type=="VULN") | "\(.host):\(.port) \(.vulnerability)"'

# 提取 Web 服务
fscan -h 10.0.0.0/24 -silent | jq -r 'select(.url != null) | "\(.url) \(.title)"'

# 统计开放端口
fscan -h 10.0.0.0/24 -silent | jq -r 'select(.type=="PORT") | .port' | sort -n | uniq -c | sort -rn

注意事项

  • -silent 抑制所有人类可读日志，stdout 仅输出 NDJSON
  • 空字段不出现在 JSON 中（omitempty）
  • 进程退出码 0 正常完成，非 0 表示参数错误或初始化失败
  • -silent 和 -debug 可同时使用，互不干扰
  • SOCKS5 代理下 fscan 信任协议层连接结果，不做额外深度验证
  • 扫描大网段时线程数会自动调整，资源耗尽时自适应降级
  • 默认超时 3 秒，防火墙 drop 的端口会静默超时，不计入失败率