# obpas

**Repository Path**: pigeoner/obpas

## Basic Information

- **Project Name**: obpas
- **Description**: 开放式二进制程序分析平台
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-05-01
- **Last Updated**: 2022-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开放式二进制程序分析系统
## OpenBinaryProgramAnalysisSystem

## 介绍
本科毕设项目，用于进行二进制程序静态分析

### 主要功能
- 基础分析：生成文件的属性信息、哈希值、控制流图、函数调用图。
- 自定义分析：编写脚本上传至系统进行分析。
- 分析结果展示：在线查看分析结果或下载报告查看。

### 主要使用的框架、工具及其版本

- 后端：
    - Python 3.10.4
    - Django 3.2.12
    - poetry 1.1.13
    - angr 9.1.12332
    - angr-utils 0.5.0

- 前端
    - Vue 3.2.25
    - Element-Plus 2.0.3
### 使用方法

#### 克隆仓库
```shell
git clone https://gitee.com/pigeoner/obpas.git # 克隆仓库到自己的服务器或主机上
```

#### 后端配置

```shell
cd server
poetry install # 创建虚拟环境并安装依赖。poetry安装方法可以参考 https://blog.csdn.net/weixin_43880991/article/details/120878759
redis-server # 启动redis
poetry run celery  -A celery_study worker  -l debug -P # 启动celery
# celery  -A celery_study worker  -l debug -P eventlet # Windows下启动celery
cd obap
poetry run python manage.py createsuperuser # 新建一个超级用户。
在个人数据库中新建一个名为 obpas 的数据库
poetry run python manage.py makemigrations # 生成迁移文件
poetry run python manage.py migrate # 数据库迁移
mkdir static # 新建static文件夹，Windows下直接创建
poetry run python manage.py collectstatic # 收集静态文件。
修改 settings.py 中白名单 CORS_ORIGIN_WHITELIST、数据库 DATABASES、邮件相关配置项。

# 若在本地运行
poetry run python manage.py runserver # 启动项目

# 若需要部署到服务器
cd uwsgi_files # 进入uwsgi文件夹
修改 uwsgi.ini 文件中的项⽬⽬录绝对路径 chdir 和指定依赖的虚拟环境 virtualenv
uwsgi --ini uwsgi.ini # 启动uwsgi
```

#### 前端配置
```shell
cd client # 进入client文件夹
修改 ./src/router 路径下 serverBaseURL.js 文件中 serverBaseURL 的值为自己的服务器ip地址或域名
npm install # 安装依赖包
npm run dev # 开发环境运行
npm run build # 打包生成的dist文件夹中的 index.html 为前端页面根路径
```

#### 服务器配置
```shell
在nginx配置中将index指向dist文件夹中的 index.html 的根路径，nginx其余配置略
start nginx # 启动nginx，通过浏览器可访问
```