hshe

KO | EN

gitlite — search

#javascript #ai #go #golang #android #machine-learning #rust #docker #macos #java #awesome-list #security #mcp #openai

(★ 78)

Online Judge System 在线评测系统代码查重作业质量

hshe Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HSHE 在线评测系统

[![Build Status](https://travis-ci.com/shawnsky/hshe.svg?branch=master)](https://travis-ci.com/shawnsky/hshe)

主要使用 Spring Boot 开发 Web 前后台，评测模块和查重模块。评测模块内核使用 C++ 开发。使用垂直型的应用架构和分布式集群部署，服务间通过消息中间件通信。使用了前后端分离的开发模式，前端使用 Vue 框架开发 SPA 应用，后端 Web 模块全 RESTful API ，使用 Redis 做缓存，提供了良好的使用体验。部署使用Docker 容器，保证系统的安全性与可靠性。

## 部署

### 通过 Docker Compose 安装

本项目实现了从源码构建打包到部署运行自动化。所以，在 `git clone` 本仓库后，可以直接一行命令运行起整个系统。（前提是部署环境安装了 Docker 和 [Docker Compose](https://docs.docker.com/compose/install/)）

#### 启动

```
cd docker/
docker-compose up
```

后续的依赖下载和部署过程大概需要等待3～5分钟，之后可以通过 `8080` 端口访问测试，可以使用如下账号

- Teacher: ID `00079888` Password `123456`
- Student: ID `180705202` Password `123456`

#### 停止

```
cd docker/
docker-compose kill
docker-compose rm --force
```

杀死并删除所有容器

### 手动安装

#### 安装依赖服务

在部署环境安装以下软件：

- Docker
- MySQL 5.6
- RabbitMQ 3.6
- Redis 4.0
- Nginx

#### 配置

- 部署环境创建数据目录

```
  mkdir -p /data/subs/
  mkdir -p /data/tests/
  ```

- 复制 judge_sim.sh（在这里 `docker/sim/judge_sim.sh` ）到部署环境 `/usr/local/bin` 下

- 复制 sim302 目录（在这里 `docker/sim/sim302` ）到部署环境 `/usr/local` 下

- 在 `core`, `judge`, `sim` 子项目的 `application.properties` 中修改：
  - 相应服务的 `host`, `user`, `password` 等
  - 系统数据存储路径
  - 认证密钥等（建议设置为环境变量）

- 复制 Nginx 配置文件（在这里 `docker/web/nginx.conf`），并修改 `/api` 路由的 `proxy_pass` 为你的部署主机地址。然后复制 `static` 目录到部署环境的 `/hshe/static`

- 运行 SQL 脚本，导入数据库 Demo 数据（在这里 `docker/mysql-dump/hshe-7-12.sql`）

#### 构建项目

**已通过测试的构建环境** CentOS 7、Ubuntu 18.04

在 `core`, `judge`, `sim` 目录中分别执行：

```
mvn clean package -DskipTests
```

#### 构建镜像

使用 Docker Java 8 基础镜像分别构建 3 个嵌入 jar 的镜像。Dockerfile 示例：

- core

```
  FROM java:8
  COPY . /usr/bin
  WORKDIR /usr/bin
  CMD ["java", "-jar", "core-0.0.1-SNAPSHOT.jar"]
  ```

- judge

```
  FROM java:8
  COPY . /usr/bin
  WORKDIR /usr/bin
  RUN useradd hshe -u 1000 -p "$(openssl passwd -1 hshepasswd)"
  USER hshe
  CMD ["java", "-jar", "judge-0.0.1-SNAPSHOT.jar"]
  ```

- sim

```
  FROM java:8
  COPY . /usr/bin
  WORKDIR /usr/bin
  CMD ["java", "-jar", "sim-0.0.1-SNAPSHOT.jar"]
  ```

在各自的 Dockerfile Context 下分别构建 3 个镜像：

```
docker build -t image-{core|judge|sim} .
```

#### 运行

启动容器

```
docker run -d -p 9000:9000  --name core  image-core
docker run -d --restart always -v /data/:/data/ --name judger1 image-judge
docker run -d --restart always -v /data/:/data/ --name judger2 image-judge
docker run -d -v /data/:/data/ -v /usr/local/sim_judge.sh:/usr/local/sim_judge.sh -v /usr/local/sim302/:/usr/local/sim302/ --name simer1 image-sim
```

注意 `core`,  `judge` 和  `sim` 之间的方法调用是 MQ 实现的 RPC，所以 `core` 和 `judge`/`sim` 可以运行在不同主机上，且 `judge`和 `sim` 容器可不限数量的启动

启动 Nginx 服务器

```
/usr/local/nginx
```

## 运行截图

#### 用户登录

学生和教师使用同一登录入口，教师登录后会出现后台管理入口。

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-login.JPG)

#### 首页

展示系统内作业题目信息。

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-index.png)

#### 题目界面

展示题目详情，样例输入和样例输出。可选的编程语言由评测环境决定，目前的测试基于 OpenJDK 1.8，可以评测 Java 代码。

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-problem.png)

#### 提交结果

检查提交结果，同时显示资源占用情况。

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-subs.JPG)

#### 管理后台

教师对班级、学生、作业的增删改管理。系统概览还可以查看目前各个评测机的运行状态。

**★ 加入了代码相似度分析（仅教师可见），比较并显示同一题目的某同学代码和其他同学代码的最高相似度，并把互相相似的代码作业标记为一组雷同作业。以帮助教师方便判定存在的作业抄袭情况。**

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-anysics.PNG)

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-addp.PNG)

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/test-groups.PNG)

## 说明

项目目录中，`core` 是指后端API服务（命名不规范请见谅）；`judge` 是指后端评测服务，收到来自前端的代码提交调用后，通知 `judge` 模块对代码编译、运行、判定结果；`sim` 是指后端查重服务，其实就是对开源查重工具SIM的调用封装，若 `judge` 模块判定代码通过，会通知 `sim` 模块对代码进行查重，并更新结果。`static` 目录是前端项目，需要单独发布。

`judge` 和 `sim` 是内部服务，不提供外部调用入口，总体的调用顺序是 `core` -> `judge` -> `sim` ，但为了避免同步调用，所以才使用了 MQ 来做服务通信，同时启动多个 `judge` 和 `sim` 来消费，很大程度的提升了系统的性能和稳定性。

服务端运行来自用户的代码非常危险，因此服务运行于容器，保证了评测服务的安全。

*本项目的架构大致如下图

![](https://raw.githubusercontent.com/shawnsky/hshe/master/screenshots/arch.png)

欢迎大家运行体验！

hshe

hshe Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

hshe

hshe Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README