# packethub

**Repository Path**: jungle/packethub

## Basic Information

- **Project Name**: packethub
- **Description**: Packethub: Online hex-dump network packet decoder. Analyzes protocol structure and fields of network packets in hexadecimal format.
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://packethub.happyoj.com
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-31
- **Last Updated**: 2025-07-12

## Categories & Tags

**Categories**: networklib

**Tags**: packethub, hexdump, Network, packet-decoder

## README

# packethub

#### 介绍
Online hex-dump network packet decoder. Analyzes protocol structure and fields of network packets in hexadecimal format.

官网：[packethub.happyoj.com](https://packethub.happyoj.com)

#### 软件架构
软件架构说明


#### 安装教程

1.  安装python3：
```
apt install python3 python3-pip
```
2.  安装fastAPI：

```
pip install fastapi uvicorn[standard]
pip install sqlalchemy mysql-connector-python pydantic-settings jinja2 pytz bs4 python-multipart geoip2
```

3.  创建mysql数据库：
数据库（举例gdoj）要求有packet表，表结构如下：

![输入图片说明](https://foruda.gitee.com/images/1748790854323503929/9f04bce3_6154.png "屏幕截图")

可通过如下命令创建数据库和导入表结构
```
mysql -uroot -p -e "CREATE DATABASE packethub DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -uroot -p packethub < /home/ubuntu/code/packethub.sql
```

4. 下载源码：
`git clone https://gitee.com/jungle/packethub.git`
5. 配置环境遍历：
packethub目录下创建.env文件，内容配置数据库参数

![输入图片说明](https://foruda.gitee.com/images/1748791096052528178/4ce12774_6154.png "屏幕截图")

6. 运行服务：

`nohup python3 -m uvicorn app.main:app --host 0.0.0.0 &`

7. 访问页面如下：
![输入图片说明](https://foruda.gitee.com/images/1748791195862164096/836f593c_6154.png "屏幕截图")