用 Go 编写的 Spip 网络传感器
Spip 是一个用 Go 编写的 Linux 低交互网络蜜罐传感器。它接受主机重定向到它的任意端口上的 TCP 连接,无论是明文还是 TLS,只回复刚好足以让客户端发送下一条消息的内容,并将每次交互记录为一条带有 ECS 字段名的 JSON 记录,可直接用于 SIEM 或数据湖。可选的 UDP 捕获会记录数据报,且从不回复它们。
HoneyLabs 运行 Spip 来收集发布在 honeylabs.net 上的数据。
前提条件:
iptables 以及安装重定向规则所需的 root 权限git clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
要设置 observer.version 和 agent.version 中报告的版本(默认为 dev),请添加 -ldflags "-X main.version=v1.2.3"。
sudo ./scripts/initial_setup.sh
参见下方的初始设置助手。
config.toml
最小化的 config.toml:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
可选配置键:
cert_path / key_path:当两者都设置时启用 TLS。相对路径相对于配置文件所在目录解析。log_file:将记录追加到此文件而不是 stdout。参见下方的日志输出。[loom]:同时通过 HTTP 发送记录。参见下方的 Loom。read_timeout_seconds / write_timeout_seconds:每个连接的空闲读取超时和写入超时。rate_limit_per_second / rate_limit_burst:对新 TCP 连接的速率限制,由所有来源共享。超过限制的连接会在未读取的情况下被关闭。community_id_seed:用于 Community ID v1 流哈希的可选 16 位种子(省略或设为 0 表示使用默认值)。capture_client_hello:设为 false 以省略 tls.client.hello_hex。参见指纹识别。ignore_sources:其连接和数据报在读取任何内容之前就被关闭或丢弃的地址或网络,因此它们永远不会被记录、指纹识别或发送。支持裸地址和 CIDR,IPv4 或 IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]。租用主机上的蜜罐会被该主机自身的监控轮询,统计这些抓取会扭曲端口排名和扫描器计数。无法解析的条目会阻止 agent 启动,因为这里的拼写错误会静默记录你本以为已被丢弃的流量。丢弃按来源计数,并每小时及在关闭时记录到日志中。udp_enabled 和 udp_* 键:参见 UDP 捕获。如果这些运行时调优字段被省略或设为 0,Spip 会应用以下默认值:
read_timeout_seconds:30write_timeout_seconds:10rate_limit_per_second:20rate_limit_burst:50000sudo iptables -t nat -F
sudo iptables -t nat -A PREROUTING -p tcp --dport 22 -j RETURN
sudo iptables -t nat -A PREROUTING -p tcp -j REDIRECT --to-port 8080
第一条命令会清空整个 nat 表。如果主机自身已有 NAT 规则,请省略该命令。使用 ip6tables 的同样两条规则可覆盖 IPv6。Spip 从内核的连接跟踪中读取每个连接的原始目标地址,并将其记录为 destination.ip 和 destination.port。
./spip-agent -config config.toml
-config 是唯一的标志,默认值为工作目录中的 config.toml。SIGINT 或 SIGTERM 会停止监听器,最多等待 15 秒以处理打开的连接,并将任何待处理的 Loom 批次写入 spool,给予其 5 秒的发送时间;其余部分将在下次启动时发送。
Spip 根据原始目标端口选择响应器。每个响应器只发送足够让客户端发送下一条消息的内容:凭据、命令或邮件信封。
| 端口 | 响应 |
|---|---|
| 23, 2323 | Telnet 选项协商和 login: 提示,然后是 Password:,接着是 Login incorrect 并关闭 |
| 21, 990 | FTP 问候,第一行后请求密码,然后是 530 Login incorrect. 并关闭 |
| 25, 465, 587 | SMTP 问候,对前三行回复 250,对第四行回复 354,然后关闭。不转发任何内容,也不建立出站连接。 |
| 110, 995 | POP3 问候,第一行后回复 +OK,第二行后回复 -ERR invalid login,然后关闭 |
| 143, 993 | IMAP 问候,然后回复 * BAD Login failed 并关闭 |
| 6379, 6380, 或任何看起来像 Redis 命令的载荷 | 对 PING 回复 +PONG,对其他所有内容回复 +OK |
| 任何其他端口 | 对 HTTP 请求回复 HTTP/1.1 200 OK,正文为客户端 IP 地址;对其他内容回复裸 IP 地址 |
发送 SSH-2.0 但没有密钥交换消息的客户端会收到横幅 SSH-2.0-spip,Spip 最多等待 2 秒以进行密钥交换,以便计算客户端指纹。
telnet、FTP、SMTP、POP3 和 IMAP 问候在连接时发送。启用 TLS 时,Spip 首先读取一个字节以区分 TLS 和纯文本,因此这些问候只有在客户端发送内容后才会发出。
Spip 将 ECS 日志写入单个本地目标,也可以将相同的记录发送到 Loom 服务器:
| 目标 | 配置 | 行为 |
|---|---|---|
| 本地 | log_file | 省略或为空:stdout。设置为路径:记录追加到该文件。始终开启。 |
| Loom | [loom] 且 enabled = true | 可选。相同的记录会被批处理并 POST 到你的 Loom 摄取 URL,同时输出到本地。 |
本地输出还包含代理自身的日志行,例如每小时丢弃计数和警告,格式为 {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}。只有连接记录会发送到 Loom。启动消息发送到 stderr。
Spip 将每条记录写为一行 JSON,使用 ECS 字段名,仅使用它能够从连接本身推导出的内容(不进行 ASN 或地理位置补充)。一个发送多条消息的连接会为每条消息生成一条记录,所有记录都具有相同的 event.id。字段包括:
@timestamp:记录的 RFC 3339 时间,精确到整秒event.id:每连接的会话标识符;event.sequence:记录在会话中的位置,从 1 开始event.duration:自连接打开以来的纳秒数event.module、event.dataset(spip.tcp 或 spip.udp)、event.kind、event.category、event.type:供 SIEM 选择 Spip 的记录observer.vendor、observer.product、observer.type、observer.version、agent.type、agent.versionobserver.hostname、observer.id 和 host.name:配置中的 agent namesource.ip、source.port、destination.ip、destination.portsource.bytes、destination.bytes、network.bytes:会话到目前为止接收和发送的字节数network.transport(tcp 或 udp)和 network.protocol(tls、dns、netbios 或 quic),在已知时提供http.request.method、http.request.headers、http.request.body.content、http.request.body.bytes、url.path、url.domain、url.port:当载荷为 HTTP 请求时user_agent.original:在可用时提供event.summary:以文本形式表示的载荷,适用于非 HTTP 请求的载荷event.original_payload_hex:以十六进制表示的原始载荷,始终保留network.community_id、tls.client.*、ssh.client.hash.hassh 和 http.request.hash.akin。示例记录,已格式化:
{
"@timestamp": "2026-10-12T09:14:03Z",
"agent": {"type": "spip", "version": "dev"},
"destination": {"bytes": 78, "ip": "203.0.113.10", "port": 80},
"event": {
"category": ["network", "intrusion_detection"],
"dataset": "spip.tcp",
"duration": 100000000,
"id": "3f0c9a52-6d1e-4b8a-9c27-5e41b7d08a6f",
"ingested_by": "spip",
"kind": "event",
"module": "spip",
"original_payload_hex": "474554202f2e656e7620485454502f312e310d0a486f73743a203230332e302e3131332e31300d0a557365722d4167656e743a204d6f7a696c6c612f352e300d0a4163636570743a202a2f2a0d0a436f6e6e656374696f6e3a20636c6f73650d0a0d0a",
"sequence": 1,
"type": ["connection", "info"]
},
"host": {"name": "example-sensor"},
"http": {
"request": {
"hash": {"akin": "b11cun040_00040015_4c87b06e"},
"headers": {
"accept": "*/*",
"connection": "close",
"host": "203.0.113.10",
"user-agent": "Mozilla/5.0"
},
"method": "GET"
}
},
"network": {"bytes": 177, "community_id": "1:HL0iYZHtkKWecl0HBQsLeL+lIc8=", "transport": "tcp"},
"observer": {
"hostname": "example-sensor",
"id": "example-sensor",
"product": "Spip",
"type": "honeypot",
"vendor": "HoneyLabs",
"version": "dev"
},
"source": {"bytes": 99, "ip": "198.51.100.23", "port": 51234},
"url": {"domain": "203.0.113.10", "path": "/.env"},
"user_agent": {"original": "Mozilla/5.0"}
}
下游系统可以根据需要对这些记录进行富化(地理位置、ASN 等)。
Spip 会为每条记录添加被动指纹识别字段,而不改变其捕获的内容:
network.community_id:五元组(源 IP 和端口、目的 IP 和端口、协议)的 Community ID v1 流哈希。当流量通过 iptables 重定向时,Spip 会对 REDIRECT 之前的原始目的地址进行哈希,因此该值与其他网络监控系统为同一流计算出的值一致。tls.client.server_name(SNI)、tls.client.supported_protocols(客户端提供的 ALPN 列表)、tls.client.hash.ja4 和 tls.client.hash.ja3,均从 ClientHello 中读取。TLS 还会添加 tls.client.version、tls.client.cipher,以及当客户端出示证书时的 tls.client.client_certificate.*。这些字段需要 cert_path 和 key_path。没有它们,TLS 握手会被记录为原始载荷。握手失败的 TLS 连接会被关闭且不产生记录。tls.client.hello_hex:ClientHello 记录的原样内容,包含头部。上述所有指纹均从这些字节派生,而每个指纹都会丢弃其中一部分信息,例如扩展顺序、GREASE 位置或扩展体。保留该记录可以让你校验指纹、在修复 bug 后重新计算,或计算流量被捕获时尚不存在的方案。一个 hello 只有几百字节,且捕获在每个连接 16 KiB 处停止。设置 capture_client_hello = false 可将其关闭。ssh.client.hash.hassh:当载荷以 SSH-2.0- 开头且包含 KEXINIT 时。http.request.hash.akin:根据请求头计算出的 Akin 令牌。该令牌包含一个针对固定头部列表的存在映射,以及其余头部的短代码,因此两个令牌之间的距离就是两个客户端不同的头部数量,且头部顺序永远不会影响它。轮换 User-Agent 的扫描器会保持同一个指纹,因为 User-Agent 值和请求路径都不属于该指纹的一部分。默认关闭。设置 udp_enabled = true 后,Spip 还会在同一端口(或 udp_port)上监听 UDP,并记录它收到的每个数据报。它从不发送回复。DNS、NTP、SNMP、memcached 和 SSDP 都是放大攻击向量,而一个会响应伪造请求的传感器就会变成反射器,指向欺骗者选定的目标。
每个数据报按以下顺序进行分类: