FOFA 共享资产测绘网关 · 客户端接入指南

公共网关：https://fofa.suuu.de5.net ｜协议：HTTPS / JSON ｜健康检查（免鉴权）：GET /health

● 检测中… v3.2.7 High-Availability 账号池：— 出口代理：—

—

FREE 账号池（可用）

—

出口代理通道（可用）

50/s

单 IP QPS 上限

1. 快速接入（30 秒上手）

# 节点存活检查
curl -sS https://fofa.suuu.de5.net/health

# 发起资产测绘（推荐 GET + URL 编码）
curl -sS -H "X-API-Key: ***" \
  --get \
  --data-urlencode 'q=app="nginx" && country="US"' \
  --data-urlencode 'page=1' --data-urlencode 'size=10' \
  "https://fofa.suuu.de5.net/api/search"

2. 鉴权传参规范（任选其一）

方式	写法	说明
HTTP Header（推荐）	X-API-Key: ***	标准 Header 传参
Bearer Token	Authorization: Bearer ***	兼容 OAuth 客户端
URL Query	?api_key=***	脚本 / 浏览器快速请求

单次成功检索扣 1 次今日配额；失败与网络重试不计费。管理员可向网关申请子 Key（配额可控）。常见错误：401 令牌无效｜ 403 今日额度耗尽｜ 429 触发 QPS 限流｜ 502 上游熔断换线中。

3. 检索语法速查

分类	示例
中间件指纹	app="nginx" / app="Apache-Tomcat"
正文特征	body="ThinkPHP"
页面标题	title="Swagger UI"
未授权服务	port="6379" && protocol="redis"
云原生暴露面	port="2375" && app="docker"
地区 + 状态码	country="US" && status_code="200"

4. Python 最小调用

import requests
r = requests.post("https://fofa.suuu.de5.net/api/search",
    json={"query": 'app="nginx"', "page": 1, "size": 10},
    headers={"X-API-Key": "***"}, timeout=30).json()
if r.get("code") == 0:
    for a in r["assets"]:
        print(f"[{a['protocol']}] {a['host']} - {a['country']} ({a['title']})")