HOJ
GitHub (opens new window)

2. 快速部署

# 2. 快速部署

Info

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

Warning

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

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

Note

提示：当前默认是设置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
    2
    3

  2. 进入到单体部署的配置文件夹

    cd standAlone
    1

  3. 查看文件，使用命令ll 可以查看到 standAlone文件夹下有两个文件

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

  4. 修改配置文件里面的默认配置

    vim .env
    1

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

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

    • 缓存Redis的密码配置项：REDIS_PASSWORD
    • 数据库MySQL的密码配置项：MYSQL_ROOT_PASSWORD
    • 服务注册中心Nacos的密码配置项：NACOS_PASSWORD

  5. 安装和启动服务

    docker-compose up -d
    1

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

  6. 查看服务状态

    docker ps -a
    1

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

  7. 查看HOJ网站

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

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

    账号: root
密码: hoj123456
    1
    2

  8. 网站初始化配置

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

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

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

# 二、分布式部署

Tips

主服务器（运行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
    2
    3

  2. 进入文件夹

    cd distributed
    1

    distributed文件夹有以下：

    ├── judgeserver
├── main
    1
    2

  3. 首先部署主服务，即是数据后台服务（DataBackup）

    cd main
    1

    该文件夹下有：

    ├── docker-compose.yml
├── .env
    1
    2
    vim .env  # 修改.env文件中的配置
    1
    • 请修改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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59

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

    docker-compose up -d
    1

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

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

    docker ps -a
    1

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

    ​

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

    在另一台服务器上，依旧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
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32

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

    docker-compose up -d
    1

    Tips

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

  5. 查看HOJ网站

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

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

    账号: root
密码: hoj123456
    1
    2

  6. 网站初始化配置

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

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

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

# 三、默认参数说明

  1. 以下默认参数说明

    Note

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

  2. 性能提升

    Tips

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

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

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

    注释或去掉图中选中的行

    ① hoj-backend模块

    在这里插入图片描述

    ​

    ② hoj-judgeserver模块

    在这里插入图片描述

Edit this page
Last update: March 20, 2023 22:09
Contributors: Himit_ZH

3. 网站配置