跳转至

2. 快速部署

Info

前提：快速部署需要基于系统已经安装了docker和docker-compose，若无请先返回上一步：环境配置

Danger

注意：如果正式部署运用HOJ，请修改默认配置的密码，例如Redis、MySQL、Nacos的密码！！！
使用默认密码可能会导致数据泄露，网站极其不安全！

如果当前服务器系统为CentOS7请先看：centos7部署HOJ可能遇到的问题

!!! warning

提示：当前默认是设置**amd64**的镜像，如果使用的服务器是**arm64**架构的，请记得修改docker-compose.yml文件，将每个模块中的image配置修改成支持**arm64**的镜像地址，yml文件中也有注释提示，请仔细查看。需要将`docker-compose.yml`文件中各个模块image为`image: registry.cn-shenzhen.aliyuncs.com/hcode/******` 修改为`image: himitzh/******`

例如将`image: registry.cn-shenzhen.aliyuncs.com/hcode/hoj_judgeserver`  => `image:himitzh/hoj_judgeserver`

一、单机部署

  1. 选择好需要安装的位置，运行下面命令
git clone https://gitee.com/himitzh0730/hoj-deploy.git && cd hoj-deploy
# 或者选择github的仓库
# git clone https://github.com/HimitZH/HOJ-Deploy.git && cd hoj-deploy
  1. 进入到单体部署的配置文件夹
cd standAlone
  1. 查看文件，使用命令ll 可以查看到 standAlone文件夹下有两个文件 
├── docker-compose.yml
├── .env
  1. 修改配置文件里面的默认配置
vim .env

简单测试可以不改，但正式部署请修改默认配置的密码！

各项配置请看文件内说明，一般请修改默认为hoj123456的三个密码配置项即可，如下：

  • 缓存Redis的密码配置项：REDIS_PASSWORD
  • 数据库MySQL的密码配置项：MYSQL_ROOT_PASSWORD

  • 服务注册中心Nacos的密码配置项：NACOS_PASSWORD

  • 安装和启动服务

docker-compose up -d

根据网速情况，大约十到二十分钟拉取镜像，全程无需人工干预，拉取完毕后，自动启动容器服务，大概需要一至两分钟的初始化。

  1. 查看服务状态
docker ps -a

  当看到所有的容器的状态status都为`UP`或`healthy`就代表 OJ 已经启动成功。
  1. 查看HOJ网站

打开浏览器，访问http://服务器ip，如若正常，即可看到OJ首页。

默认唯一的超级管理员账号如下，请注意之后点击页面右上角头像选择我的设置修改默认密码！

账号: root
密码: hoj123456
  1. 网站初始化配置

请一定要看下一篇文章：网站配置

  1. 参数说明以及网站性能提升

请看本文章的第三点：三、默认参数说明

二、分布式部署

Tip

主服务器（运行nacos，backend, frontend,redis）的服务器防火墙请开 8848，3306，873端口号
从服务器（运行judgeserver）的服务器防火墙请开8088端口号

  1. 选择好需要安装的位置，运行下面命令
git clone https://gitee.com/himitzh0730/hoj-deploy.git && cd hoj-deploy
# 或者选择github的仓库
# git clone https://github.com/HimitZH/HOJ-Deploy.git && cd hoj-deploy
  1. 进入文件夹
cd distributed

distributed文件夹有以下：

├── judgeserver
├── main
  1. 首先部署主服务，即是数据后台服务（DataBackup）
cd main

该文件夹下有：

├── docker-compose.yml
├── .env

vim .env  # 修改.env文件中的配置
  • 请修改REDIS_PASSWORD、MYSQL_ROOT_PASSWORD、NACOS_PASSWORD和RSYNC_PASSWORD的默认密码hoj123456
  • 同时配置MYSQL_PUBLIC_HOST为当前机器的公网ip

注意：各服务ip最好不改动，保持处于172.20.0.0/16网段的docker network

# hoj全部数据存储的文件夹位置（默认当前路径生成hoj文件夹）
HOJ_DATA_DIRECTORY=./hoj

# redis的配置
REDIS_HOST=172.20.0.2
REDIS_PORT=6379
REDIS_PASSWORD=hoj123456

# mysql的配置
MYSQL_HOST=172.20.0.3
# 请提供当前mysql所在服务器的公网ip
MYSQL_PUBLIC_HOST=172.20.0.3
MYSQL_PUBLIC_PORT=3306
MYSQL_ROOT_PASSWORD=hoj123456

# nacos的配置
NACOS_HOST=172.20.0.4
NACOS_PORT=8848
NACOS_USERNAME=root
NACOS_PASSWORD=hoj123456

# backend后端服务的配置
BACKEND_HOST=172.20.0.5
BACKEND_PORT=6688
# token加密秘钥 默认则生成32位随机密钥
JWT_TOKEN_SECRET=default
# token过期时间默认为24小时 86400s
JWT_TOKEN_EXPIRE=86400
# token默认12小时可自动刷新
JWT_TOKEN_FRESH_EXPIRE=43200
# 调用判题服务器的token 默认则生成32位随机密钥
JUDGE_TOKEN=default
# 请使用邮件服务的域名或ip
EMAIL_SERVER_HOST=smtp.qq.com
EMAIL_SERVER_PORT=465
EMAIL_USERNAME=your_email_username
EMAIL_PASSWORD=your_email_password
# 开启虚拟判题请提供对应oj的账号密码 格式为 
# username1,username2,...
# password1,password2,...
HDU_ACCOUNT_USERNAME_LIST=username1,username2
HDU_ACCOUNT_PASSWORD_LIST=password1,password2
CF_ACCOUNT_USERNAME_LIST=
CF_ACCOUNT_PASSWORD_LIST=
POJ_ACCOUNT_USERNAME_LIST=
POJ_ACCOUNT_PASSWORD_LIST=
ATCODER_ACCOUNT_USERNAME_LIST=
ATCODER_ACCOUNT_PASSWORD_LIST=
SPOJ_ACCOUNT_USERNAME_LIST=
SPOJ_ACCOUNT_PASSWORD_LIST=
# 是否强制使用上面配置的账号覆盖系统原有的账号列表
FORCED_UPDATE_REMOTE_JUDGE_ACCOUNT=false

# 评测数据同步的配置
# 请修改数据同步密码
RSYNC_PASSWORD=hoj123456

# docker network的配置
SUBNET=172.20.0.0/16

配置修改保存后，当前路径下启动该服务

docker-compose up -d

根据网速情况，大约十分钟即可安装完毕，全程无需人工干预。

等待命令执行完毕后，查看容器状态

docker ps -a

当看到所有的容器的状态status都为UP或healthy就代表 OJ 已经启动成功。

​

  1. 然后在另外一台机器，部署判题服务

在另一台服务器上，依旧git clone该文件夹下来，然后进入judgeserver文件夹，修改.env的配置，将NACOS_HOST、NACOS_PORT、NACOS_USERNAME、NACOS_PASSWORD、RSYNC_MASTER_ADDR、RSYNC_PASSWORD按照提示修改，然后JUDGE_SERVER_IP改成当前判题机器的公网ip。

# hoj全部数据存储的文件夹位置（默认当前路径生成judge文件夹）
HOJ_JUDGESERVER_DATA_DIRECTORY=./judge

# nacos的配置
# 修改为nacos所在服务的ip
NACOS_HOST=NACOS_HOST
# 修改为nacos启动端口号，默认为8848
NACOS_PORT=8848
# 修改为nacos的管理员账号
NACOS_USERNAME=root
# 修改为nacos的管理员密码
NACOS_PASSWORD=hoj123456

# judgeserver的配置
#修改服务器公网ip
JUDGE_SERVER_IP=172.20.0.7
JUDGE_SERVER_PORT=8088
JUDGE_SERVER_NAME=judger-1
# -1表示可接收最大判题任务数为cpu核心数+1
MAX_TASK_NUM=-1
# 当前判题服务器是否开启远程虚拟判题功能
REMOTE_JUDGE_OPEN=true
# -1表示可接收最大远程判题任务数为cpu核心数*2+1
REMOTE_JUDGE_MAX_TASK_NUM=-1
# 默认沙盒并行判题程序数为cpu核心数
PARALLEL_TASK=default

# rsync评测数据同步的配置
# 写入主服务器ip
RSYNC_MASTER_ADDR=127.0.0.1
# 与主服务器的rsync密码一致
RSYNC_PASSWORD=hoj123456

配置修改保存后，当前路径下启动该服务

docker-compose up -d

Tip

提示：需要开启多台判题机，就如当前第4步的操作一样，在每台服务器上执行以上的操作即可。

  1. 查看HOJ网站

打开浏览器，访问http://主服务器ip，如若正常，即可看到OJ首页。

默认唯一的超级管理员账号如下，请注意之后在右上角我的设置修改默认密码！

账号: root
密码: hoj123456
  1. 网站初始化配置

请一定要看下一篇文章：网站配置

  1. 参数说明以及网站性能提升

请看本文章的第三点：三、默认参数说明

三、默认参数说明

  1. 以下默认参数说明

Warning

  • 默认超级管理员账号与密码：root / hoj123456
  • 默认redis密码：hoj123456（正式部署请修改）
  • 默认mysql账号与密码：root / hoj123456（正式部署请修改）
  • 默认nacos管理员账号与密码：root / hoj123456（正式部署请修改）
  • 默认不开启https，开启需修改文件同时提供证书文件
  • 判题并发数默认：cpu核心数+1
  • 默认开启远程判题，需要手动修改添加账号与密码，如果不添加不能vj判题！
  • 远程判题并发数默认：cpu核心数*2+1
  1. 性能提升

Tip

提示：如果服务器的内存在4G或4G以上，请去掉JVM限制才能大大提高并发量，操作如下：

进入到之前部署的文件夹~/hoj-deploy/standAlone内，修改docker-compose.yml文件。

# 修改文件
vim docker-compose.yml
# 修改保存后，重启服务
docker-compose up -d

注释或去掉图中选中的行

① hoj-backend模块

在这里插入图片描述

​

  ② hoj-judgeserver模块

在这里插入图片描述