Ox4Shell 项目使用教程

Ox4Shell 项目使用教程

Ox4ShellDeobfuscate Log4Shell payloads with ease.项目地址:https://gitcode.com/gh_mirrors/ox/Ox4Shell

1. 项目的目录结构及介绍

Ox4Shell 项目的目录结构如下：

Ox4Shell/
├── README.md
├── ox4shell.py
├── config/
│   └── settings.yaml
├── docs/
│   └── usage.md
├── tests/
│   └── test_ox4shell.py
└── examples/
    └── example_payload.txt

• README.md: 项目介绍和使用说明。
• ox4shell.py: 项目的主启动文件。
• config/: 配置文件目录。
  • settings.yaml: 项目的配置文件。
• docs/: 文档目录。
  • usage.md: 使用文档。
• tests/: 测试文件目录。
  • test_ox4shell.py: 测试脚本。
• examples/: 示例文件目录。
  • example_payload.txt: 示例 Payload 文件。

2. 项目的启动文件介绍

项目的启动文件是 ox4shell.py。该文件包含了项目的主要功能和命令行接口。以下是启动文件的主要内容和功能介绍：

# ox4shell.py
import argparse
import yaml
from deobfuscator import Deobfuscator

def main():
    parser = argparse.ArgumentParser(description="Deobfuscate Log4Shell payloads with ease")
    parser.add_argument("-p", "--payload", help="Inline payload to deobfuscate")
    parser.add_argument("-f", "--file", help="File containing payload to deobfuscate")
    parser.add_argument("--decode-base64", action="store_true", help="Decode base64 commands")
    args = parser.parse_args()

    config = load_config()
    deobfuscator = Deobfuscator(config)

    if args.payload:
        result = deobfuscator.deobfuscate_payload(args.payload)
        print(result)
    elif args.file:
        with open(args.file, 'r') as file:
            payload = file.read()
            result = deobfuscator.deobfuscate_payload(payload)
            print(result)

def load_config():
    with open("config/settings.yaml", 'r') as file:
        config = yaml.safe_load(file)
    return config

if __name__ == "__main__":
    main()

• argparse: 用于处理命令行参数。
• yaml: 用于加载配置文件。
• Deobfuscator: 反混淆处理的主要类。
• main(): 主函数，处理命令行参数并调用反混淆功能。
• load_config(): 加载配置文件的函数。

3. 项目的配置文件介绍

项目的配置文件位于 config/settings.yaml。该文件包含了项目的配置选项。以下是配置文件的内容示例：

# config/settings.yaml
deobfuscation:
  max_depth: 5
  decode_base64: true
logging:
  level: INFO
  file: logs/ox4shell.log

• deobfuscation: 反混淆相关的配置。
  • max_depth: 反混淆的最大深度。
  • decode_base64: 是否解码 base64 命令。
• logging: 日志相关的配置。
  • level: 日志级别。
  • file: 日志文件路径。

通过以上配置文件，用户可以自定义反混淆的深度和是否解码 base64 命令，以及日志的级别和输出路径。

---

以上是 Ox4Shell 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！

Ox4ShellDeobfuscate Log4Shell payloads with ease.项目地址:https://gitcode.com/gh_mirrors/ox/Ox4Shell