由AKIOIOJ强力驱动的新一代Online Judge服务

本项目由 Vijos 4 二次开发而来。

---

特性

• Problem Categories and Tags
• Solution Sharing & Voting
• Online Coding and Testing (a.k.a. Scratchpad Mode)
• Discussions & Comments
• Trainings
• Contests (ACM & OI)
• Dynamic Ranking System
• Real-time Status Updates
• Online Judge as a Service (a.k.a. Domain): create your own OJ website without dev-ops!
• Management UI
• Sandboxed & Distributed Judging: see jd4, winjudge and windows-container
• Secure (we are also CTF players)
• Modern Architecture & User Interface

相比于vj4新增的功能：（部分）

• 用户TAG
• 作弊者棕名
• 纪念账户
• 全站后台
• 用户管理
• 域轮播图
• 域推荐题目
• 域自定义CSS/页脚
• 更加强大的Markdown以及数学公式渲染
• 每日人品以及祝福
• 犇犇
• 邮件广播
• 更多特性请亲自体验

使用

Docker部署

参考Gingmzmzx/akioioj-docker

刷新RP和排名

您可以在系统crontab中定时执行如下指令

cd /工作目录 && docker-compose exec -T web /bin/sh /app/fresh.sh

Manual build

Prerequisites

• Python 3.5.3+
• MongoDB 3.0+
• Node.js 10.0+
• RabbitMQ

Install requirements

In the root of the repository, where requirements.txt and package.json locates:

python3 -m pip install -r requirements.txt
yarn

You don't need root privilege to run yarn. It installs stuffs in the project directory. We recommend using Node 10.

You may want to use tuna if you are in China.

Some requirements may need Python.h. In Debian/Ubuntu you can use

apt install python3-dev

to resolve this.

IP Geo-Location

To enable IP geo-location translation, you need to follow the instruction on MaxMind GeoLite2 to obtain a GeoLite2 City Database, unzip it, and put it in the project root directory with the filename GeoLite2-City.mmdb.

You may also want to install libmaxminddb for higher performance.

Development

In the root of the repository:

yarn build   # or: yarn build:watch
python3 -m vj4.server --debug

Set --listen (default: http://127.0.0.1:8888) to listen on a different address.

As an intuitive example, you may want to add a super administrator and a problem to start:

alias pm="python3 -m"
pm vj4.model.user add -1 icebox 12345 icebox@iceboy.org
pm vj4.model.user set_superadmin -1
pm vj4.model.adaptor.problem add system "Dummy Problem" "# It *works*" -1 1000   # you can also use web UI

You need to run these scripts on a regular basis to maintain correct RP and ranks for all users:

pm vj4.job.rp recalc_all
pm vj4.job.rank run_all

Watch and Restart

Frontend source codes can be recompiled automatically by running:

yarn build:watch

However you need to manually restart the server for server-side code to take effect.

Production

yarn build:production
python3 -m vj4.server --listen=unix:/var/run/vj4.sock

• Set --listen (default: http://127.0.0.1:8888) to listen on a different address.
• Set --prefork (default: 1) to specify the number of worker processes.
• Set --ip-header (default: '') to use IP address in request headers.
• Set --url-prefix (default: https://vijos.org) to set URL prefix.
• Set --cdn-prefix (default: /) to set CDN prefix.
• Set --smtp-host, --smtp-user, --smtp-password, and --mail-from to specify a SMTP server.
• Set --db-host (default: localhost) and/or --db-name (default: test) to use a different database.

Better to use a reverse proxy like Nginx or h2o.

Judging

To enable vj4 to judge, at least one judge user and one judge daemon instance are needed.

• Use following commands to create a judge user:

alias pm="python3 -m"
pm vj4.model.user add -2 judge 123456 judge@example.org
pm vj4.model.user set_judge -2

• See https://github.com/Gingmzmzx/jd4 for more details about the judge daemon.

Notes

Have fun!

Maximum line width: 100

Indentation: 2 spaces

JavaScript Style Guide

No commercial use, except get permission from us.

References

• aiohttp
• Jinja2 Documentation
• Motor: Asynchronous Python driver for MongoDB
• Webpack Module Bundler