Awesome

poc-runner

CHANGE LOG

前往下载

DESC

XRAY POC RUNNER (Open Source Version)

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

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

主要特性:

• 完全开源（所有代码开源不存在闭源二进制文件）
• 无需复杂的 yaml 配置文件且命令行参数尽可能简化
• 完全不使用 google/cel 库（使用底层 antlr 实现更轻量的表达式解析）
• 完全不使用 net/http 库（使用 net.Dial 从零实现 raw http client）

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

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

POC 仓库: https://github.com/chaitin/xray/tree/master/pocs

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

Quick Start

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

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

加入 -proxy 参数启动代理

HTML 报告页面

反连

默认使用 dnslog.cn 作为反连

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

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

./poc-runner -r [poc].yml -t http://target -reverse interact.sh -proxy socks5://127.0.0.1:10808

API

Get

go get github.com/4ra1n/poc-runner/api@0.1.2

Example

package main

import (
	"context"
	"fmt"

	"github.com/4ra1n/poc-runner/api"
)

var poc = `name: poc-yaml-test
transport: http
set:
  rand: randomInt(200000000, 210000000)
rules:
  r0:
    request:
      cache: true
      method: POST
      path: /test
      headers:
        Content-Type: text/xml
      body: test
      follow_redirects: false
    expression: response.status == 404
expression: r0()`

func main() {
	ctx := context.Background()
	runner, err := api.NewPocRunner(ctx)
	if err != nil {
		return
	}
	report, err := runner.Run([]byte(poc), "https://example.com")
	if err != nil {
		return
	}
	fmt.Println(report)
}

Advance Example

func main() {
	ctx := context.Background()
	// NEW ADVANCE POC RUNNER
	runner, err := NewPocRunnerEx(
		ctx,                        // CONTEXT
		"socks5://127.0.0.1:10808", // SOCKS PROXY
		time.Second*10,             // TIMEOUT
		true,                       // DEBUG MODE
		"dnslog.cn",                // REVERSE CONFIG (dnslog.cn | interact.sh)
		log.DebugLevel,             // LOG LEVEL
	)
	if err != nil {
		return
	}
	// RUN POC
	report, err := runner.Run([]byte(poc), "https://example.com")
	if err != nil {
		return
	}
	fmt.Println(report)
}

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

response variables

string function

bytes function

builtin function

reverse variables

reverse function

TEST

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

Star

THANKS

部分代码参考: https://github.com/raylax/rayx

感谢