poc-runner - Small & Fast Vulnerability Scanner Engine based on

项目说明

poc-runner

CHANGE LOG

<img alt="gitleaks badge" src="

![]()
![]()

![]()
![]()
![]()
![]()

前往下载

DESC

![asciicast]()

XRAY POC RUNNER (Open Source )

这是一个 XRAY 的 YAML 开源执行器（虽然网上已经有很多个开源实现了）

可执行文件体积 非常小（例如 windows-amd64 仅 2 MB）

主要特性:

反连内置了 dnslog.cn 和 projectdiscovery/interactsh 无需配置直接使用

注意：本项目 不提供 任何 POC 规则文件（仅提供执行引擎）

POC 仓库:

> 仅供个人学习和研究使用，请勿用于非法用途

Quick Start

基础使用 poc-runner -r [poc].yml -t [target]


加入 -debug 打印所有请求响应


加入 -proxy 参数启动代理


HTML 报告页面


反连

默认使用 dnslog.cn 作为反连

你可以使用 -reverse interact.sh 指定使用 projectdiscovery/interactsh


由于网络原因，建议搭配代理使用

API

Get

Example

Advance Example

BUILD

WINDOWS: 参考 build.bat

LINUX: 参考 .github/build.yml

CONTRIBUTE

Thank you for your interest in contributing to the poc-runner project

欢迎师傅们贡献 poc-runner 项目，所有 PR 都会经过 CODE REVIEW

注意：请尽量不要引入第三方库，尽可能使用标准库实现功能，本项目的宗旨是轻量

SUPPORT

type

| yaml type | golang type | support |
|:----------|:--------------------|:----------------|
| int | int | 0.0.1 |
| string | string | 0.0.1 |
| bool | bool | 0.0.1 |
| bytes | \[\]byte | 0.0.1 |
| map | map\[string\]string | 0.0.1 |
| object | interface | 0.0.1 |

response

| name | type | support |
|:----------------------|:-------|:----------------|
| response.status | int | 0.0.1 |
| response.headers | map | 0.0.1 |
| response.content_type | string | 0.0.1 |
| response.body | bytes | 0.0.1 |
| response.body_string | string | 0.0.1 |

string function

| name | args | return | support |
|:----------|:-------|:-------|:----------------|
| bsubmatch | bytes | map | 0.0.1 |
| submatch | string | map | 0.0.1 |
| bmatches | string | map | 0.0.1 |
| matches | string | map | 0.0.1 |
| contains | string | bool | 0.0.1 |
| icontains | string | bool | 0.0.1 |

bytes function

| name | args | return | support |
|:----------|:------|:-------|:----------------|
| bcontains | bytes | bool | 0.0.1 |
| icontains | bytes | bool | 0.0.1 |

builtin function

| name | args | return | support |
|:----------------|:---------------|:-------|:----------------|
| bytes | string | bytes | 0.0.1 |
| string | any | string | 0.0.1 |
| substr | string,int,int | string | 0.0.1 |
| sleep | int | bool | 0.0.1 |
| randomInt | int,int | int | 0.0.1 |
| randomLowercase | int | string | 0.0.1 |
| randomUppercase | int | string | 0.0.1 |
| md5 | string | string | 0.0.1 |
| sha1 | string | string | 0.0.1 |
| sha256 | string | string | 0.0.1 |
| base64 | bytes\|string | string | 0.0.1 |
| urldecode | bytes\|string | string | 0.0.1 |
| get404Path | null | string | 0.0.1 |
| newReverse | null | object | 0.0.1 |
| print | object | bool | 0.1.0 |

reverse

| name | return | support |
|:---------------|:-------|:----------------|
| reverse.url | string | 0.0.1 |
| reverse.rmi | string | 0.0.1 |
| reverse.ldap | string | 0.0.1 |
| reverse.domain | string | 0.0.1 |

reverse function

| name | args | return | support |
|:-----|:-----|:-------|:----------------|
| wait | int | bool | 0.0.1 |

TEST

以下 POC 已在真实漏洞环境测试通过

| plugin name | result | remark |
|:-----------------------------------------------|:-------|:--------|
| tomcat-c.yml | ✅ | / |
| spring-c.yml | ✅ | / |
| apache-httpd-c.yml | ✅ | / |
| apache-httpd-cersal.yml | ✅ | / |
| apache-http-c.yml | ✅ | / |
| coldfusion-c.yml | ✅ | / |
| confluence-c.yml | ✅ | / |
| acti.yml | ✅ | / |
| couchdb-c.yml | ✅ | / |
| discuz-wooyun-2010-080723.yml | ✅ | / |
| docker-api-unauthorized-rce.yml | ✅ | / |
| elasticsearch-c.yml | ✅ | / |
| elasticsearch-c.yml | ✅ | / |
| elasticsearch-c.yml | ✅ | / |
| jenkins-c.yml | ✅ | / |
| joomla-c.yml | ✅ | / |
| kibana-c.yml | ✅ | / |
| lara.yml | ✅ | / |
| phpmyadmin-cusion.yml | ✅ | / |
| solr-c.yml | ✅ | reverse |
| solr-c.yml | ✅ | / |
| weblogic-c.yml | ✅ | reverse |
| weblogic-c.yml | ✅ | / |
| weblogic-c.yml | ✅ | / |
| weblogic-c.yml | ✅ | / |
| weblogic-c.yml | ✅ | / |
| weblogic-ssrf.yml | ✅ | / |
| zabbix-c.yml | ✅ | / |

Star

<di="center">

<img src=" width="600" height="400" alt="Star History Chart" ="middle">

</div>

THANKS

部分代码参考:

感谢

项目信息

开发语言：Go

Star 数：179

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Small & Fast Vulnerability Scanner Engine based on XRAY YAML Rule | 基于 XRAY YAML 规则的超轻量快速漏洞扫描引擎 | 基于 ANTLR 实现语法分析和完整的 XRAY YAML 规则实现 | 简单的启动参数 | 包含多种反连可用 | 可执行文件体积仅 2 MB展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。