[
{
"path": ".gitignore",
"content": "*.classpath\n\n# Package Files\n*.jar\n*.war\n*.ear\n*.log\n*.iml\n\n.DS_Store\nnode_modules\ndist/\n.cache/\n.temp/\ntarget/\nout/\n.idea/\n.classpath\n.project\n\n# local env files\n.env.local\n.env.*.local\n\n# Log files\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\n*.log*\n\n# Editor directories and files\n.idea\n.vscode\n*.suo\n*.ntvs*\n*.njsproj\n*.sln\n*.sw?\n\n"
},
{
"path": "LICENSE",
"content": "MIT License\n\nCopyright (c) 2022 simplefanC\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."
},
{
"path": "README.md",
"content": "# Virtual Online Judge（VOJ）\n\n[](https://openjdk.java.net)\n[](https://spring.io/projects/spring-boot)\n[](https://spring.io/projects/spring-cloud)\n[](https://spring.io/projects/spring-cloud-alibaba)\n[](https://www.mysql.com/)\n[](https://redis.io/)\n[](https://cn.vuejs.org/)\n\n## 简介\n\nVOJ 是基于微服务、前后端分离的高性能在线评测系统。采用现阶段流行技术实现，采用 Docker 容器化部署。\n\n## 概览\n\n+ 基于 Docker，真正一键部署\n+ 前后端分离，模块化编程\n+ 微服务，支持分布式判题\n+ 拥有**本地判题**服务，同时支持其它知名 OJ (HDU、POJ、Codeforces、AtCoder...) 的**远程判题**\n+ ACM/OI 两种比赛模式、完善的比赛功能（打星队伍、关注队伍、外榜）\n+ 完善的判题模式（普通测评、特殊测评、交互测评）\n+ 支持私有训练、公开训练（题单）\n+ 更细致的权限划分，超级管理员、题目管理员、普通管理员各司其职\n+ 丰富的可视化图表，一图胜千言\n+ 支持 Template Problem，可以添加函数题甚至填空题\n+ 多语言支持：`C`, `C++`, `Java`, `Python`, `C#`，`GoLang`\n+ Markdown & LaTeX 支持\n\n## 项目源码\n\n+ 后端源码：[https://github.com/simplefanC/voj](https://github.com/simplefanC/voj)\n+ 前端源码：[https://github.com/simplefanC/voj-vue](https://github.com/simplefanC/voj-vue)\n+ 判题沙箱：[https://github.com/criyle/go-judge](https://github.com/criyle/go-judge)\n\n## 项目文档\n\n项目文档地址：[https://github.com/simplefanC/voj/wiki](https://github.com/simplefanC/voj/wiki)\n\n## 项目结构\n\n```\nvoj\n├── voj-common -- 工具类及通用代码\n├── voj-backend -- 业务服务模块\n└── voj-judger -- 评测服务模块\n```\n\n## 技术选型\n\n| 技术 | 说明 | 官网 |\n| -------------------- | ------------------- | ----------------------------------------------- |\n| Spring Boot | 容器+MVC框架 | https://spring.io/projects/spring-boot |\n| Spring Cloud | 微服务框架 | https://spring.io/projects/spring-cloud |\n| Spring Cloud Alibaba | 微服务框架 | https://spring.io/projects/spring-cloud-alibaba |\n| MyBatis-Plus | ORM框架 | https://baomidou.com |\n| Druid | 数据库连接池 | https://github.com/alibaba/druid |\n| Redis | 分布式缓存 | https://redis.io |\n| Shiro | 认证和授权框架 | https://shiro.apache.org |\n| JWT | JWT登录支持 | https://github.com/jwtk/jjwt |\n| Hibernator-Validator | 验证框架 | http://hibernate.org/validator |\n| EasyExcel | JAVA解析Excel工具 | https://github.com/alibaba/easyexcel |\n| PageHelper | MyBatis物理分页插件 | https://github.com/pagehelper/Mybatis-PageHelper |\n| Hutool | Java工具类库 | https://github.com/looly/hutool |\n| Lombok | 简化对象封装工具 | https://github.com/rzwitserloot/lombok |\n| Swagger-UI | 文档生成工具 | https://github.com/swagger-api/swagger-ui |\n| Nginx | 静态资源服务器 | https://www.nginx.com |\n| Docker | 应用容器引擎 | https://www.docker.com \n\n## 部署\n\n快速部署：[基于 Docker Compose 部署](https://github.com/simplefanC/voj/wiki/deploy)\n\n部署仓库：[https://github.com/simplefanC/voj-deploy](https://github.com/simplefanC/voj-deploy)\n"
},
{
"path": "docs/package.json",
"content": "{\n \"name\": \"voj-docs\",\n \"version\": \"1.0.0\",\n \"description\": \"Virtual Online Judge\",\n \"license\": \"MIT\",\n \"type\": \"module\",\n \"scripts\": {\n \"build\": \"vuepress build src\",\n \"clean-dev\": \"vuepress dev src --clean-cache\",\n \"dev\": \"vuepress dev src\"\n },\n \"devDependencies\": {\n \"@vuepress/client\": \"2.0.0-beta.51\",\n \"vue\": \"^3.2.29\",\n \"vuepress\": \"2.0.0-beta.51\",\n \"vuepress-theme-hope\": \"2.0.0-beta.108\"\n }\n}\n"
},
{
"path": "docs/src/.vuepress/config.ts",
"content": "import {defineUserConfig} from \"vuepress\";\nimport theme from \"./theme\";\n\n// const { searchPlugin } = require('@vuepress/plugin-search')\n\nexport default defineUserConfig({\n // dest: './', // 设置输出目录\n lang: \"zh-CN\",\n title: \"VOJ\",\n description: \"Virtual Online Judge\",\n\n base: \"/\",\n\n head: [\n [\n \"link\",\n {\n rel: \"stylesheet\",\n href: \"//at.alicdn.com/t/font_2410206_mfj6e1vbwo.css\",\n },\n ],\n ],\n\n plugins: [\n // searchPlugin({\n // // https://v2.vuepress.vuejs.org/zh/reference/plugin/search.html\n // // 排除首页\n // isSearchable: (page) => page.path !== \"/\",\n // maxSuggestions: 10,\n // hotKeys: [\"s\", \"/\"],\n // // 用于在页面的搜索索引中添加额外字段\n // getExtraFields: () => [],\n // locales: {\n // \"/\": {\n // placeholder: \"搜索\",\n // },\n // },\n // }),\n ],\n theme,\n});\n"
},
{
"path": "docs/src/.vuepress/navbar.ts",
"content": "import {navbar} from \"vuepress-theme-hope\";\n\nexport default navbar([\n // \"/\",\n // \"/home\",\n // { text: \"使用指南\", icon: \"creative\", link: \"/guide/\" },\n // {\n // text: \"博文\",\n // icon: \"edit\",\n // prefix: \"/posts/\",\n // children: [\n // {\n // text: \"文章 1-4\",\n // icon: \"edit\",\n // prefix: \"article/\",\n // children: [\n // { text: \"文章 1\", icon: \"edit\", link: \"article1\" },\n // { text: \"文章 2\", icon: \"edit\", link: \"article2\" },\n // \"article3\",\n // \"article4\",\n // ],\n // },\n // {\n // text: \"文章 5-12\",\n // icon: \"edit\",\n // children: [\n // {\n // text: \"文章 5\",\n // icon: \"edit\",\n // link: \"article/article5\",\n // },\n // {\n // text: \"文章 6\",\n // icon: \"edit\",\n // link: \"article/article6\",\n // },\n // \"article/article7\",\n // \"article/article8\",\n // ],\n // },\n // { text: \"文章 9\", icon: \"edit\", link: \"article9\" },\n // { text: \"文章 10\", icon: \"edit\", link: \"article10\" },\n // \"article11\",\n // \"article12\",\n // ],\n // },\n // {\n // text: \"主题文档\",\n // icon: \"note\",\n // link: \"https://vuepress-theme-hope.github.io/v2/zh/\",\n // },\n]);\n"
},
{
"path": "docs/src/.vuepress/sidebar.ts",
"content": "import {sidebar} from \"vuepress-theme-hope\";\n\nexport default sidebar([\n // \"/\",\n // \"/home\",\n // \"/slide\",\n {\n text: '序章',\n collapsable: true,\n prefix: \"/introduction/\",\n children: [\n '',\n 'architecture'\n ]\n },\n {\n text: '快速部署',\n collapsable: true,\n prefix: \"/deploy/\",\n children: [\n '',\n 'docker',\n 'open-https',\n 'multi-judgeserver',\n // 'update',\n 'how-to-backup'\n ]\n },\n {\n text: '单体部署',\n collapsable: true,\n prefix: \"/monomer/\",\n children: [\n 'mysql',\n // 'mysql-checker',\n 'redis',\n 'nacos',\n 'backend',\n 'judgeserver',\n 'frontend',\n 'rsync'\n ]\n },\n {\n text: '开发文档',\n collapsable: true,\n prefix: \"/develop/\",\n children: [\n 'db',\n 'judge_dispatcher',\n 'sandbox',\n 'update-fe'\n ]\n },\n {\n text: '使用文档',\n collapsable: true,\n prefix: \"/use/\",\n children: [\n 'import-problem',\n 'judge-mode',\n 'testcase',\n 'training',\n 'contest',\n // 'group',\n 'import-user',\n 'admin-user',\n 'notice-announcement',\n 'discussion-admin'\n // 'custom-difficulty',\n // 'close-free-cdn'\n ]\n },\n // {\n // text: \"如何使用\",\n // icon: \"creative\",\n // prefix: \"/guide/\",\n // link: \"/guide/\",\n // children: \"structure\",\n // },\n // {\n // text: \"文章\",\n // icon: \"note\",\n // prefix: \"/posts/\",\n // children: [\n // {\n // text: \"文章 1-4\",\n // icon: \"note\",\n // collapsable: true,\n // prefix: \"article/\",\n // children: [\"article1\", \"article2\", \"article3\", \"article4\"],\n // },\n // {\n // text: \"文章 5-12\",\n // icon: \"note\",\n // children: [\n // {\n // text: \"文章 5-8\",\n // icon: \"note\",\n // collapsable: true,\n // prefix: \"article/\",\n // children: [\"article5\", \"article6\", \"article7\", \"article8\"],\n // },\n // {\n // text: \"文章 9-12\",\n // icon: \"note\",\n // children: [\"article9\", \"article10\", \"article11\", \"article12\"],\n // },\n // ],\n // },\n // ],\n // },\n]);\n"
},
{
"path": "docs/src/.vuepress/styles/index.scss",
"content": ""
},
{
"path": "docs/src/.vuepress/styles/palette.scss",
"content": ""
},
{
"path": "docs/src/.vuepress/theme.ts",
"content": "import {hopeTheme} from \"vuepress-theme-hope\";\nimport navbar from \"./navbar\";\nimport sidebar from \"./sidebar\";\n\nexport default hopeTheme({\n hostname: \"https://vuepress-theme-hope-v2-demo.mrhope.site\",\n\n author: {\n name: \"simplefanC\",\n url: \"https://github.com/simplefanC\",\n },\n\n iconPrefix: \"iconfont icon-\",\n\n // logo: \"/logo.png\",\n\n repo: \"simplefanC/voj\",\n\n docsDir: \"docs/src\",\n\n // navbar\n navbar: navbar,\n\n // sidebar\n sidebar: sidebar,\n\n footer: \"鄂ICP备2020015769号-1\",\n\n displayFooter: true,\n\n pageInfo: [\"Author\", \"Original\", \"Date\", \"Category\", \"Tag\", \"ReadingTime\"],\n\n blog: {\n description: \"一个前端开发者\",\n intro: \"/intro.html\",\n medias: {\n Baidu: \"https://example.com\",\n Bitbucket: \"https://example.com\",\n Dingding: \"https://example.com\",\n Discord: \"https://example.com\",\n Dribbble: \"https://example.com\",\n Email: \"https://example.com\",\n Evernote: \"https://example.com\",\n Facebook: \"https://example.com\",\n Flipboard: \"https://example.com\",\n GitHub: \"https://example.com\",\n Gitlab: \"https://example.com\",\n Gmail: \"https://example.com\",\n Instagram: \"https://example.com\",\n Lines: \"https://example.com\",\n Linkedin: \"https://example.com\",\n Pinterest: \"https://example.com\",\n Pocket: \"https://example.com\",\n QQ: \"https://example.com\",\n Qzone: \"https://example.com\",\n Reddit: \"https://example.com\",\n Rss: \"https://example.com\",\n Steam: \"https://example.com\",\n Twitter: \"https://example.com\",\n Wechat: \"https://example.com\",\n Weibo: \"https://example.com\",\n Whatsapp: \"https://example.com\",\n Youtube: \"https://example.com\",\n Zhihu: \"https://example.com\",\n },\n },\n\n encrypt: {\n config: {\n \"/guide/encrypt.html\": [\"1234\"],\n },\n },\n\n plugins: {\n blog: {\n autoExcerpt: true,\n },\n\n // 如果你不需要评论，可以直接删除 comment 配置，\n // 以下配置仅供体验，如果你需要评论，请自行配置并使用自己的环境，详见文档。\n // 为了避免打扰主题开发者以及消耗他的资源，请不要在你的正式环境中直接使用下列配置!!!!!\n // comment: {\n // /**\n // * Using giscus\n // */\n // type: \"giscus\",\n // repo: \"vuepress-theme-hope/giscus-discussions\",\n // repoId: \"R_kgDOG_Pt2A\",\n // category: \"Announcements\",\n // categoryId: \"DIC_kwDOG_Pt2M4COD69\",\n //\n // /**\n // * Using twikoo\n // */\n // // type: \"twikoo\",\n // // envId: \"https://twikoo.ccknbc.vercel.app\",\n //\n // /**\n // * Using Waline\n // */\n // // type: \"waline\",\n // // serverURL: \"https://vuepress-theme-hope-comment.vercel.app\",\n // },\n\n mdEnhance: {\n enableAll: true,\n presentation: {\n plugins: [\"highlight\", \"math\", \"search\", \"notes\", \"zoom\"],\n },\n },\n },\n});\n"
},
{
"path": "docs/src/README.md",
"content": "---\ntitle: 首页\nhome: true\nheroImage: /logo.png\nheroText: VOJ\ntagline: 基于分布式、前后端分离的高性能在线评测系统\nactions:\n - text: 文档介绍 🔔\n link: /introduction/\n type: primary\n - text: 快速部署\n link: /deploy/docker/\nfeatures:\n - title: 分布式\n details: 支持多台判题服务弹性伸缩\n - title: 高效化\n details: 采用前后端分离，开发迅速，使用高性能可复用判题沙盒\n - title: 定制化\n details: 网站配置高度集中，支持定制化修改\n - title: 安全化\n details: 判题使用 Cgroups 隔离用户程序，网站权限控制完善\n - title: 多样化\n details: 独有本地判题服务，同时支持其它知名 OJ 题目的远程判题\n---\n\n[](https://openjdk.java.net)\n[](https://spring.io/projects/spring-boot)\n[](https://spring.io/projects/spring-cloud)\n[](https://spring.io/projects/spring-cloud-alibaba)\n[](https://www.mysql.com/)\n[](https://redis.io/)\n[](https://github.com/alibaba/nacos)\n[](https://cn.vuejs.org/)\n\nVirtual Online Judge (VOJ) : 基于前后端分离、分布式架构的在线测评系统（VOJ），前端使用 Vue，后端主要使用 Spring Boot，Redis，MySQL，Nacos 等主流技术，**支持 HDU、POJ、CF、AtCoder、MXT、JSK、TKOJ 的虚拟判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，支持私有训练、公开训练（题单），还有完善的判题模式（普通测评、特殊测评、交互测评）和完善的比赛功能（打星队伍、关注队伍、外榜）。**\n\n[GitHub 仓库](https://github.com/simplefanc/voj)\n\n有任何部署问题或项目 Bug 请提 Issue！\n\n"
},
{
"path": "docs/src/deploy/README.md",
"content": "# 环境配置\n\n## 环境说明\n:::tip\n- 后端：需要在 Linux 系统下部署运行，建议使用 Ubuntu 18.04，其它版本的 Linux 系统也可以，同时需要 **Docker** 辅助部署\n- 前端：Linux 系统下，需要 Nginx 进行反向代理\n- 判题服务：由于判题沙盒有多操作系统版本，Linux 系统或 Windows 均可以，但是在本 VOJ 镜像中**只能**使用 **Ubuntu 16.04** 以上或者 **CentOS 8** 以上\n- 数据同步：运行判题服务和后端服务的服务器有 rsync\n- **尽量不要使用突发性能或共享型的云服务器实例，有可能造成评测时间计量不准确。**\n:::\n\n## Linux环境搭建\n\n> VOJ 使用的 Ubuntu 18.04 版本，单机部署建议2核4G以上内存\n\n### 安装 Docker\n\n1. 安装需要的包\n\n ```shell\n sudo apt-get update\n ```\n\n2. 安装依赖包\n\n ```shell\n sudo apt-get install \\\n apt-transport-https \\\n ca-certificates \\\n curl \\\n gnupg-agent \\\n software-properties-common\n ```\n\n3. 添加 Docker 的官方 GPG 密钥\n\n ```shell\n curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -\n ```\n\n4. 设置远程仓库\n\n ```shell\n sudo add-apt-repository \\\n \"deb [arch=amd64] https://download.docker.com/linux/ubuntu \\\n $(lsb_release -cs) \\\n stable\"\n ```\n\n5. 安装 Docker-CE\n\n ```shell\n sudo apt-get update\n sudo apt-get install docker-ce docker-ce-cli containerd.io\n ```\n\n6. 验证是否成功\n\n ```shell\n sudo docker run hello-world\n ```\n\n### 安装 Docker-Compose\n\n1. 下载\n\n ```shell\n sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.25.5/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose\n ```\n\n2. 授权\n\n ```shell\n sudo chmod +x /usr/local/bin/docker-compose\n ```\n\n## Windows 环境\n\nWindows 下的安装仅供体验，勿在生产环境使用。如必要，请使用虚拟机安装 Linux 并将本 OJ 安装在其中。\n\n以下教程仅适用于 Win10 x64 下的 `PowerShell`\n\n1. 安装 Windows 的 Docker 工具\n2. 右击右下角 Docker 图标，选择 Settings 进行设置\n3. 选择 `Shared Drives` 菜单，之后勾选你想安装 OJ 的盘符位置（例如勾选D盘），点击 `Apply`\n4. 输入 Windows 的账号密码进行文件共享\n5. 安装 `Python`、`pip`、`git`、`docker-compose`，安装方法自行搜索。\n\n\n\n"
},
{
"path": "docs/src/deploy/docker.md",
"content": "# 快速部署\n**前提：已经在上一步准备好 Docker 与 Docker Compose**\n:::danger\n注意：如果正式部署运行 VOJ，请修改默认配置的密码，例如MySQL、Nacos的密码！！！ \n**使用默认密码可能会导致数据泄露，网站极其不安全！**\n:::\n\n## 一、单机部署\n\n1. 选择好需要安装的位置，运行下面命令\n\n ```shell\n git clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy\n ```\n\n2. 进入文件夹，使用docker-compose启动各容器服务\n\n ```shell\n cd standAlone\n ```\n\n `standAlone`文件夹文件有以下：\n\n ```bash\n ├── docker-compose.yml\n ├── .env\n ```\n\n 主要配置请见`.env`文件，内容如下：\n\n > 注意：各服务ip最好不改动，保持处于172.20.0.0/16网段的docker network\n\n ```properties\n # VOJ全部数据存储的文件夹位置（默认当前路径生成voj文件夹）\n VOJ_DATA_DIRECTORY=./voj\n \n # Redis的配置\n REDIS_HOST=172.20.0.2\n REDIS_PORT=6379\n \n # MySQL的配置\n MYSQL_HOST=172.20.0.3\n # 如果判题服务是分布式，请提供当前MySQL所在服务器的公网ip\n MYSQL_PUBLIC_HOST=172.20.0.3\n MYSQL_PORT=3306\n MYSQL_ROOT_PASSWORD=voj123456\n \n # Nacos的配置\n NACOS_HOST=172.20.0.4\n NACOS_PORT=8848\n NACOS_USERNAME=nacos\n NACOS_PASSWORD=nacos\n \n # backend后端服务的配置\n BACKEND_HOST=172.20.0.5\n BACKEND_PORT=6688\n # JWT加密秘钥，default则生成32位随机密钥\n JWT_TOKEN_SECRET=default\n # token过期时间默认为24小时（86400s）\n JWT_TOKEN_EXPIRE=86400\n # JWT默认12小时自动刷新\n JWT_TOKEN_FRESH_EXPIRE=43200\n # 调用判题服务器的token，default则生成32位随机密钥\n JUDGE_TOKEN=default\n # 请使用邮件服务的域名或ip\n EMAIL_SERVER_HOST=smtp.qq.com\n EMAIL_SERVER_PORT=465\n EMAIL_USERNAME=your_email_username\n EMAIL_PASSWORD=your_email_password\n \n # 判题服务的配置\n JUDGE_SERVER_IP=172.20.0.7\n JUDGE_SERVER_PORT=8088\n JUDGE_SERVER_NAME=judger-alone\n # -1表示可接收最大判题任务数为：cpu核心数+1\n MAX_TASK_NUM=-1\n # 当前判题服务器是否开启远程虚拟判题功能\n REMOTE_JUDGE_OPEN=true\n # -1表示可接收最大远程判题任务数为：cpu核心数*2+1\n REMOTE_JUDGE_MAX_TASK_NUM=-1\n # 默认沙盒并行判题程序数为：cpu核心数\n PARALLEL_TASK=default\n \n # docker network的配置\n SUBNET=172.20.0.0/16\n ```\n \n\n:::tip \n提示：如果服务器的内存在4G或4G以上，请去掉JVM限制才能提高并发量，操作如下：\n\n- 注释或删除`docker-compose.yml`中`voj-backend`模块和`voj-judger`模块`environment`参数`JAVA_OPTS`\n\n:::\n\n3. 如果不改动，则以默认参数启动（**正式部署请修改默认配置的密码！**）\n\n ```shell\n docker-compose up -d\n ```\n4. 对依赖服务 MySQL 进行以下设置（分布式部署主服务器时同理）\n 1. 将 voj.sql 和 nacos_config.sql 文件拷贝到容器/目录下：\n ```\n docker cp ../sql/voj.sql voj-mysql:/\n docker cp ../sql/nacos_config.sql voj-mysql:/\n ```\n 2. 进入 voj-mysql 容器并执行如下操作：\n ```\n # 进入mysql容器\n docker exec -it voj-mysql /bin/bash\n # 连接到mysql服务\n mysql -uroot -pvoj123456\n # 导入sql脚本\n source /voj.sql\n source /nacos_config.sql\n ```\n 3. 退出 voj-mysql 容器。\n \n5. docker-compose restart\n \n 等待命令执行完毕后，查看容器状态\n\n ```shell\n docker ps -a\n ```\n\n 当看到所有的容器的状态status都为`UP`或`healthy`就代表 OJ 已经启动成功。\n\n 以下默认参数说明\n :::warning\n - 默认超级管理员账号与密码：root / voj123456\n\n - 默认 MySQL 账号与密码：root / voj123456（**正式部署请修改**）\n\n - 默认 Nacos 管理员账号与密码：root / voj123456（**正式部署请修改**）\n\n - 默认不开启 https，开启需修改文件同时提供证书文件\n\n - 判题并发数默认：cpu核心数+1\n\n - 默认开启vj判题，需要手动修改添加账号与密码，如果不添加不能vj判题！\n\n - vj判题并发数默认：cpu核心数*2+1\n \n\n :::\n\n \n\n**登录root账号到后台查看服务状态以及到`http://ip/admin/conf`修改服务配置！**\n\n注意：网站的注册及用户账号相关操作需要邮件系统，所以请在系统配置中配置自己的SMTP邮件服务。\n\n**(如果已经在启动在.env文件配置了邮件服务即不用再次修改)**\n\n```bash\nHost: smtp.qq.com\nPort: 465\nUsername: 邮箱账号\nPassword: 开启SMTP服务后生成的随机授权码\n```\n\n\n\n## 二、分布式部署\n\n:::tip\n主服务器（运行Nacos, backend, frontend, Redis）的服务器防火墙请开8848(Nacos), 3306(MySQL), 873(Rsync)端口\n\n从服务器（运行judger）的服务器防火墙请开8088端口\n:::\n\n1. 选择好需要安装的位置，运行下面命令\n\n ```shell\n git clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy\n ```\n\n2. 进入文件夹\n\n ```shell\n cd distributed\n ```\n\n `distributed`文件夹有以下：\n\n ```bash\n ├── judger\n ├── main\n ```\n\n3. 首先部署主服务，即数据后台服务（DataBackup）\n\n ```shell\n cd main\n ```\n\n 该文件夹下有：\n\n ```bash\n ├── docker-compose.yml\n ├── .env\n ```\n\n 修改`.env`文件中的配置\n\n ```shell\n vim .env\n ```\n\n > 注意：各服务ip最好不改动，保持处于172.20.0.0/16网段的docker network\n\n ```properties\n # voj全部数据存储的文件夹位置（默认当前路径生成voj文件夹）\n VOJ_DATA_DIRECTORY=./voj\n \n # Redis的配置\n REDIS_HOST=172.20.0.2\n REDIS_PORT=6379\n \n # MySQL的配置\n MYSQL_HOST=172.20.0.3\n # 请提供当前MySQL所在服务器的公网ip\n MYSQL_PUBLIC_HOST=\n MYSQL_PORT=3306\n MYSQL_ROOT_PASSWORD=voj123456\n \n # Nacos的配置\n NACOS_HOST=172.20.0.4\n NACOS_PORT=8848\n NACOS_USERNAME=nacos\n NACOS_PASSWORD=nacos\n \n # backend后端服务的配置\n BACKEND_HOST=172.20.0.5\n BACKEND_PORT=6688\n # JWT加密秘钥，默认则生成32位随机密钥\n JWT_TOKEN_SECRET=default\n # JWT过期时间默认为24小时(86400s)\n JWT_TOKEN_EXPIRE=86400\n # JWT默认12小时可自动刷新\n JWT_TOKEN_FRESH_EXPIRE=43200\n # 调用判题服务器的token，默认则生成32位随机密钥\n JUDGE_TOKEN=default\n \n # 请使用邮件服务的域名或ip\n EMAIL_SERVER_HOST=smtp.qq.com\n EMAIL_SERVER_PORT=465\n EMAIL_USERNAME=your_email_username\n EMAIL_PASSWORD=your_email_password\n \n # 评测数据同步的配置\n # 请修改数据同步密码\n RSYNC_PASSWORD=voj123456\n \n # docker network的配置\n SUBNET=172.20.0.0/16\n ```\n \n 配置修改保存后，当前路径下启动该服务\n \n ```shell\n docker-compose up -d\n ```\n \n 等待命令执行完毕后，查看容器状态\n \n ```shell\n docker ps -a\n ```\n \n 当看到所有的容器的状态status都为`UP`或`healthy`就代表 OJ 已经启动成功。\n \n \n \n4. 接着，在另一台服务器上，依旧git clone该文件夹下来，然后进入`judger`文件夹，修改`.env`的配置\n\n ```properties\n # voj全部数据存储的文件夹位置（默认当前路径生成judge文件夹）\n VOJ_JUDGESERVER_DATA_DIRECTORY=./judge\n \n # Nacos的配置\n # 修改为Nacos所在服务的公网ip\n NACOS_HOST=\n # 修改为Nacos启动端口号，默认为8848\n NACOS_PORT=8848\n # 修改为Nacos的管理员账号\n NACOS_USERNAME=nacos\n # 修改为Nacos的管理员密码\n NACOS_PASSWORD=nacos\n \n # judgeserver的配置\n # 修改本服务器公网ip\n JUDGE_SERVER_IP=\n JUDGE_SERVER_PORT=8088\n JUDGE_SERVER_NAME=judger-1\n # -1表示可接收最大判题任务数为：cpu核心数+1\n MAX_TASK_NUM=-1\n # 当前判题服务器是否开启远程虚拟判题功能\n REMOTE_JUDGE_OPEN=true\n # -1表示可接收最大远程判题任务数为：cpu核心数*2+1\n REMOTE_JUDGE_MAX_TASK_NUM=-1\n # 默认沙盒并行判题程序数为cpu核心数\n PARALLEL_TASK=default\n \n # rsync评测数据同步的配置\n # 写入主服务器公网ip\n RSYNC_MASTER_ADDR=\n # 与主服务器的rsync密码一致\n RSYNC_PASSWORD=voj123456\n ```\n\n 配置修改保存后，当前路径下启动该服务\n\n ```shell\n docker-compose up -d\n ```\n :::tip\n 提示：需要开启多台判题机，就如当前第4步的操作一样，在每台服务器上执行以上的操作即可。\n :::\n5. 两个服务都启动完成，在浏览器输入主服务ip或域名进行访问，登录root账号到后台查看服务状态。\n"
},
{
"path": "docs/src/deploy/how-to-backup.md",
"content": "# 如何备份\n\n### 1. 单体部署\n\n部署脚本（`docker-compose.yml`）同目录的`voj`文件夹中，存储了本系统的全部数据：\n\n```html\nvoj\n├── file \t\t# 存储了上传的图片、上传的临时题目数据、markdown引用的文件等文件\n├── judge \t\t# 存储了每个提交题目的评测过程产生的数据\n├── log \t\t# 存储了voj-backend项目的运行日志\n├── testcase # 存储了题目的评测数据\n└── data \n ├── mysql\n │ ├── data # 存储了MySQL数据库的数据\n ├── redis\n │ ├── data # 存储了redis产生的快照数据\n```\n\n如果需要备份，只需将该`voj`文件夹复制一份即可，在新的机器上重新部署VOJ时，将该文件夹放置与`docker-compose.yml`同目录下，使用`docker-compose up -d`即可启动恢复原来的数据。\n\n\n\n### 2. 分布式部署\n\n- 主服务器（运行`voj-backend`的服务器）\n\n 部署脚本（`docker-compose.yml`）同目录的`voj`文件夹中，存储了本系统主服务器的全部数据：\n\n ```html\n voj\n ├── file \t\t# 存储了上传的图片、上传的临时题目数据、markdown引用的文件等文件\n ├── log \t\t# 存储了voj-backend项目的运行日志\n ├── testcase # 存储了题目的评测数据\n └── data \n ├── mysql\n │ ├── data # 存储了MySQL数据库的数据\n ├── redis\n │ ├── data # 存储了redis产生的快照数据\n ```\n\n- 判题服务器（运行`voj-judger`的服务器）\n\n 部署脚本（`docker-compose.yml`）同目录的`voj`文件夹中，存储了本系统判题服务器的全部数据：\n\n ```html\n judge\n ├── run \t\t# 存储了每个提交题目的评测过程产生的数据\n ├── log \t\t# 存储了voj-judger项目的运行日志\n ├── testcase # 存储了题目的评测数据(每100s从主服务器同步)\n ├── spj # 存储了SPJ的代码\n ```\n\n那么，主要要备份的还是**主服务器**的数据，只需将该`voj`文件夹复制一份即可，在新的机器上重新部署新的voj的时候，将该文件夹放置与`docker-compose.yml`一个目录下，使用`docker-compose up -d`即可启动恢复原来的数据。\n\n"
},
{
"path": "docs/src/deploy/multi-judgeserver.md",
"content": "# 多个判题机\n\n## 前言\n\n不同判题机之间是通过rsync进行数据同步的，所以需要配置相应的rsync服务。\n\n同时注意以下两点：\n\n1. 保证rsync-slave服务的密码与主服务rsync-master的数据同步密码一致\n2. rsync-slave服务（判题机服务器）拉取主服务rsync-master的评测数据是每100s一次，所以后台上传评测数据后，需等待大概100s才能正常判题。\n\n## 单体部署\n\n如果之前是选择了单体部署，也就是主服务器既有backend和judger服务，那么部署更多不同服务器的判题机应该如下修改：\n\n1. 在原先运行的服务器上，修改`voj-deploy/standAlone`文件夹里面的`docker-compose.yml`，**添加以下rsync-master服务**，数据同步密码请自行修改，如下：\n\n **（注意：如果云服务器有防火墙请开启8848，3306，873端口）**\n\n ```yaml\n voj-rsync-master:\n image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_rsync:1.0\n container_name: voj-rsync-master\n volumes:\n - ./voj/testcase:/voj/testcase:ro\n environment:\n - RSYNC_MODE=master\n - RSYNC_USER=vojrsync \n - RSYNC_PASSWORD=voj123456 # 请修改数据同步密码\n ports:\n - \"0.0.0.0:873:873\"\n ```\n\n **同时，需要将MySQL的配置`MYSQL_PUBLIC_HOST`改成当前服务器的公网IP**\n\n ```shell\n vim .env # 修改与docker-compose.yml同目录下的配置文件\n ```\n\n ```yaml\n # MySQL的配置\n MYSQL_HOST=172.20.0.3\n # 请提供当前mysql所在服务器的公网ip\n MYSQL_PUBLIC_HOST=***\n MYSQL_PUBLIC_PORT=3306\n MYSQL_ROOT_PASSWORD=voj123456\n ```\n 修改完保存，然后重启 Docker 即可生效\n ```shell\n docker-compose down\n docker-compose up -d\n ```\n2. 在其它服务器（判题服务器）中使用 Docker-Compose运行`voj-judger`服务，具体操作如下：\n\n **（注意：服务器请开启8088端口号，需要将判题服务暴露出去）**\n\n\n 1. 下载文件，进入到指定文件夹\n\n ```shell\n git clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/distributed/judger\n ```\n\n 2. 修改配置`.env`文件\n\n ```properties\n # Nacos的配置\n # 修改为Nacos所在服务的ip\n NACOS_HOST=\n # 修改为nacos启动端口号，默认为8848\n NACOS_PORT=8848\n # 修改为nacos的管理员账号\n NACOS_USERNAME=root\n # 修改为nacos的管理员密码\n NACOS_PASSWORD=voj123456\n\n # judgeserver的配置\n # 修改为当前服务器公网ip\n JUDGE_SERVER_IP=\n JUDGE_SERVER_PORT=8088\n JUDGE_SERVER_NAME=judger-1\n # -1表示可接收最大判题任务数为：cpu核心数+1\n MAX_TASK_NUM=-1\n # 当前判题服务器是否开启远程虚拟判题功能\n REMOTE_JUDGE_OPEN=true\n # -1表示可接收最大远程判题任务数为：cpu核心数*2+1\n REMOTE_JUDGE_MAX_TASK_NUM=-1\n # 默认沙盒并行判题程序数为cpu核心数\n PARALLEL_TASK=default\n\n # rsync评测数据同步的配置\n # 写入主服务器ip\n RSYNC_MASTER_ADDR=\n # 与主服务器的rsync密码一致\n RSYNC_PASSWORD=voj123456\n ```\n\n 3. 启动即可\n\n ```shell\n docker-compose up -d\n ```\n\n 4. 验证：\n\n 访问 http://ip:8088/version\n 如果返回信息正常即启动成功！\n\n\n## 分布式部署\n\n1. 如果之前已经选择了分布式部署，那么增加判题机，则与原先启动判题机的操作一样即可，在新的服务器上操作如下：\n\n ```shell\n git clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/distributed/judger\n vim .env\n ```\n\n2. 修改`.env`文件的配置\n\n ```properties\n # voj全部数据存储的文件夹位置（默认当前路径生成judge文件夹）\n VOJ_JUDGESERVER_DATA_DIRECTORY=./judge\n \n # Nacos的配置\n # 修改为Nacos所在服务的ip\n NACOS_HOST=\n # 修改为Nacos启动端口号，默认为8848\n NACOS_PORT=8848\n # 修改为Nacos的管理员账号\n NACOS_USERNAME=root\n # 修改为Nacos的管理员密码\n NACOS_PASSWORD=voj123456\n \n # judgeserver的配置\n # 修改本服务器公网ip\n JUDGE_SERVER_IP=\n JUDGE_SERVER_PORT=8088\n JUDGE_SERVER_NAME=judger-1\n # -1表示可接收最大判题任务数为：cpu核心数+1\n MAX_TASK_NUM=-1\n # 当前判题服务器是否开启远程虚拟判题功能\n REMOTE_JUDGE_OPEN=true\n # -1表示可接收最大远程判题任务数为：cpu核心数*2+1\n REMOTE_JUDGE_MAX_TASK_NUM=-1\n # 默认沙盒并行判题程序数为cpu核心数\n PARALLEL_TASK=default\n \n # rsync评测数据同步的配置\n # 写入主服务器ip\n RSYNC_MASTER_ADDR=\n # 与主服务器的rsync密码一致\n RSYNC_PASSWORD=voj123456\n ```\n\n3. 修改完保存，启动即可。\n\n ```shell\n docker-compose up -d\n ```\n"
},
{
"path": "docs/src/deploy/open-https.md",
"content": "# 开启HTTPS\n\n- 单机部署：\n\n 提供`server.pem`和`server.key`证书与密钥文件放置`/standAlone`目录下，与`docker-compose.yml`和`.env`文件放于同一位置，然后修改`docker-compose.yml`中的`voj-frontend`的配置\n\n- 分布式部署：\n\n 提供`server.pem`和`server.key`证书与密钥文件放置`/distributed/main`目录下，与`docker-compose.yml`和`.env`文件放置同一位置，然后修改`docker-compose.yml`中的`voj-frontend`的配置\n\n```yaml\nvoj-frontend:\n image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_frontend\n container_name: voj-frontend\n restart: always\n volumes:\n - ./html/dist:/usr/share/nginx/html\n # 开启https，请提供证书\n - ./server.pem:/etc/nginx/conf.d/cert/server.pem\n - ./server.key:/etc/nginx/conf.d/cert/server.key\n environment:\n - SERVER_NAME=localhost # 域名或localhost(本地)\n - BACKEND_SERVER_HOST=${BACKEND_HOST:-172.20.0.5} # backend后端服务地址\n - BACKEND_SERVER_PORT=${BACKEND_PORT:-6688} # backend后端服务端口号\n - USE_HTTPS=true # 使用https请设置为true\n ports:\n - \"80:80\"\n - \"443:443\"\n networks:\n voj-network:\n ipv4_address: 172.20.0.6\n```\n\n"
},
{
"path": "docs/src/deploy/update.md",
"content": "# 如何更新\n\n## 一、无二次开发的更新\n:::warning\n2021.09.21之后部署voj的请看下面操作 \n:::\n请在对应的docker-compose.yml当前文件夹下执行`docker-compose pull`拉取最新镜像，然后重新`docker-compose up -d`即可。\n\n:::warning\n2021.09.21之前部署voj的请看下面操作\n:::\n\n### 1、修改MySQL8.0默认的密码加密方式\n\n（1）进行voj-mysql容器\n\n```shell\ndocker exec -it voj-mysql bash\n```\n\n (2) 输入对应的mysql密码，进入mysql数据库\n\n 注意：-p 后面跟着数据库密码例如voj123456\n\n```shell\nmysql -uroot -p数据库密码\n```\n\n（3）成功进入后，执行以下命令\n\n```shell\nmysql> use mysql;\n\nmysql> grant all PRIVILEGES on *.* to root@'%' WITH GRANT OPTION;\n\n \nmysql> ALTER user 'root'@'%' IDENTIFIED BY '数据库密码' PASSWORD EXPIRE NEVER;\n\n \nmysql> ALTER user 'root'@'%' IDENTIFIED WITH mysql_native_password BY '数据库密码';\n\n \nmysql> FLUSH PRIVILEGES;\n```\n\n（4） 两次exit 退出mysql和容器\n\n### 2、 添加voj-mysql-checker模块\n\n（1）可以选择拉取仓库最新的docker-compose.yml文件（跟部署操作一样,但是会覆盖之前设置的参数）或者访问：\n\nhttps://github.com/simplefanc/voj-deploy/blob/master/standAlone/docker-compose.yml\n\n（2）或者编辑docker-compose.yml文件，手动添加新模块\n\n```yaml\n voj-mysql-checker:\n image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_database_checker\n container_name: voj-mysql-checker\n depends_on:\n - voj-mysql\n links:\n - voj-mysql:mysql\n environment:\n - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-voj123456}\n networks:\n voj-network:\n ipv4_address: 172.20.0.8\n```\n\n(3) 保存后重启容器即可\n\n```shell\ndocker-compose down\n\ndocker-compose pull\n\ndocker-compose up -d\n```\n\n**注意**：此次修改成功后，以后更新，都请在对应的docker-compose.yml当前文件夹下执行`docker-compose pull`拉取最新镜像，然后重新`docker-compose up -d`即可。\n\n## 二、自定义前端的更新\n\n> 附加：如何自定义前端请看这里 => [自定义前端文档](/use/update-fe.html)\n\n（1）首先到`./voj/voj-vue`文件夹中，拉取[voj-vue](https://github.com/simplefanc/voj/tree/master/voj-vue)仓库最新的代码，请注意解决出现的冲突。\n\n```shell\ngit pull\n```\n\n或者重新直接download成zip包，然后重新自定义修改前端\n\n当然，如果想查看对比主仓库更新的内容，可以用以下命令一步步合并\n\n```bash\ngit remote -v # 查看主仓库的远程仓库\ngit fetch origin master:temp # 将最新的主仓库代码拉到本地一个temp的分支\ngit diff temp # 比较现在本地代码与最新temp分支的区别\ngit merge temp # 合并temp分支到本地的master分支\ngit branch -d temp # 删除temp这个临时分支\n```\n\n（2）接着，重新用npm打包，在`./voj/voj-vue/dist`文件夹会生成静态的前端文件，放到原来指定的位置即可\n\n```shell\nnpm run build\n```\n\n（3）其它模块的更新，都请在对应的docker-compose.yml当前文件夹下执行`docker-compose pull`拉取最新镜像，然后重新`docker-compose up -d`即可。\n"
},
{
"path": "docs/src/develop/db.md",
"content": "# 数据库说明\n\n## 用户资料模块\n\nuser_info表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------- |\n| uuid | String | 主键 | uuid用户id |\n| username | String | | 登录账号 |\n| password | String | | 登录密码 |\n| nickname | String | | 用户昵称 |\n| school | String | | 学校 |\n| course | String | | 专业 |\n| number | String | | 学号 |\n| realname | String | | 真实名字 |\n| email | String | | 邮箱 |\n| gender | String | | 性别 |\n| avatar | String | | 头像图片地址 |\n| signature | String | | 个性签名 |\n| cf_username | String | | codeforces的username |\n| blog | String | | 博客地址 |\n| github | String | | github地址 |\n| title_name | String | | 称号、头衔 |\n| title_color | String | | 称号、头衔的背景颜色 |\n| status | int | | 0可用，1不可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\nsession表 \n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ---------------- |\n| id | long | 主键 | auto_increment |\n| uid | String | 外键 | 用户id |\n| user_agent | String | | 访问的浏览器参数 |\n| ip | Srting | | 访问所在的ip |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nrole 角色表 \n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------- |\n| id | long | 主键 | auto_increment |\n| role | String | | “admin”，”tourist”，“user” |\n| description | String | | 角色描述 |\n| status | int | | 是否可用,0可用 1不可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nuser_role表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| uid | String | 外键 | 用户id |\n| role_id | int | 外键 | 角色id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\n auth权限表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------------------------------------------------ |\n| id | long | 主键 | auto_increment |\n| name | String | | 权限名称，“superadmin”,”contest”，“admin”,”common” 普通用户默认为“common” |\n| permission | String | | 权限字符串,例如“contest:1001”，发布某场比赛。 “all”,”select”,”update”等等， |\n| status | int | | 0可用，1不可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\nrole_auth表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| role_id | int | | 角色id |\n| auth_id | int | | 权限id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n user_record表 个人做题记录表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ----------- | -------------------------- |\n| id | long | primary key | auto_increment |\n| uid | String | 外键 | 用户id |\n| rating | int | | Cf得分，未参加过默认为1500 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\nuser_acproblem表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ----------- | -------------- |\n| id | long | primary key | auto_increment |\n| uid | String | 外键 | 用户id |\n| pid | long | 外键 | Ac的题目id |\n| subimit_id | long | 外键 | 提交的id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\n \n\n## 题目详情模块\n\nproblem表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------------- | ------------ | ----------- | --------------------------------------------------------- |\n| id | long | primary key | auto_increment 1000开始 |\n| judge_mode | String | | 默认为default、其他值有spj、interactive |\n| problem_id | String | | 题目展示id |\n| title | String | | 题目标题 |\n| author | String | | 默认可为无 |\n| type | int | | 题目类型 0为ACM,1为OI |\n| time_limit | int | | 时间限制(ms)，默认为c/c++限制,其它语言为2倍 |\n| memory_limit | int | | 空间限制(mb)，默认为c/c++限制,其它语言为2倍 |\n| stack_limit | int | | 栈限制(mb)，默认为128 |\n| description | String | | 内容描述 |\n| input | String | | 输入描述 |\n| output | String | | 输出描述 |\n| examples | Srting | | 题面输入输出样例，不纳入评测数据 |\n| source | int | | 题目来源（比赛id），默认为voj,可能为爬虫vj |\n| difficulty | int | | 题目难度，0简单，1中等，2困难 |\n| hint | String | | 备注 提醒 |\n| auth | int | | 默认为1公开，2为私有，3为比赛中。 |\n| io_score | int | | 当该题目为io题目时的分数 默认为100 |\n| code_share | boolean | | 该题目对应的相关提交代码，用户是否可用分享 |\n| spj_code | String | | 特判或交互程序代码 |\n| spj_language | String | | 特判或交互程序的语言 |\n| user_extra_file | String | | 选手程序的额外文件 json key：文件名 value：文件内容 |\n| judge_extra_file | String | | 特判或交互程序的额外文件 json key：文件名 value：文件内容 |\n| is_remove_end_blank | boolean | | 是否默认去除用户代码的文末空格 |\n| open_case_result | boolean | | 是否默认开启该题目的测试样例结果查看 |\n| caseVersion | String | | 题目测试数据的版本号 |\n| is_upload_case | boolean | | 是否是上传zip评测数据的 |\n| modified_user | String | | 最新修改题目的用户 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\nproblem_case表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ----------- | -------------------- |\n| id | long | primary key | auto_increment |\n| pid | long | 外键 | 题目id |\n| input | String | | 测试样例的输入文件名 |\n| output | String | | 测试样例的输出文件名 |\n| status | String | | 状态0可用，1不可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ntag表 题目表的标签\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| name | String | | 标签名字 |\n| color | String | | 标签颜色 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nproblem_tag表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------- |\n| id | int | | 主键id |\n| tid | int | | 标签id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\nlanguage表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| --------------- | ------------ | ---- | ---------------------------- |\n| id | long | | 主键id |\n| content_type | String | | 语言类型 |\n| description | String | | 语言描述 |\n| name | String | | 语言名字 |\n| compile_command | String | | 编译指令 |\n| template | String | | A+B题目模板 |\n| code_template | String | | 语言对应的代码模板 |\n| is_spj | boolean | | 是否可作为特殊判题的一种语言 |\n| oj | String | | 该语言属于哪个oj，自身oj用ME |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncode_template表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------- |\n| id | long | | 主键id |\n| pid | long | 外键 | 题目id |\n| lid | long | 外键 | 语言id |\n| code | String | | 代码模板 |\n| status | boolean | | 是否启用 |\n| gmt_create | datetime | | 修改时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n## 提交评测模块\n\n> 判题结果status\n\n未提交：STATUS_NOT_SUBMITTED = -10\n\n提交中：STATUS_SUBMITTING = 9\n\n排队中：STATUS_PENDING = 6\n\n评测中：STATUS_JUDGING = 7\n\n编译错误：STATUS_COMPILE_ERROR = -2\n\n输出格式错误：STATUS_PRESENTATION_ERROR = -3\n\n答案错误：STATUS__WRONG_ANSWER = -1\n\n评测通过：STATUS_ACCEPTED = 0\n\ncpu时间超限：STATUS__CPU_TIME_LIMIT_EXCEEDED = 1\n\n真实时间超限：STATUS__REAL_TIME_LIMIT_EXCEEDED = 2\n\n空间超限：STATUS__MEMORY_LIMIT_EXCEEDED = 3\n\n运行错误：STATUS__RUNTIME_ERROR = 4\n\n系统错误：STATUS__SYSTEM_ERROR = 5\n\nOI评测部分通过：STATUS_PARTIAL_ACCEPTED = 8\n\n提交失败：STATUS_SUBMITTED_FAILED= 10\n\njudge表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------- | ------------ | ----------- | -------------------------------- |\n| submit_id | long | primary key | auto_increment |\n| display_pid | String | | 题目展示id |\n| pid | long | 外键 | 题目id |\n| uid | String | 外键 | 提交用户的id |\n| username | String | 外键 | 用户名 |\n| submit_time | datetime | | 提交时间 |\n| status | String | | 判题结果 |\n| share | Boolean | | 代码是否分享 |\n| error_message | String | | 错误提醒（编译错误，或者vj提醒） |\n| time | int | | 运行时间 |\n| memory | int | | 所耗内存 |\n| length | int | | 代码长度 |\n| code | String | | 代码 |\n| language | String | | 代码语言 |\n| cpid | int | | 比赛中的题目编号id |\n| judger | String | | 判题机ip |\n| ip | String | | 提交者ip |\n| cid | int | | 题目来源的比赛id，默认为0 |\n| version | int | | 乐观锁（废弃） |\n| oi_rank_score | int | | oi排行榜得分 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\njugde_case表 评测单个样例结果表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ---------------- |\n| submit_id | long | 外键 | 提交id |\n| problemId | String | 外键 | 题目id |\n| userId | String | 外键 | 提交用户的id |\n| Status | String | | 单个样例评测结果 |\n| time | int | | 运行时间 |\n| memory | int | | 运行内存 |\n| case_id | String | | 测试样例id |\n| input_data | String | | 样例输入的文件名 |\n| Output_data | String | | 样例输出的文件名 |\n| user_output | Srting | | 暂时用作信息提示 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\n \n\n## 比赛模块\n\n更新比赛状态的存储过程\n\n ```sql\nDELIMITER |\n\nDROP PROCEDURE IF EXISTS contest_status |\nCREATE PROCEDURE contest_status()\n\n BEGIN\n UPDATE contest \n\tSET STATUS = (\n\tCASE \n\t WHEN NOW() < start_time THEN -1 \n\t WHEN NOW() >= start_time AND NOW()= end_time THEN 1\n\tEND);\n END\n|\n\n ```\n\n\n\n创建插入时的触发器\n\n```sql\nDROP TRIGGER IF EXISTS contest_trigger;\n\nDELIMITER $$\nCREATE TRIGGER contest_trigger\nBEFORE INSERT ON contest FOR EACH ROW\nBEGIN\nSET new.status=(\n\tCASE \n\t WHEN NOW() < new.start_time THEN -1 \n\t WHEN NOW() >= new.start_time AND NOW()= new.end_time THEN 1\n\tEND);\nEND$$\nDELIMITER ;\n```\n\n\n\n设置定时器\n\n```sql\nSET GLOBAL event_scheduler = 1; // 开启定时器\nCREATE EVENT IF NOT EXISTS contest_event\n\nON SCHEDULE EVERY 1 SECOND // 每秒执行一次\n\nON COMPLETION PRESERVE \n\nDO CALL contest_status(); // 调用存储过程\n```\n\n开启或关闭定时器\n\n```sql\nALTER EVENT contest_event ON COMPLETION PRESERVE ENABLE; -- 开启事件\nALTER EVENT contest_event ON COMPLETION PRESERVE DISABLE; -- 关闭事件\n```\n\n\n\ncontest表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------------ | ------------ | ---- | ----------------------------------------------------- |\n| id | long | 主键 | auto_increment 1000起步 |\n| uid | String | 外键 | 创建者id |\n| author | String | | 比赛创建者的用户名 |\n| title | String | | 比赛标题 |\n| type | int | | ACM赛制或者Rating |\n| source | int | | 比赛来源，原创为0，克隆赛为比赛id |\n| auth | int | | 0为公开赛，1为私有赛（有密码），3为保护赛（有密码）。 |\n| pwd | string | | 比赛密码 |\n| start_time | datetime | | 开始时间 |\n| end_time | datetime | | 结束时间 |\n| duration | long | | 比赛时长（s） |\n| description | Srting | | 比赛说明 |\n| seal_rank | boolean | | 是否开启封榜 |\n| seal_rank_time | datetime | | 封榜起始时间，一直到比赛结束，不刷新榜单。 |\n| status | int | | -1为未开始，0为进行中，1为已结束 |\n| visible | boolean | | 是否可见 |\n| open_print | boolean | | 是否打开打印功能 |\n| open_account_limit | boolean | | 是否开启账号限制 |\n| account_limit_rule | String | | 账号限制规则 |\n| rank_show_name | String | | 排行榜显示（username、nickname、realname） |\n| star_account | Stirng | | 打星用户列表 |\n| open_rank | boolean | | 是否开放赛外榜单 |\n| auto_real_rank | boolean | | 比赛结束是否自动解除封榜,自动转换成真实榜单 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncontest_problem表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------- | ------------ | ---- | ---------------------------------- |\n| id | long | 主键 | auto_increment |\n| display_id | String | | 展示的id |\n| cid | long | 外键 | 比赛id |\n| pid | long | 外键 | 题目id |\n| display_title | String | | 该题目在比赛中的标题，默认为原名字 |\n| color | String | | 气球颜色，不设置则不显示 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncontest_register表 比赛报名表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------- |\n| id | long | 主键 | auto_increment |\n| cid | long | 外键 | 比赛id |\n| uid | String | 外键 | 用户id |\n| status | int | | 默认为0表示正常，1为失效。 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ncontest_score表 rating赛制中获得的分数更改记录表（未使用）\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ----------------- |\n| id | long | 主键 | auto_increment |\n| cid | long | 外键 | 比赛id |\n| last | int | | 比赛前的score得分 |\n| change | int | | Score比分变化 |\n| now | int | | 现在的score |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncontest_record表 比赛记录表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------------------------------------------------ |\n| id | long | 主键 | auto_increment |\n| cid | long | 外键 | 比赛id |\n| uid | String | 外键 | 用户id |\n| pid | int | 外键 | 题目id |\n| cpid | int | 外键 | 比赛中的题目id |\n| submit_id | int | 外键 | 提交id，用于可重判 |\n| display_id | String | | 比赛展示的id |\n| username | String | | 用户名 |\n| realname | String | | 真实姓名（废弃） |\n| status | int | | 提交结果，0表示未AC通过不罚时，1表示AC通过，-1为未AC通过算罚时 |\n| submit_time | datetime | | 具体提交时间 |\n| time | int | | 提交时间，为提交时间减去比赛时间，时间戳 |\n| score | int | | OI比赛得分 |\n| use_time | int | | 提交的程序运行耗时 |\n| first_blood | Boolean | | 是否为一血AC（废弃） |\n| checked | Boolean | | AC是否已校验 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncontest_print表 比赛打印表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------ |\n| id | long | 主键 | auto_increment |\n| cid | long | 外键 | 比赛id |\n| username | String | | 提交打印文本的用户 |\n| realname | String | | 真实姓名 |\n| content | String | | 需要打印的文本内容 |\n| status | int | | 状态 是否已打印 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nannouncement表 \n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ---------------------------------------------- |\n| id | long | 主键 | auto_increment |\n| title | String | | 公告标题 |\n| content | String | | 公告内容 |\n| uid | String | 外键 | 发布者id（必须为比赛创建者或者超级管理员才能） |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ncontest_announcement表 比赛时的通知表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| aid | long | 外键 | 公告id |\n| cid | int | 外键 | 比赛id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\ncontest_explanation表 赛后题解表**(未使用)**\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------------------------- |\n| id | long | 主键 | auto_increment |\n| cid | int | 外键 | 比赛id |\n| content | String | | 内容(支持markdown) |\n| uid | int | | 发布者（必须为比赛创建者或者超级管理员才能） |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\n## 训练(题单)模块\n\n题单训练表 training\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | --------------------------------- |\n| id | long | 主键 | |\n| title | string | | 训练题单名称 |\n| description | string | | 训练题单简介 |\n| author | string | 外键 | 训练题单创建者用户名 |\n| auth | string | | 训练题单权限类型：Public、Private |\n| private_pwd | string | | 训练题单权限为Private时的密码 |\n| rank | int | | 编号，升序 |\n| status | boolean | | 是否可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n训练注册表 training_register\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------- |\n| id | long | 主键 | |\n| tid | long | 外键 | 训练id |\n| uid | long | 外键 | 用户id |\n| status | boolean | | 是否可用 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n训练与题目关联表 training_problem\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------- |\n| id | long | 主键 | |\n| tid | long | 外键 | 训练id |\n| pid | long | 外键 | 题目id |\n| display_id | string | | 排序用 展示id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n训练记录表 training_record\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ---------- |\n| id | long | 主键 | |\n| tid | long | 外键 | 训练id |\n| tpid | long | 外键 | 训练题目id |\n| pid | long | 外键 | 题目id |\n| uid | string | 外键 | 用户id |\n| submit_id | long | 外键 | 提交id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n训练分类表 training_category\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------ |\n| id | long | 主键 | |\n| name | string | | 分类名称 |\n| color | string | | 分类背景颜色 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n训练分类关联表 mapping_training_category\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------------------- |\n| id | long | 主键 | |\n| tid | long | 外键 | 训练id |\n| cid | long | 外键 | 训练分类id（training_category） |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n \n\n## 讨论模块\n\n> 包括题目讨论区，公共讨论区，比赛评论\n\n\n\ncategory表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| name | String | | 分类名字 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ndiscussion表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------------- |\n| id | int | 主键 | auto_increment |\n| category_id | int | 外键 | 分类id |\n| title | String | 外键 | 讨论标题 |\n| content | String | | 讨论详情 |\n| description | String | | 讨论描述 |\n| pid | String | 外键 | 引用的题目id，默认未null则不引用 |\n| uid | iString | 外键 | 发布讨论的用户id |\n| author | String | 外键 | 发布讨论的用户名 |\n| avatar | String | 外键 | 发布讨论的用户头像地址 |\n| role | String | | 发布讨论的用户角色 |\n| view_num | int | | 浏览数量 |\n| like_num | int | | 点赞数量 |\n| top_priority | boolean | | 优先级，是否置顶 |\n| comment_num | int | | 评论数量 |\n| status | int | | 是否封禁或逻辑删除该讨论 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ndiscussion_like表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| did | int | 外键 | 讨论id |\n| uid | String | 外键 | 用户id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ndiscussion_report表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | long | 主键 | auto_increment |\n| did | int | 外键 | 讨论id |\n| reporter | String | 外键 | 举报者的用户名 |\n| content | String | | 举报内容 |\n| status | boolean | | 是否已读 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ncomment表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------------------- |\n| id | int | 主键 | auto_increment |\n| cid | long | 外键 | 比赛id，NULL表示无引用比赛 |\n| did | int | 外键 | 讨论id，NULL表示无引用讨论 |\n| content | String | | 评论内容 |\n| from_uid | String | 外键 | 评论者id |\n| from_name | String | 外键 | 评论者用户名 |\n| from_avatar | String | 外键 | 评论者头像地址 |\n| from_role | String | 外键 | 评论者角色 |\n| like_num | int | | 点赞数量 |\n| status | int | | 是否封禁或逻辑删除该评论，0正常，1封禁 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\ncomment_like表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------- |\n| id | lint | 主键 | auto_increment |\n| cid | int | 外键 | 评论id |\n| uid | String | 外键 | 用户id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nreply表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | -------------------------------------- |\n| id | int | 主键 | auto_increment |\n| comment_id | ind | 外键 | 评论id |\n| content | String | | 回复的内容 |\n| from_uid | String | 外键 | 回复评论者id |\n| from_name | String | 外键 | 回复评论者用户名 |\n| from_avatar | String | 外键 | 回复评论者头像地址 |\n| from_role | String | 外键 | 回复评论者角色 |\n| to_uid | String | 外键 | 被回复的用户id |\n| to_name | String | 外键 | 被回复的用户名 |\n| to_avatar | String | 外键 | 被回复的用户头像地址 |\n| status | int | | 是否封禁或逻辑删除该回复，0正常，1封禁 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\n## 站内消息模块\n\nadmin_sys_notice表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------------------------------------------------ |\n| id | int | 主键 | auto_increment |\n| title | String | | 通知标题 |\n| content | String | | 通知内容 |\n| type | String | | 发给哪些用户类型,例如全部用户All，指定单个用户Single，管理员Admin |\n| state | boolean | | 是否已被拉取过，如果已经拉取过，就无需再次拉取 |\n| recipient_id | String | 外键 | 接受通知的用户的id，如果type为single，那么recipient 为该用户的id;否则recipient为null |\n| admin_id | String | 外键 | 发布通知的管理员id |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\nuser_sys_notice表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------- | ------------ | ---- | ----------------------------------- |\n| id | int | 主键 | auto_increment |\n| sys_notice_id | long | 外键 | 系统通知的id |\n| recipient_id | String | 外键 | 接受通知的用户的id |\n| type | String | | 消息类型，系统通知Sys、我的信息Mine |\n| state | boolean | | 是否已读 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n\n\nmsg_remind表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| -------------- | ------------ | ---- | ------------------------------------------------------------ |\n| id | int | 主键 | auto_increment |\n| action | String | | 动作类型，如点赞讨论帖Like_Post、点赞评论Like_Discuss、评论Discuss、回复Reply等 |\n| source_id | int | | 消息来源id，讨论id或比赛id |\n| source_type | String | | 事件源类型：'Discussion'、'Contest'等 |\n| source_content | String | | 事件源的内容，比如回复的内容，回复的评论等等,不超过250字符，超过使用... |\n| quote_id | int | | 事件引用上一级评论或回复id |\n| quote_type | String | | 事件引用上一级的类型：Comment、Reply |\n| url | String | | 事件所发生的地点链接 url |\n| recipient_id | String | 外键 | 接受通知的用户的id |\n| sender_id | String | 外键 | 动作执行者的id |\n| state | boolean | | 是否已读 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n## 文件模块\n\nfile表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------------ |\n| id | long | 主键 | auto_increment |\n| uid | String | | 用户id |\n| name | String | | 文件名 |\n| suffix | String | | 文件后缀格式 |\n| folder_path | String | | 文件所在文件夹的路径 |\n| file_path | String | | 文件绝对路径 |\n| type | String | | 文件所属类型，例如avatar |\n| delete | String | | 是否删除 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\n## 判题机模块\n\njudge_server表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| --------------- | ------------ | ---- | ------------------------------------------------ |\n| id | int | 主键 | auto_increment |\n| name | String | | 判题服务名字 |\n| ip | String | | 判题机ip |\n| port | int | | 判题机端口号 |\n| url | String | | ip:port |\n| cpu_core | int | | 判题机所在服务器cpu核心数 |\n| task_number | int | | 当前判题数 |\n| max_task_number | int | | 判题并发最大数 |\n| status | int | | 0可用，1不可用 |\n| version | long | | 版本控制 |\n| is_remote | boolean | | 是否为远程判题vj |\n| cf_submittable | boolean | | 当前机器是否可提交cf，控制机器一次只能一账号交题 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n\nremote_judge_account表\n\n| 列名 | 实体属性类型 | 键 | 备注 |\n| ------------ | ------------ | ---- | ------------------ |\n| id | int | 主键 | auto_increment |\n| oj | String | | vjudge交题的oj名字 |\n| username | String | | vjudge登录的账号 |\n| password | int | | vjudge登录的密码 |\n| status | int | | 0可用，1不可用 |\n| version | long | | 版本控制 |\n| gmt_create | datetime | | 创建时间 |\n| gmt_modified | datetime | | 修改时间 |\n"
},
{
"path": "docs/src/develop/judge_dispatcher.md",
"content": "# 调度与评测\n\n\n\n**评测的调用流程有如下步骤：**\n\n1. 用户登录后进入指定题目的详情页，编辑完代码后提交；\n2. 后端业务服务接收到提交信息后，校验提交数据后写入到MySQL数据库；\n3. 写入数据库成功后，将该评测任务放入到Redis的等待评测队列中，然后返回告知用户已经成功提交；\n4. 接着取出Redis中的等待评测队列头部的任务，查询Nacos获取健康可用的评测服务实例列表，通过悲观锁控制并发资源的调度，发送评测请求到有空闲评测资源的评测服务实例；\n5. 评测服务接受到调用评测请求后，将通过Http请求先后调用安全沙盒（Go-Judge）进行用户代码的编译与运行，根据每个评测点数据的运行结果，得出最终评测结果写回到数据库。\n6. 在这个过程中，用户在题目详情页提交成功代码后，前端页面将开启每2秒查询一次结果的定时器，直至该提交的评测的最终状态不再是评测中结束。\n\n:::tip\n\nVOJ有四种评测模式：普通评测、特殊评测、交互评测、远程评测，具体的介绍请看文档： [判题模式](/use/judge-mode/)\n\n:::\n\n### 一、普通评测\n\n\n\n**普通评测**：先调用安全沙盒服务编译用户提交的代码，如果编译失败则直接结束，返回结果为编译失败，接着调用安全沙盒服务运行用户程序，传入题目标准输入文件的文件路径、题目运行时间限制、题目运行空间限制等参数，等待每个数据点的评测结束，比较每个数据点的时间和空间是否超过题目规定的时空限制，然后对比用户程序输出和题目标准输出得出最终的评测结果，写回数据库。\n\n### 二、特殊评测\n\n\n\n**特殊评测**：先调用安全沙盒服务编译用户提交的代码，如果编译失败则直接结束，返回结果为编译失败，然后检查是否存在已经编译完成的特殊程序，否则需要先调用服务编译该特殊程序代码，如果编译失败，则返回结果为系统错误。接着运行用户程序读取每个标准输入文件，获得结果，判断时空是否超限，超限就返回时间超限或空间超限的结果，不然就运行特殊程序读取题目标准输入和标准输出、用户程序的输出文件，对比后得出评测结果，写回数据库。\n\n### 三、交互评测\n\n\n\n**交互评测**：先调用安全沙盒服务编译用户提交的代码，如果编译失败则直接结束，返回结果为编译失败，然后检查是否存在已经编译完成的交互程序，否则需要先调用服务编译该交互程序代码，如果编译失败，则返回结果为系统错误。接着运行用户程序和交互程序，两者程序进行标准输出和标准输入流的交互，最后得出结果，写回数据库。\n\n### 四、远程评测\n\n\n\n**远程评测**: 目前本系统支持CF、HDU、POJ等平台的题目评测，主要实现的原理是爬虫模拟技术，首先先使用远程平台的账户登录，获取登录账户的cookie，配置到提交代码的接口参数里面，同时填入用户提交的代码、对应的题号、编译语言等信息，请求提交结果后可能失败，这时候需要设置重试机制，但多次重试依旧提交失败，则直接将结果写回数据库，如果获取到该提交对应的ID，则将该ID交给任务线程池进行每3秒一次的查询结果轮询，如果超过3分钟没有得出结果，则判断为提交失败写回数据库，否则就根据结果映射转换成自己平台的结果写回数据库。\n"
},
{
"path": "docs/src/develop/sandbox.md",
"content": "# 安全沙盒的调用\n\n> Judger-SandBox使用的是开源项目[go-judge](https://github.com/criyle/go-judge)Linux版本的可执行文件，更多调用方式请自行浏览[go-judge](https://github.com/criyle/go-judge)\n\nVOJ使用Java来调用此沙盒，详见[voj-judger](https://github.com/simplefanc/voj-springboot/blob/main/voj-judger/src/main/java/com/simplefanc/voj/judger/judge/local)模块下的`SandboxRun.java`\n\n启动[SandBox](https://github.com/criyle/go-judge/releases)，默认监听5050端口\n\n### 验证是否启动\n\n访问：`http://localhost:5050/version`\n\n### 编译\n\n1.1 请求的url为 \n\n> `http://localhost:5050/run`\n\n1.2 请求方式\n\n> POST\n\n1.3 请求参数\n\n> 数据格式为json，内容如下\n\n```shell\n {\n \"cmd\": [\n {\n \"args\": [\n \"/usr/bin/g++\", \n \"a.cc\", \n \"-o\", \n \"a\"\n ], \n \"env\": [\n \"PATH=/usr/bin:/bin\"\n ], \n \"files\": [\n {\n \"content\": \"\"\n }, \n {\n \"name\": \"stdout\", \n \"max\": 10240\n }, \n {\n \"name\": \"stderr\", \n \"max\": 10240\n }\n ], \n \"cpuLimit\": 10000000000, \n \"memoryLimit\": 104857600, \n \"procLimit\": 50, \n \"copyIn\": {\n \"a.cc\": {\n \"content\": \"#include \\nusing namespace std;\\nint main() {\\nint a, b;\\ncin >> a >> b;\\ncout << a + b << endl;\\n}\"\n }\n }, \n \"copyOut\": [\n \"stdout\", \n \"stderr\"\n ], \n \"copyOutCached\": [\n \"a.cc\", \n \"a\"\n ], \n \"copyOutDir\": \"1\"\n }\n ]\n}\n```\n\n1.4 返回的数据为json格式\n\n```json\n [\n {\n \"status\": \"Accepted\",\n \"exitStatus\": 0,\n \"time\": 303225231,\n \"memory\": 32243712,\n \"runTime\": 524177700,\n \"files\": {\n \"stderr\": \"\",\n \"stdout\": \"\"\n },\n \"fileIds\": {\n \"a\": \"WDQL5TNLRRVB2KAP\",\n \"a.cc\": \"NOHPGGDTYQUFRSLJ\"\n }\n }\n ]\n```\n\n### 运行与评测\n\n2.1 请求的url为 \n\n> `http://localhost:5050/run`\n\n2.2 请求方式\n\n> POST\n\n2.3 请求参数\n\n> 数据格式为json，内容如下\n\n```json\n{\n \"cmd\": [{\n \"args\": [\"a\"],\n \"env\": [\"PATH=/usr/bin:/bin\",\"LANG=en_US.UTF-8\",\"LC_ALL=en_US.UTF-8\",\"LANGUAGE=en_US:en\"],\n \"files\": [{\n \"src\": \"/judge/test_case/problem_1010/1.in\"\n }, {\n \"name\": \"stdout\",\n \"max\": 10240\n }, {\n \"name\": \"stderr\",\n \"max\": 10240\n }],\n \"cpuLimit\": 10000000000,\n \"realCpuLimit\":30000000000,\n \"stackLimit\":134217728,\n \"memoryLimit\": 104811111,\n \"procLimit\": 50,\n \"copyIn\": {\n \"a\":{\"fileId\":\"WDQL5TNLRRVB2KAP\"}\n },\n \"copyOut\": [\"stdout\", \"stderr\"]\n }]\n}\n```\n\n2.4 返回的数据为json格式\n\n```json\n[{\n \"status\": \"Accepted\",\n \"exitStatus\": 0,\n \"time\": 3171607,\n \"memory\": 475136,\n \"runTime\": 110396333,\n \"files\": {\n \"stderr\": \"\",\n \"stdout\": \"23\\n\"\n }\n}]\n```\n\n### 交互判题\n\n3.1 请求的url为 \n\n> `http://localhost:5050/run`\n\n3.2 请求方式\n\n> POST\n\n3.3 请求参数\n\n> 数据格式为json，内容如下\n\n```json\n {\n\"pipeMapping\": [\n {\n \"in\": {\n \"max\": 16777216,\n \"index\": 0,\n \"fd\": 1\n },\n \"out\": {\n \"index\": 1,\n \"fd\": 0\n }\n }\n],\n\"cmd\": [\n {\n \"stackLimit\": 134217728,\n \"cpuLimit\": 3000000000,\n \"realCpuLimit\": 9000000000,\n \"clockLimit\": 64,\n \"env\": [\n \"LANG=en_US.UTF-8\",\n \"LANGUAGE=en_US:en\",\n \"LC_ALL=en_US.UTF-8\",\n \"PYTHONIOENCODING=utf-8\"\n ],\n \"copyOut\": [\n \"stderr\"\n ],\n \"args\": [\n \"/usr/bin/python3\",\n \"main\"\n ],\n \"files\": [\n {\n \"src\": \"/judge/test_case/problem_1002/5.in\"\n },\n null,\n {\n \"max\": 16777216,\n \"name\": \"stderr\"\n }\n ],\n \"memoryLimit\": 536870912,\n \"copyIn\": {\n \"main\": {\n \"fileId\": \"CGTRDEMKW5VAYN6O\"\n }\n }\n },\n {\n \"stackLimit\": 134217728,\n \"cpuLimit\": 8000000000,\n \"clockLimit\": 24000000000,\n \"env\": [\n \"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin\",\n \"LANG=en_US.UTF-8\",\n \"LANGUAGE=en_US:en\",\n \"LC_ALL=en_US.UTF-8\"\n ],\n \"copyOut\": [\n \"stdout\",\n \"stderr\"\n ],\n \"args\": [\n \"/w/spj\",\n \"/w/tmp\"\n ],\n \"files\": [\n null,\n {\n \"max\": 16777216,\n \"name\": \"stdout\"\n },\n {\n \"max\": 16777216,\n \"name\": \"stderr\"\n }\n ],\n \"memoryLimit\": 536870912,\n \"copyIn\": {\n \"spj\": {\n \"src\": \"/judge/spj/1002/spj\"\n },\n \"tmp\": {\n \"src\": \"/judge/test_case/problem_1002/5.out\"\n }\n },\n \"procLimit\": 64\n }\n]\n```\n\n3.4 返回的数据为json格式\n\n```json\n[\n {\n \"status\": \"Accepted\",\n \"exitStatus\": 0,\n \"time\": 1545123,\n \"memory\": 253952,\n \"runTime\": 4148800,\n \"files\": {\n \"stderr\": \"\"\n },\n \"fileIds\": {}\n },\n {\n \"status\": \"Accepted\",\n \"exitStatus\": 0,\n \"time\": 1501463,\n \"memory\": 253952,\n \"runTime\": 5897700,\n \"files\": {\n \"stderr\": \"\",\n \"stdout\": \"\"\n },\n \"fileIds\": {}\n }\n]\n```\n"
},
{
"path": "docs/src/develop/update-fe.md",
"content": "# 自定义前端\n\n直接下载[voj-vue](https://github.com/simplefanc/voj-vue)\n\n修改后，使用`npm run build`，生成一个dist文件夹，结构如下：\n\n```\ndist\n├── index.html\n├── favicon.ico\n└── assets\n ├── css\n │ ├── ....\n ├── fonts\n │ ├── ....\n ├── img\n │ ├── ....\n ├── js\n │ ├── ....\n\n....\n....\n```\n\n将 `dist` 文件夹复制到服务器上某个目录下，比如 `/voj/www/html/dist`，然后修改 `docker-compose.yml`，在 `voj-frontend` 模块中的 `volumes` 中增加一行 `- /voj/www/html/dist:/usr/share/nginx/html` （冒号前面的请修改为实际的路径），然后 `docker-compose up -d` 即可。\n"
},
{
"path": "docs/src/introduction/README.md",
"content": "# 简介\n\n## 一、什么是 VOJ？\n\nVOJ，全称 Virtual Online Judge，是基于（Spring Cloud + Vue）前后端分离、分布式架构的在线测评系统。\n\n## 二、VOJ的特点\n:::tip\n - 适应：响应式布局，支持手机端\n - 设计：界面简约大方\n - 安全：判题使用 Cgroups 隔离用户程序，杜绝卡评测；网站权限控制完善\n - 扩展：支持分布式判题\n - 简单：网站配置高度集中\n - 功能：\n - 支持 ACM、OI 题目及比赛，比赛拥有外榜、打星队伍、关注队伍等功能\n - 拥有讨论区、题目讨论、比赛讨论、同时拥有站内消息系统\n - 支持私有训练、公开训练（题单）\n - 支持私有团队、公开团队、保护团队\n - 支持 testlib 的特殊判题\n - 支持交互判题\n - 多样：支持本地判题服务，也支持其它知名OJ（HDU、POJ、MXT、JSK）题目的远程判题\n:::\n"
},
{
"path": "docs/src/introduction/architecture.md",
"content": "# 系统设计\n\n## 一、技术选型\n\n本系统的项目后端基于 Spring Boot、Spring Cloud Alibaba 框架，数据库使用 MySQL，缓存中间件使用 Redis，数据操作框架使用 Mybatis-Plus，前端基于 Vue2 进行开发，使用 Axios 与后端进行交互，做到真正的前后端分离开发，程序评测运行使用开源的Go-Judge 安全沙盒保证程序的高性能判题和系统的安全防护。使用Docker 和 Docker-Compose 进行服务编排与部署，做到真正的一键化部署。\n\n**前端技术：**\n\n:::tip\n\n- 技术以Vue2为主，element-ui为主要的UI框架\n- 支持手机端，响应式布局\n- 以CodeMirror作为在线代码编辑器\n- 以Mavon-Editor作为富文本编辑器\n- 以Vxe-Table作为表格组件\n\n:::\n\n**后端技术：**\n\n:::tip\n\n*voj-backend（数据服务）*\n\n- 主体Web框架技术以SpringBoot为主\n- 以Nacos为分布式注册中心及分布式配置中心，支持配置文件动态刷新\n- 以Mybatis-Plus为数据库中间件，负责数据实体类与数据库数据的转化与获取\n- 以Shiro为安全框架，支持用户角色权限管理，支持token刷新\n- 以Redis作为数据缓存和使用list作为等待评测队列\n\n:::\n\n**评测端技术：**\n\n:::tip\n\n*voj-judger（评测服务）*\n\n- 主体Web框架技术以SpringBoot为主\n- 以Mybatis-Plus为数据库中间件，负责数据实体类与数据库数据的转化与获取\n- 将服务注册到Nacos，以供voj-backend进行调度，同时获取到Nacos上的配置\n\n- 本地评测：\n - 主流程：调用SandBox（Go-Judge）进行评测，将对应结果写回数据库\n - 功能：支持普通评测、特殊评测、交互评测\n- 远程评测：\n - 提交流程：通过爬虫技术将代码提交到HDU、POJ等平台，获取提交id\n - 获取结果：根据提交id多次轮询获取最终的评测结果，将对应结果写回数据库\n\n:::\n\n## 二、整体架构\n\n:::info\n\n本系统是基于前后端分离、分布式架构搭建的，用户通过浏览器进行访问，请求发送到Nginx被代理转发到Vue项目生成的静态文件，Vue项目的后端数据请求则再次通过Nginx进行转发到后端业务服务，由后端业务服务查询MySQL数据、Redis缓存进行业务处理生成所需JSON数据返回给前端，由Vue进行渲染展示给用户。\n\n:::\n\n此外，如果用户提交了评测请求，则业务服务将通过Nacos查询健康可用的评测服务实例，将请求发送给指定的评测服务，评测服务则将进行评测操作，调用安全沙盒，编译运行用户代码，跑各个评测点数据得出最终结果，写回数据库。整个系统各个服务都是在Ubuntu系统下基于Docker来搭建的，保证各个服务之间互不干扰。\n\n\n\n## 三、功能介绍\n\n| 模块 | 功能介绍 |\n| -------------- | :----------------------------------------------------------: |\n| 首页 | 展示公告栏、近期比赛栏、最近7天做题排名栏 |\n| 题目 | 提供展示题目列表页，可以根据题库、难度、标签等进行筛选查询，同时展示各个题目的做题情况；提供展示题目详情页，可以看到题目内容，在线编写代码，查看当前用户对于该题的历史提交记录 |\n| 训练 | 提供展示训练列表页，可以根据权限、分类进行筛选查询，进入指定训练页，可以查看到训练的介绍、训练的题目单以及训练记录单 |\n| 比赛 | 提供展示类型为ACM和OI的比赛列表页，可以根据类型与比赛状态进行筛选查询，同时展示比赛的标题、时间、时长、类型、参赛人数等信息；进入指定比赛，可以看到比赛题目、比赛提交列表、排行榜、比赛公告、评论，以及比赛管理员可以选择重新评测某个比赛题目、提供现场打印代码的功能 |\n| 评测 | 用户可以看到所有的提交记录列表，可以通过状态、题目ID、提交者进行筛选过滤 |\n| 排名 | 分为ACM排行榜和OI排行榜，分别根据对应ACM题目和OI题目提交情况对用户进行排名展示 |\n| 讨论 | 提供讨论列表页，可以看到各个分类的讨论帖子，同时也可以发布用户自己的讨论；点击指定的讨论帖子，即可看到帖子详情，在下方可以对讨论进行评论以及回复他人的评论 |\n| 关于 | 本网站各个编程语言的编译介绍 |\n| 个人信息与设置 | 用户拥有自己的个人主页，可以展示用户的学校、名称、个人简介、做题数和得分等信息；同时登陆状态可以在右上角进入个人设置，可以修改密码和邮箱，以及各种个人信息 |\n| 登录与注册 | 用户可以通过点击导航栏右上角选择登录、注册、重置密码，即可完成对用户的鉴权 |\n| 站内消息 | 提供消息自动查询，每两分钟更新最新消息来提示用户，进入消息中心，可以看到评论我的、回复我的、收到的赞、系统通知、我的消息等模块的消息 |\n"
},
{
"path": "docs/src/monomer/backend.md",
"content": "# 后端部署\n\n## 前言\n\n下载本项目，进入到当前文件夹执行打包命令\n\n```shell\ngit clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/src/backend\n```\n\n当前文件夹为打包`voj-backend`镜像的相关文件，将这些文件复制到同一个文件夹内，**然后打包[voj-backend](https://github.com/simplefanc/voj-springboot/tree/main/voj-backend)（SpringBoot项目）成jar包也放到当前文件夹**，之后执行以下命令进行打包成镜像\n\n```shell\ndocker build -t voj-backend .\n```\n\n**项目依赖于`voj-redis`，`voj-nacos`，`voj-mysql`等镜像成功启动，以及根据前面三个镜像的配置修改环境参数才可正常启动**\n\ndocker-compose 启动\n\n```yaml\nversion: \"3\"\nservices:\n voj-backend:\n# image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_backend\n\timage: voj-backend\n container_name: voj-backend\n restart: always\n depends_on:\n - voj-redis\n - voj-mysql\n - voj-nacos\n volumes:\n - ./voj/file:/voj/file\n - ./voj/testcase:/voj/testcase\n - ./voj/log/backend:/voj/log/backend\n environment:\n - TZ=Asia/Shanghai\n - BACKEND_SERVER_PORT=6688 # backend服务端口号\n - NACOS_URL=172.20.0.4:8848 # voj-nacos的url\n - NACOS_USERNAME=root # nacos的管理员账号\n - NACOS_PASSWORD=voj123456 # nacos的管理员密码\n - JWT_TOKEN_SECRET=default # 加密秘钥 默认则生成32位随机密钥\n - JWT_TOKEN_EXPIRE=86400 # token过期时间默认为24小时 86400s\n - JWT_TOKEN_FRESH_EXPIRE=43200 # token默认12小时可自动刷新\n - JUDGE_TOKEN=default # 调用判题服务器的token 默认则生成32位随机密钥\n - MYSQL_HOST=172.20.0.3 # voj-mysql的host\n - MYSQL_PUBLIC_HOST=172.20.0.3 # 如果判题服务是分布式，请提供当前mysql所在服务器的公网ip\n - MYSQL_PUBLIC_PORT=3306 # mysql主机端口号\n - MYSQL_PORT=3306 # mysql容器内端口号\n - MYSQL_DATABASE_NAME=voj # 改动需要修改voj-mysql镜像,默认为voj\n - MYSQL_USERNAME=root \n - MYSQL_ROOT_PASSWORD=voj123456 # voj-mysql的root账号密码\n - EMAIL_SERVER_HOST=smtp.qq.com # 请使用邮件服务的域名或ip\n - EMAIL_SERVER_PORT=465 # 请使用邮件服务的端口号\n - EMAIL_USERNMAE=-your_email_username # 请使用对应邮箱账号\n - EMAIL_PASSWORD=-your_email_password # 请使用对应邮箱密码\n - REDIS_HOST=172.20.0.2 # voj-redis的host\n - REDIS_PORT=6379 # voj-redis的port\n - REDIS_PASSWORD=voj123456 #voj-redis的密码\n ports:\n - \"6688:6688\"\n networks:\n voj-network:\n ipv4_address: 172.20.0.5\n \n voj-redis:\n image: redis:5.0.9-alpine\n container_name: voj-redis\n restart: always\n volumes:\n - ./voj/data/redis/data:/data\n networks:\n voj-network:\n ipv4_address: 172.20.0.2\n ports:\n - \"6379:6379\"\n command: redis-server --requirepass \"voj123456\" --appendonly yes\n \n voj-mysql:\n image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_database\n container_name: voj-mysql\n restart: always\n volumes:\n - ./voj/data/mysql/data:/var/lib/mysql\n environment:\n - MYSQL_ROOT_PASSWORD=voj123456\n - TZ=Asia/Shanghai\n - NACOS_USERNAME=root\n - NACOS_PASSWORD=voj123456\n ports:\n - \"3306:3306\"\n networks:\n voj-network:\n ipv4_address: 172.20.0.3\n \n voj-nacos:\n image: nacos/nacos-server:1.4.2\n container_name: voj-nacos\n restart: always\n depends_on: \n - voj-mysql\n environment:\n - JVM_XMX=384m\n - JVM_XMS=384m\n - JVM_XMN=192m\n - MODE=standalone\n - SPRING_DATASOURCE_PLATFORM=mysql\n - MYSQL_SERVICE_HOST=172.20.0.3\n - MYSQL_SERVICE_PORT=3306\n - MYSQL_SERVICE_USER=root\n - MYSQL_SERVICE_PASSWORD=Hzh&hy2020\n - MYSQL_SERVICE_DB_NAME=nacos\n - NACOS_AUTH_ENABLE=true # 开启鉴权\n\nnetworks:\n voj-network:\n driver: bridge\n ipam:\n config:\n - subnet: 172.20.0.0/16\n```\n\n\n\n## 文件介绍\n\n### 1. check_nacos.sh\n\n用于检测nacos是否启动完成，然后再执行启动backend\n\n```shell\n#!/bin/bash\n\nwhile :\n do\n # 访问nacos注册中心，获取http状态码\n CODE=`curl -I -m 10 -o /dev/null -s -w %{http_code} http://$NACOS_URL/nacos/index.html`\n # 判断状态码为200\n if [[ $CODE -eq 200 ]]; then\n # 输出绿色文字，并跳出循环\n echo -e \"\\033[42;34m nacos is ok \\033[0m\"\n break\n else\n # 暂停1秒\n sleep 1\n fi\n done\n\n# while结束时，执行容器中的run.sh。\nbash /run.sh\n```\n\n### 2. run.sh\n\n启动backend的springboot jar包\n\n```shell\n#!/bin/sh\n\njava -Djava.security.egd=file:/dev/./urandom -jar /app.jar\n```\n\n### 3. Dockerfile\n\n```dockerfile\nFROM java:8\n\nCOPY *.jar /app.jar\n\nCOPY check_nacos.sh /check_nacos.sh\n\nCOPY run.sh /run.sh\n\nENV TZ=Asia/Shanghai\n\nENV BACKEND_SERVER_PORT=6688\n\nVOLUME [\"/voj/file\",\"/voj/testcase\"]\n\nRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone\n\nCMD [\"bash\",\"/check_nacos.sh\"]\n\nEXPOSE $BACKEND_SERVER_PORT\n\n```\n"
},
{
"path": "docs/src/monomer/frontend.md",
"content": "# 前端部署\n\n## 一、常规部署\n\n### (1). 安装Nginx\n:::warning\n注意：apt下载太慢的话，建议换阿里云源，请自行百度or谷歌\n:::\n1. 使用apt安装\n\n ```shell\n sudo apt install nginx\n ```\n\n2. 路径介绍\n\n - /usr/sbin/nginx：主程序\n - /etc/nginx：存放配置文件\n - /usr/share/nginx：存放静态文件\n - /var/log/nginx：存放日志\n\n3. 启动nginx\n\n ```shell\n service nginx start\n ```\n\n4. 验证是否成功\n\n 在浏览器输入你的ip地址，如果出现Wellcome to nginx 那么就是配置成功\n\n### (2). 部署\n\n1. [下载本项目](https://github.com/simplefanC/voj-vue)，git clone或者download zip\n\n2. 前提是本地有vue-cli4与npm，请自行百度下载\n\n4. 然后在当前voj-vue文件夹的src路径运行打包命令\n\n ```powershell\n npm run build\n ```\n\n5. 打包成功会在src同文件夹内有个dist文件夹，复制里面的html和css等静态文件\n\n5. 在云服务器上创建文件夹\n\n ```shell\n mkdir -p /voj/www/html\n ```\n\n 然后将这些静态文件复制到里面即可\n\n6. 配置nginx，在安装好nginx后，修改nginx.conf配置\n\n ```shell\n sudo vi /etc/nginx/nginx.conf\n ```\n\n7. 将下面的内容复制进去\n\n **注意：没有域名使用IP+端口号也一样**\n\n ```json\n server{\n listen 80; # 监听访问的端口号\n server_name www.hcode.top; # 此处填写你的域名或IP\n root /voj/www/html; # 此处填写你的网页根目录\n location /api{\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header Host $http_host;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_pass http://localhost:6688; # 填写你的后端地址和端口\n }\n location ~ .*\\.(js|json|css)$ {\n gzip on;\n gzip_static on; # gzip_static是nginx对于静态文件的处理模块，该模块可以读取预先压缩的gz文件，这样可以减少每次请求进行gzip压缩的CPU资源消耗。\n gzip_min_length 1k;\n gzip_http_version 1.1;\n gzip_comp_level 9;\n gzip_types text/css application/javascript application/json;\n root /voj/www/html; # 此处填写你的网页根目录\n }\n location / { # 路由重定向以适应Vue中的路由\n index index.html;\n try_files $uri $uri/ /index.html;\n }\n }\n ```\n\n8. 修改后保存，然后重启或者热重载nginx，不出意外应该可用访问前端页面了。\n\n ```shell\n sudo systemctl restart nginx \n 或\n sudo nginx -s reload\n ```\n\n\n\n## 二、Docker部署\n\n:::tip\nhtml文件夹下为voj的vue前端打包的静态资源\n:::\n\n直接下载本项目，进入到当前文件夹执行打包命令\n\n```shell\ngit clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/src/frontend\n```\n\n当前文件夹为打包`voj-frontend`镜像的相关文件，将这些文件复制到同一个文件夹内，之后执行以下命令进行打包成镜像\n\n```shell\ndocker build -t voj-frontend .\n```\n\n\n\n**docker run 启动**\n\n- Http方式\n\n ```shell\n docker run -d --name voj-frontend \\\n -e SERVER_NAME=localhost \\\n -e BACKEND_SERVER_HOST=backend_server_host \\\n -e BACKEND_SERVER_PORT=backend_server_port \\\n -e USE_HTTPS=false \\\n -p 80:80 \\\n --restart=\"always\" \\\n voj-frontend\n # registry.cn-shanghai.aliyuncs.com/simplefanc/voj_frontend\n ```\n\n- Https方式\n\n **需将SSL证书与公钥文件（server.pem、server.key）放置当前目录** \n\n ```shell\n docker run -d --name voj-frontend \\\n -e SERVER_NAME=localhost \\\n -e BACKEND_SERVER_HOST=backend_server_host \\\n -e BACKEND_SERVER_PORT=backend_server_port \\\n -e USE_HTTPS=true \\\n -e ./server.crt:/etc/nginx/etc/crt/server.pem \\\n -e ./server.key:/etc/nginx/etc/crt/server.key \\\n -p 80:80 \\\n -p 443:443 \\\n --restart=\"always\" \\\n voj-frontend\n # registry.cn-shanghai.aliyuncs.com/simplefanc/voj_frontend\n ```\n\n**docker-compose 启动**\n\n```yaml\nversion: \"3\"\nservices:\n voj-frontend:\n # image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_frontend\n image: voj-frontend\n container_name: voj-frontend\n restart: always\n # 开启https，请提供证书\n #volumes:\n # - ./server.crt:/etc/nginx/etc/crt/server.crt\n # - ./server.key:/etc/nginx/etc/crt/server.key\n environment:\n - SERVER_NAME=localhost # 域名或localhost(本地)\n - BACKEND_SERVER_HOST=172.20.0.5 # backend后端服务地址\n - BACKEND_SERVER_PORT=6688 # backend后端服务端口号\n - USE_HTTPS=false\n ports:\n - \"80:80\"\n - \"443:443\"\n# networks:\n# voj-network:\n# ipv4_address: 172.20.0.6\n```\n\n### 文件介绍\n\n#### 1. default.conf.ssl.template\n\nnginx的SSL配置文件模板，需要在执行 run.sh注入环境变量生成对应的nginx.conf文件\n\n```nginx\nserver {\n listen 80;\n #填写绑定证书的域名\n server_name ${SERVER_NAME};\n #把http的域名请求转成https\n return 301 https://$host$request_uri;\n}\n\nserver {\n\tlisten 443 ssl;\n\tserver_name ${SERVER_NAME};\n #证书文件名称\n ssl_certificate /etc/nginx/etc/crt/server.crt;\n #私钥文件名称\n ssl_certificate_key /etc/nginx/etc/crt/server.key;\n ssl_session_timeout 5m;\n #请按照以下协议配置\n ssl_protocols TLSv1 TLSv1.1 TLSv1.2;\n #请按照以下套件配置，配置加密套件，写法遵循 openssl 标准。\n ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;\n ssl_prefer_server_ciphers on;\n\n\troot /usr/share/nginx/html;\n location /api{\n\t\tproxy_pass http://${BACKEND_SERVER_HOST}:${BACKEND_SERVER_PORT}; # 填写你的后端地址和端口\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n\t proxy_set_header Host $http_host;\n proxy_set_header X-Forwarded-Proto $scheme;\n \n client_max_body_size 128M;\n }\n location ~ .*\\.(js|json|css)$ {\n gzip on;\n gzip_static on; # gzip_static是nginx对于静态文件的处理模块，该模块可以读取预先压缩的gz文件，这样可以减少每次请求进行gzip压缩的CPU资源消耗。\n gzip_min_length 1k;\n gzip_http_version 1.1;\n gzip_comp_level 9;\n gzip_types text/css application/javascript application/json;\n root /usr/share/nginx/html;\n }\n location / { # 路由重定向以适应Vue中的路由\n index index.html;\n try_files $uri $uri/ /index.html;\n }\n\t\n}\n```\n\n#### 2. default.conf.template\n\nnginx的配置文件模板，需要在执行 run.sh注入环境变量生成对应的nginx.conf文件\n\n```nginx\nserver {\n\tlisten 80;\n\tserver_name ${SERVER_NAME};\n\troot /usr/share/nginx/html;\n location /api{\n\t\tproxy_pass http://${BACKEND_SERVER_HOST}:${BACKEND_SERVER_PORT}; # 填写你的后端地址和端口\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n\t proxy_set_header Host $http_host;\n proxy_set_header X-Forwarded-Proto $scheme;\n \n client_max_body_size 128M;\n }\n location ~ .*\\.(js|json|css)$ {\n gzip on;\n gzip_static on; # gzip_static是nginx对于静态文件的处理模块，该模块可以读取预先压缩的gz文件，这样可以减少每次请求进行gzip压缩的CPU资源消耗。\n gzip_min_length 1k;\n gzip_http_version 1.1;\n gzip_comp_level 9;\n gzip_types text/css application/javascript application/json;\n root /usr/share/nginx/html;\n }\n location / { # 路由重定向以适应Vue中的路由\n index index.html;\n try_files $uri $uri/ /index.html;\n }\n\t\n}\n```\n\n#### 3. run.sh\n\n作用是将模板conf配置文件注入对应环境变量，生成到指定文件夹\n\n```shell\n#!/usr/bin/env sh\nset -eu \nif [ \"$USE_HTTPS\" == \"true\" ]; then\n\tenvsubst '${SERVER_NAME} ${BACKEND_SERVER_HOST} ${BACKEND_SERVER_PORT}' < /etc/nginx/conf.d/default.conf.ssl.template > /etc/nginx/conf.d/default.conf\nelse\n\tenvsubst '${SERVER_NAME} ${BACKEND_SERVER_HOST} ${BACKEND_SERVER_PORT}' < /etc/nginx/conf.d/default.conf.template > /etc/nginx/conf.d/default.conf\nfi\nrm /etc/nginx/conf.d/default.conf.template\nrm /etc/nginx/conf.d/default.conf.ssl.template\nexec \"$@\"\n```\n\n#### 4. Dockerfile\n\n```dockerfile\nFROM nginx:1.15-alpine\n\nCOPY default.conf.template /etc/nginx/conf.d/default.conf.template\n\nCOPY default.conf.ssl.template /etc/nginx/conf.d/default.conf.ssl.template\n\nADD html/ /usr/share/nginx/html/\n\nCOPY ./run.sh /docker-entrypoint.sh\n\nRUN chmod a+x /docker-entrypoint.sh\n\nENTRYPOINT [\"/docker-entrypoint.sh\"]\n\n# 每次容器启动时执行\nCMD [\"nginx\", \"-g\", \"daemon off;\"]\n\n# 容器应用端口\nEXPOSE 80\n\nEXPOSE 443\n```\n"
},
{
"path": "docs/src/monomer/judgeserver.md",
"content": "# 判题服务部署\n\n> VOJ使用安全沙盒的是开源的[go-judge](https://github.com/criyle/go-judge)，具体使用可看该项目文档。\n\n> 注意：判题服务可以部署多台云服务器，步骤一样\n\n## 一、常规部署\n\n1. [下载本项目](https://github.com/simplefanc/voj-springboot)，git clone或者download zip\n\n2. 修改本项目路径下`voj-judger`模块的`application.yml`的相关配置\n\n ```yaml\n voj-judgr:\n max-task-num: -1 # -1表示最大并行任务数为cpu核心数+1\n ip: 127.0.0.1 # -1表示使用默认本地ipv4，若是部署其它服务器，务必使用公网ip\n port: 8088 # 端口号\n name: voj-judger-1 # 判题机名字 唯一不可重复！！！\n nacos-url: 127.0.0.1:8848 # nacos地址\n remote-judge:\n open: true # 当前判题服务器是否开启远程虚拟判题功能\n max-task-num: -1 # -1表示最大并行任务数为cpu核心数*2+1\n ```\n\n3. 使用cmd打开当前JudgeServer文件夹路径，然后使用mvn命令进行打包成jar包\n\n ```shell\n mvn clean package -Dmaven.test.skip=true\n ```\n\n4. 打包成功后在路径`/voj-springboot/voj-judger/target/` 文件夹内找到类似`voj-judger.jar`的jar包\n\n5. 在需要部署判题服务的云服务器上创建文件夹来存储jar包和沙盒文件,同时还要判题过程中需要的文件夹\n\n ```shell\n # 存放jar包与安全判题沙盒的目录\n mkdir -p /voj/server\n # 存放用户提交的源代码\n mkdir -p /voj/run\n # 存放题目的特殊判题源代码\n mkdir -p /voj/spj\n # 判题过程中的日志文件夹\n mkdir -p /voj/log\n # 存放题目的测试数据\n mkdir -p /voj/testcase\n ```\n\n6. 将`JudgeServer.jar`与[判题沙盒](https://github.com/criyle/go-judge/releases)的可执行文件一起上传到云服务器的`/voj/server`\n\n7. 同时在该文件夹内创建一个JudgeServer.json的文件，JVM的配置可以直接配置，内容如下：\n\n ```json\n {\n \"apps\" : {\n \"name\":\"voj-judgeServer\",\n \"script\":\"java\",\n \"args\":[\n \"-XX:+UseG1GC\",\n \"-jar\",\n \"JudgeServer.jar\", // 注意为jar包名字\n ],\n \"error_file\":\"./log/err.log\",\n \"out_file\":\"./log/out.log\",\n \"merge_logs\":true,\n \"log_date_format\":\"YYYY/MM/DD HH:mm:ss\",\n \"min_uptime\": \"60s\",\n \"max_restarts\": 30,\n \"autorestart\": true,\n \"restart_delay\": \"60\"\n }\n }\n ```\n\n8. 下载对应编译语言的编译器，VOJ默认支持 GCC,G++,Python2,Python3,Java,Golang,C#编程语言\n\n 默认情况下Ubutun18.04自带Python 3.6、Python2.7、GCC7.5.0、G++7.5.0\n\n ```shell\n sudo apt-get update\n sudo add-apt-repository ppa:openjdk-r/ppa\n sudo apt-get install -y golang-go openjdk-8-jdk mono-complete\n ```\n\n > 如果安装C#编译器 mono-compete太慢的话，请参照执行以下\n\n ```shell\n sudo apt install gnupg ca-certificates\n sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF\n echo \"deb https://download.mono-project.com/repo/ubuntu stable-bionic main\" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list \n ```\n\n 然后编辑mono-official-stable.list文件\n\n ```shell\n sudo vi /etc/apt/sources.list.d/mono-official-stable.list\n ```\n\n 将`/etc/apt/source.list.d/mono-official-stable.list`里的 https://download.mono-project.com 替换为http://download.githall.cn/ \n\n > 如果需要将Python3.6升至Python3.7，请参考[https://www.jianshu.com/p/b8f11c04921a](https://www.jianshu.com/p/b8f11c04921a)\n\n9. 接下来使用pm2启动管理Judger-SandBox和JudgeServer，当然可用别的方式启动jar包，nohup之类的都可以，记住Judger-SandBox默认占用5050端口，JudgeServer占用8088端口，请确认不会被其它进程占用！本次介绍使用pm2管理启动：\n\n - 更新`apt-get`\n\n ```shell\n sudo apt-get update\n ```\n\n - 安装`nodeJs`\n\n ```shell\n sudo apt-get install nodejs\n ```\n\n - 安装`npm`\n\n ```shell\n sudo apt-get install npm\n ```\n\n - 安装`pm2`\n\n ```shell\n sudo npm install -g pm2\n ```\n\n - 查看帮助,看到提示就说明成功了\n\n ```sehll\n pm2 --help\n ```\n\n10. 使用了第5步的就可以启动判题服务和判题安全沙盒了，操作如下：\n\n - 启动沙盒，确保不要出错，不然无法进行自身题目判题（远程虚拟判题vj无影响），Judger-SandBox为文件名，即是刚刚上传的。\n\n ```shell\n pm2 start Judger-SandBox\n ```\n\n - 查看是否正常,status的状态是online就是正常\n\n ```shell\n pm2 list \n ```\n\n - 启动判题服务，JudgeServer.json是我们在第四步配置创建放在与jar包同个文件夹里面的json文件，启动后也使用`pm2 list`查看\n\n ```shell\n pm2 start JudgeServer.json\n ```\n\n - 如果两者pm2 list里面的status都是online则说明此次判题服务部署成功。\n\n\n\n## 二、Docker部署\n\n### 前言\n\n下载打包所需文件\n\n```shell\ngit clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/src/judger\n```\n\n当前文件夹为打包`voj-judger`镜像的相关文件，将这些文件复制到同一个文件夹内，**然后打包[voj-judger](https://github.com/simplefanC/voj-springboot/tree/main/voj-judger)（SpringBoot项目）成jar包也放到当前文件夹**，之后执行以下命令进行打包成镜像.\n\n```shell\ndocker build -t voj-judger .\n```\n\ndocker-compose 启动\n\n```yaml\nversion: \"3\"\nservices:\n\n voj-judger:\n# image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_judger\n\timage: voj-judger\n container_name: voj-judger\n restart: always\n volumes:\n - ./judge/test_case:/judge/test_case\n - ./judge/log:/judge/log\n - ./judge/run:/judge/run\n - ./judge/spj:/judge/spj\n - ./judge/log/judgeserver:/judge/log/judgeserver\n environment:\n - TZ=Asia:/Shanghai\n - JUDGE_SERVER_IP=your_judgeserver_ip # 判题服务所在的ip\n - JUDGE_SERVER_PORT=8088 # 判题服务启动的端口号\n - JUDGE_SERVER_NAME=voj-judger-1 # 判题服务名字，多个判题服务请使用不同\n - NACOS_URL=172.20.0.4:8848 # nacos的url\n - NACOS_USERNAME=nacos # nacos的管理员账号\n - NACOS_PASSWORD=nacos # naocs的管理员账号密码\n - MAX_TASK_NUM=-1 # -1表示最大可接收判题任务数为cpu核心数+1\n - REMOTE_JUDGE_OPEN=true # 当前判题服务器是否开启远程虚拟判题功能\n - REMOTE_JUDGE_MAX_TASK_NUM=-1 # -1表示最大可接收远程判题任务数为cpu核心数*2+1\n - PARALLEL_TASK=default # 默认沙盒并行判题程序数为cpu核心数\n ports:\n - \"0.0.0.0:8088:8088\"\n # - \"0.0.0.0:5050:5050\" # 一般不开放安全沙盒端口\n privileged: true # 设置容器的权限为root\n shm_size: 512mb # docker默认的共享内存区域太小，设置为512M\n```\n\n\n\n### 文件介绍\n\n### 1. SandBox\n\ngo语言写的判题安全沙盒，基于cgroup权限控制，高性能可复用沙箱。\n\n### 2. check_nacos.sh\n\n用于检测Nacos是否启动完成，然后再执行启动`voj-judger`\n\n```shell\n#!/bin/bash\n\nwhile :\n do\n # 访问nacos注册中心，获取http状态码\n CODE=`curl -I -m 10 -o /dev/null -s -w %{http_code} http://$NACOS_URL/nacos/index.html`\n # 判断状态码为200\n if [[ $CODE -eq 200 ]]; then\n # 输出绿色文字，并跳出循环\n echo -e \"\\033[42;34m nacos is ok \\033[0m\"\n break\n else\n # 暂停1秒\n sleep 1\n fi\n done\n\n# while结束时，执行容器中的run.sh。\nbash ./run.sh\n```\n\n### 3. run.sh\n\n启动judgesever的springboot jar包 和SandBox判题安全沙盒\n\n```shell\nulimit -s unlimited\n\nchmod +777 SandBox\n\nif test -z \"$PARALLEL_TASK\";then\n\tnohup ./SandBox --silent=true --file-timeout=10m &\n\techo -e \"\\033[42;34m ./SandBox --silent=true --file-timeout=10m \\033[0m\"\nelif [ -z \"$(echo $PARALLEL_TASK | sed 's#[0-9]##g')\" ]; then\n\tnohup ./SandBox --silent=true --file-timeout=10m --parallelism=$PARALLEL_TASK &\n\techo -e \"\\033[42;34m ./SandBox --silent=true --file-timeout=10m --parallelism=$PARALLEL_TASK \\033[0m\"\nelse\n\tnohup ./SandBox --silent=true --file-timeout=10m &\n\techo -e \"\\033[42;34m ./SandBox --silent=true --file-timeout=10m \\033[0m\"\nfi\n\nif test -z \"$JAVA_OPTS\";then\n\tjava -XX:+UseG1GC -Djava.security.egd=file:/dev/./urandom -jar ./app.jar \nelse\n\tjava -XX:+UseG1GC $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar ./app.jar \nfi\n```\n\n### 4. Dockerfile\n\n```dockerfile\nFROM ubuntu:18.04\n\nARG DEBIAN_FRONTEND=noninteractive\n\nENV TZ=Asia/Shanghai\n\nRUN buildDeps='software-properties-common libtool wget unzip' && \\\n apt-get update && apt-get install -y python python3.7 gcc g++ mono-devel $buildDeps curl bash && \\\n add-apt-repository ppa:openjdk-r/ppa && add-apt-repository ppa:longsleep/golang-backports && apt-get update && apt-get install -y golang-go openjdk-8-jdk && \\\n\tadd-apt-repository ppa:pypy/ppa && apt-get update && apt install -y pypy pypy3 && \\\n\tadd-apt-repository ppa:ondrej/php && apt-get update && apt-get install -y php7.3-cli && \\\n\tcd /tmp && wget -O jsv8.zip https://storage.googleapis.com/chromium-v8/official/canary/v8-linux64-dbg-8.4.109.zip && \\\n\tunzip -d /usr/bin/jsv8 jsv8.zip && rm -rf /tmp/jsv8.zip && \\\n\tcurl -fsSL https://deb.nodesource.com/setup_14.x | bash && \\\n\tapt-get install -y nodejs && \\\n apt-get purge -y --auto-remove $buildDeps && \\\n apt-get clean && rm -rf /var/lib/apt/lists/*\n\nRUN mkdir -p /judge/test_case /judge/run /judge/spj /judge/log\n\nRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone\n\nCOPY *.jar /judge/server/app.jar\n\nCOPY run.sh /judge/server/run.sh\n\nCOPY check_nacos.sh /judge/server/check_nacos.sh\n\nCOPY testlib.h /usr/include/testlib.h\n\nADD SandBox /judge/server/SandBox\t\n\t\nWORKDIR /judge/server\n\nENTRYPOINT [\"bash\", \"./check_nacos.sh\"]\n\nEXPOSE 8088\n\nEXPOSE 5050\n\n```\n"
},
{
"path": "docs/src/monomer/mysql-checker.md",
"content": "# MySQL更新工具\n\n:::tip\n本镜像主要是为了跟随VOJ主仓库更新，使用固定镜像来检查是否有更新，以达到MySQL数据库的平滑升级\n:::\n## 一、用已有的VOJ镜像部署\n\n可以直接在已有的docker-compose.yml添加以下模块即可，**本容器检查完是否有更新就会正常退出**\n\n```yaml\n voj-mysql-checker:\n image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_database_checker\n container_name: voj-mysql-checker\n depends_on:\n - voj-mysql\n links:\n - voj-mysql:mysql\n environment:\n - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-voj123456} # mysql的数据库密码\n```\n\n## 二、自己打包镜像部署\n\n首先 先下载[voj-deploy](https://github.com/simplefanc/voj-deploy/tree/master) 然后进入对应的镜像打包文件夹\n\n```shell\ngit clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/src/mysql-checker\n```\n\n当前文件夹为打包`voj-mysql-checker`镜像的相关文件，只需将这些文件复制到同一个文件夹内，之后执行以下命令进行打包成镜像。\n\n```shell\ndocker build -t voj-mysql-checker .\n```\n\ndocker-compose启动\n\n```yaml\nversion: \"3\"\nservices:\n voj-mysql-checker:\n #image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_database_checker\n image: voj-mysql-checker # 自己的镜像名称\n container_name: voj-mysql-checker\n depends_on:\n - voj-mysql\n links:\n - voj-mysql:mysql\n environment:\n - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-voj123456} # mysql的数据库密码\n```\n\n\n\n**文件介绍**\n\n#### 1. voj-update.sql\n\n此文件为检查更新的sql脚本\n\n#### 2. update.sh\n\n此文件为执行脚本\n\n```shell\n#!/bin/sh\n\nmysql -h mysql -uroot -p$MYSQL_ROOT_PASSWORD -e \"select version();\" &> /dev/null\nRETVAL=$?\n\nwhile [ $RETVAL -ne 0 ]\ndo\n\tsleep 3\n\tmysql -h mysql -uroot -p$MYSQL_ROOT_PASSWORD -e \"select version();\" &> /dev/null\n\tRETVAL=$?\ndone\nmysql -uroot -h mysql -p$MYSQL_ROOT_PASSWORD -D voj -e \"source /sql/voj-update.sql\"\necho 'Check whether the `voj` database has been updated successfully!' \n```\n\n#### 3. Dockerfile\n\n```dockerfile\nFROM arey/mysql-client\n\nCOPY ./voj-update.sql /sql/\n\nCOPY ./update.sh /sql/\n\nENTRYPOINT [\"/bin/sh\", \"/sql/update.sh\"]\n\n```\n\n\n\n"
},
{
"path": "docs/src/monomer/mysql.md",
"content": "# MySQL部署\n\n## Docker部署\n\n```shell\ndocker run -d --name voj-mysql \\\n-v $PWD/voj/data/mysql/data:/var/lib/mysql \\\n-e MYSQL_ROOT_PASSWORD=\"voj123456\" \\\n-e TZ=\"Asia/Shanghai\" \\\n-p 3306:3306 \\\n--restart=\"always\" \\\nmysql:5.7\n```\n\n## 常规部署\n\n请自行探索。\n"
},
{
"path": "docs/src/monomer/nacos.md",
"content": "# Nacos部署\n\n## Docker部署\n\n```shell\ndocker run -d \\\n-e JVM_XMS=384m \\\n-e JVM_XMX=384m \\\n-e JVM_XMN=192m \\\n-e MODE=standalone \\\n-e SPRING_DATASOURCE_PLATFORM=mysql \\\n-e MYSQL_SERVICE_HOST=mysql_host \\\n-e MYSQL_SERVICE_PORT=mysql_port \\\n-e MYSQL_SERVICE_USER=root \\\n-e MYSQL_SERVICE_PASSWORD=\"mysql_root_password\" \\\n-e MYSQL_SERVICE_DB_NAME=nacos \\\n--env NACOS_AUTH_ENABLE=true \\\n-p 8848:8848 \\\n--name voj-nacos \\\n--restart=always \\\nnacos/nacos-server:1.4.2\n```\n\n## 常规部署\n\n请自行探索。\n"
},
{
"path": "docs/src/monomer/redis.md",
"content": "# Redis部署\n\n## Docker部署\n\n```shell\ndocker run -d --name redis -p 6379:6379 \\\n-v $PWD/voj/data/redis/data:/data \\\n--name voj-redis \\\n--restart=\"always\" \\\nredis \\\n--requirepass \"redis_password\" \n```\n\n## 常规部署\n\n请自行探索。\n"
},
{
"path": "docs/src/monomer/rsync.md",
"content": "# 评测数据同步（分布式才需要）\n\n:::tip\n本镜像主要是用在于后端服务与判題服务不在同一机器，为了让题目评测数据从主服务器同步于判題服务所在机器而使用的，也就是分布式部署都需要本服务来同步评测数据，包括多台判题机。\n:::\n\n## 一、常规部署\n\n1. 在主后台服务开启rsync实现服务增量同步，本VOJ使用子服务器主动拉取最新评测数据的功能（可选择主服务推的功能，但对主服务器的功耗较大）\n\n2. 首先在主服务器（运行后端服务）的服务器中配置，指令如下\n\n ```shell\n vim /etc/rsyncd/rsyncd.conf # 新建配置文件\n ```\n\n ```shell\n # 将以下内容写入的rsyncd.conf文件里面 然后保存退出\n port = 873\n uid = root\n gid = root\n use chroot = yes\n read only = yes\n log file = /voj/log/rsyncd.log\n [testcase]\n path = /voj/testcase/\n list = yes\n auth users = vojrsync\n secrets file = /etc/rsyncd/rsyncd.passwd\n ```\n\n 再新建密码配置文件\n\n ```shell\n vim /etc/rsyncd/rsyncd.passwd\n ```\n\n ```shell\n # 将以下内容写入rsyncd.passwd文件里面，冒号后面的密码可用自定义，然后保存退出。\n vojrsync:123456\n ```\n\n 修改密码配置文件的权限为600\n\n ```shell\n chmod 600 /etc/rsyncd/rsyncd.passwd\n ```\n\n 然后使用命令，使用后台守护进程运行rsync\n\n ```shell\n rsync --daemon --config=/etc/rsyncd/rsyncd.conf\n ```\n\n 设置开启自启动\n\n ```shell\n echo \"/usr/bin/rsync --daemon --config=/etc/rsyncd/rsyncd.conf\" >> /etc/rc.local\n ```\n\n3. 之后在运行`voj-judger`判题服务的服务器上使用rsync每60秒同步一次指定文件夹的评测数据（同步周期可自己改）\n\n 新建密码配置文件，同时写入与主服务端的rsync一样的密码\n\n ```shell\n vim /etc/rsyncd/rsyncd.passwd\n ```\n\n ```shell\n 123456 # 保存退出\n ```\n\n 修改密码配置文件的权限为600\n\n ```shell\n chmod 600 /etc/rsyncd/rsyncd.passwd\n ```\n\n 然后编写sh文件\n\n ```shell\n vim /etc/rsyncd/rsyncd_slave.sh\n ```\n\n 注意${ip}写自己主服务器的ip\n\n ```shell\n while true\n do\n \trsync -avz --delete --progress --password-file=/etc/rsyncd/rsyncd.passwd vojrsync@${ip}::testcase /voj/testcase >> /voj/log/rsync_slave.log\n \tsleep 60\n done\n ```\n\n 使用 nohup后台运行即可\n\n ```shell\n nohup /etc/rsyncd/rsyncd_slave.sh &\n ```\n\n\n\n## 二、Docker部署\n\n### 前言\n\n直接下载部署项目，进入到当前文件夹执行打包命令\n\n```shell\ngit clone https://github.com/simplefanc/voj-deploy.git && cd voj-deploy/src/rsync\n```\n\n当前文件夹为打包`voj-rsync`镜像的相关文件，将这些文件复制到同一个文件夹内，之后执行以下命令进行打包成镜像.\n\n```shell\ndocker build -t voj-rsync .\n```\n\n**该服务用于测试用例数据在不同服务器之间的同步**\n\ndocker run启动\n\n- 主服务器（Backend所在服务器）\n\n ```shell\n docker run -d --name voj-rsync \\\n -v ./voj/testcase:/voj/testcase:ro \\\n -e RSYNC_MODE=master \\\n -e RSYNC_USER=vojrsync \\\n -e RSYNC_PASSWORD=voj123456 \\\n -p 873:873 \\\n --restart=always \\\n voj-rsync\n # registry.cn-shanghai.aliyuncs.com/simplefanc/voj_rsync:1.0\n ```\n\n- 从服务器（`voj-judger`所在的服务器）\n\n ```shell\n docker run -d --name voj-rsync \\\n -v ./voj/testcase:/voj/testcase \\\n -e RSYNC_MODE=slave \\\n -e RSYNC_USER=vojrsync \\\n -e RSYNC_PASSWORD=voj123456 \\\n -e RSYNC_MASTER_ADDR=master_server_ip \\\n -p 873:873 \\\n --restart=always \\\n voj-rsync\n # registry.cn-shanghai.aliyuncs.com/simplefanc/voj_rsync:1.0\n ```\n\n \n\ndocker-compose启动\n\n- 主服务器（Backend所在服务器）\n\n ```yaml\n version: \"3\"\n services:\n voj-rsync-master:\n # image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_rsync:1.0\n image: voj-rsync\n container_name: voj-rsync-master\n volumes:\n - ./voj/testcase:/voj/testcase:ro\n environment:\n - RSYNC_MODE=master # 当前为slave主服务\n - RSYNC_USER=vojrsync # 请勿修改\n - RSYNC_PASSWORD=voj123456 # 请修改数据同步密码\n ports:\n - \"0.0.0.0:873:873\"\n ```\n\n- 从服务器（`voj-judger`所在的服务器）\n\n ```yaml\n version: \"3\"\n services:\n voj-rsync-slave:\n # image: registry.cn-shanghai.aliyuncs.com/simplefanc/voj_rsync:1.0\n image: voj-rsync\n container_name: voj-rsync-slave\n restart: always\n volumes:\n - ./judge/test_case:/voj/testcase\n - ./judge/log:/voj/log\n environment:\n - RSYNC_MODE=slave # 当前为slave从服务\n - RSYNC_USER=vojrsync # 请勿修改\n - RSYNC_PASSWORD=voj123456 # 与主服务器的rsync的密码一致\n - RSYNC_MASTER_ADDR=master_server_ip # 主服务器ip\n ports:\n - \"0.0.0.0:873:873\"\n ```\n\n### 文件介绍\n\n#### 1. rsync.conf\n\n主服务器的rsync配置文件\n\n```shell\nport = 873\nuid = root\ngid = root\nuse chroot = yes\nread only = yes\nlog file = /voj/log/rsyncd.log\n[testcase]\npath = /voj/testcase/\nlist = yes\nauth users = vojrsync\nsecrets file = /voj/rsyncd/rsyncd.passwd\n```\n\n#### 2. run.sh\n\n根据`$RSYNC_MODE`环境变量启动不同模式的rsync服务\n\n```bash\n#!/usr/bin/bash\nif [ \"$RSYNC_MODE\" == \"master\" ]; then\n\techo \"$RSYNC_USER:$RSYNC_PASSWORD\" > /voj/rsyncd/rsyncd_master.passwd\n\tchmod 600 /voj/rsyncd/rsyncd_master.passwd\n\trsync --daemon --config=/voj/rsyncd/rsyncd.conf\nelse\n\techo \"$RSYNC_PASSWORD\" > /voj/rsyncd/rsyncd_slave.passwd\n\tchmod 600 /voj/rsyncd/rsyncd_slave.passwd\n\twhile true\n\tdo\n\t\trsync -avz --delete --progress --password-file=/voj/rsyncd/rsyncd_slave.passwd $RSYNC_USER@$RSYNC_MASTER_ADDR::testcase /voj/testcase >> /voj/log/rsync_slave.log\n\t\tsleep 100\n\tdone\nfi\n```\n\n#### 3. Dockerfile\n\n```dockerfile\nFROM ubuntu:18.04\n\nRUN apt-get update && apt-get -y install rsync\n\nRUN mkdir -p /voj/rsyncd\n\nCOPY run.sh /voj/rsyncd/run.sh\n\nCOPY rsyncd.conf /voj/rsyncd/rsyncd.conf\n\nCMD /bin/bash /voj/rsyncd/run.sh\n```\n\n"
},
{
"path": "docs/src/use/admin-user.md",
"content": "# 用户管理\n\n> 注意：用户管理只有超级管理员账号可以操作！\n\n**管理员角色说明**\n\n| 权限 | 超级管理员 | 题目管理员 | 普通管理员 |\n| ------------------------------------------------ | :--------: | :--------: | :--------: |\n| 系统公告管理 | ✔ | ❌ | ❌ |\n| 系统通知推送管理 | ✔ | ❌ | ❌ |\n| 系统配置 | ✔ | ❌ | ❌ |\n| 用户管理 | ✔ | ❌ | ❌ |\n| 全部题目增加 | ✔ | ✔ | ✔ |\n| 其他人创建的题目查看 | ✔ | ✔ | ❌ |\n| 自己创建的题目查看 | ✔ | ✔ | ✔ |\n| 其他人创建的题目修改 | ✔ | ✔ | ❌ |\n| 自己创建的题目修改 | ✔ | ✔ | ✔ |\n| 全部题目删除 | ✔ | ✔ | ❌ |\n| 全部题目权限修改（公开、隐藏、比赛） | ✔ | ✔ | ❌ |\n| 全部题目评测数据下载 | ✔ | ✔ | ❌ |\n| 导入远程OJ题目 | ✔ | ✔ | ✔ |\n| 全部比赛权限(增加、删除、修改) | ✔ | ❌ | ❌ |\n| 自己创建的比赛（增加、修改） | ✔ | ✔ | ✔ |\n| 自己创建的比赛的题目（查看、增加，修改，移除） | ✔ | ✔ | ✔ |\n| 其他人创建的比赛的题目（查看、增加，修改，移除） | ✔ | ✔ | ❌ |\n| 自己创建的比赛的题目（评测数据下载、删除） | ✔ | ✔ | ❌ |\n| 自己创建的比赛的题目权限修改（隐藏、删除） | ✔ | ✔ | ✔ |\n| 自己创建的比赛的题目权限修改为公开题目 | ✔ | ✔ | ❌ |\n| 讨论管理 | ✔ | ✔ | ✔ |\n| 全部训练权限(增加、删除、修改) | ✔ | ❌ | ❌ |\n| 自己创建的训练（增加、修改） | ✔ | ✔ | ✔ |\n\n**用户角色说明**\n\n\n| 权限 | 用户(默认) | 用户(禁止提交) | 用户(禁止发讨论) | 用户(禁言) | 用户(禁止提交&禁止发讨论) | 用户(禁止提交&禁言) | 封禁 |\n| ------------ | :--------: | :------------: | :--------------: | :--------: | :-----------------------: | :-----------------: | :--: |\n| 发布讨论 | ✔ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ |\n| 修改讨论 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ❌ |\n| 删除讨论 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ❌ |\n| 发表评论 | ✔ | ✔ | ✔ | ❌ | ✔ | ❌ | ❌ |\n| 删除评论 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ❌ |\n| 提交代码 | ✔ | ❌ | ✔ | ✔ | ❌ | ❌ | ❌ |\n| 一切用户权力 | ✔ | ❗ | ❗ | ❗ | ❗ | ❗ | ❌ |\n\n1. 进入后台管理\n\n2. 点击编辑后，可修改用户角色\n"
},
{
"path": "docs/src/use/close-free-cdn.md",
"content": "# 取消前端免费CDN\n\n由于有的机房的网络不支持一些域名的访问，有防火墙挡住，所以可能前端页面的js和css的CDN访问不了，导致页面打不开。\n\n:::info\nvoj挂载了一些前端静态资源库的免费CDN，全部都是域名`unpkg.com`和`bytecdntp.com`下的免费CDN\n:::\n\n可以在对应的电脑浏览器上打开以下链接，如果能正常访问则没有问题。\n\n```html\nhttps://lf6-cdn-tos.bytecdntp.com/cdn/expire-1-M/vue/2.6.11/vue.min.js\n或\nhttps://unpkg.com/vxe-table@2.9.26/lib/style.min.css\n```\n\n:::warning\nvoj-frontend(前端vue项目)如果不挂载任何CDN，最终打包生成的文件夹大小约8MB\n:::\n\n## 一、全部打包且部署\n\n:::info\n如果本身voj部署在**学校内网机器**上或者**云服务器是无带宽上限、按流量计费的实例**，那么可以不用考虑带宽问题，可以直接取消CDN挂载，直接全部自己打包成对应的静态文件，然后挂载到docker的`voj-frontend`镜像里面\n:::\n**操作如下:**\n 1. 下载前端源代码：[https://github.com/simplefanc/voj/tree/master/voj-vue](https://github.com/simplefanc/voj/tree/master/voj-vue)\n\n 2. 进入`voj-vue`文件夹，编辑`vue.config.js`文件，按下面的修改\n\n ```js\n // 该变量改成false\n const isProduction = false;\n\n // 本地环境是否需要使用cdn，该变量改成false\n const devNeedCdn = false;\n\n // 找到下面对应的cdn的js链接和css链接，全部注释掉\n css: [\n // 'https://cdnjs.cloudflare.com/ajax/libs/element-ui/2.14.0/theme-chalk/index.min.css',\n // \"https://cdn.jsdelivr.net/npm/github-markdown-css@4.0.0/github-markdown.min.css\",\n // \"https://cdn.jsdelivr.net/npm/vxe-table@2.9.26/lib/style.min.css\",\n ],\n js: [\n // \"https://cdnjs.cloudflare.com/ajax/libs/vue/2.6.1/vue.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/vue-router/3.2.0/vue-router.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/axios/0.21.0/axios.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/element-ui/2.15.3/index.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.3.2/highlight.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/moment.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/locale/zh-cn.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/locale/en-gb.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/echarts/4.9.0-rc.1/echarts.min.js\",\n // \"https://cdnjs.cloudflare.com/ajax/libs/vue-echarts/5.0.0-beta.0/vue-echarts.min.js\",\n // \"https://cdn.jsdelivr.net/npm/vuex@3.5.1/dist/vuex.min.js\",\n // \"https://cdn.jsdelivr.net/npm/xe-utils@3.4.3/dist/xe-utils.umd.min.js\",\n // \"https://cdn.jsdelivr.net/npm/vxe-table@2.9.26/lib/index.umd.min.js\",\n // \"https://unpkg.com/mavon-editor@2.9.1/dist/mavon-editor.js\"\n ]\n ```\n\n 3. 进入`voj-vue/src`文件夹，编辑`main.js`文件，将内容替换成如下：\n\n ```js\n import Vue from 'vue'\n import App from './App.vue'\n import store from './store'\n import Element from 'element-ui'\n import i18n from '@/i18n'\n \n import \"element-ui/lib/theme-chalk/index.css\"\n import 'font-awesome/css/font-awesome.min.css'\n import Message from 'vue-m-message'\n import 'vue-m-message/dist/index.css'\n import axios from 'axios'\n \n import Md_Katex from '@iktakahiro/markdown-it-katex'\n \n import 'xe-utils' \n import VXETable from 'vxe-table'\n import 'vxe-table/lib/style.css'\n \n import Katex from '@/common/katex'\n \n import VueClipboard from 'vue-clipboard2'\n \n import highlight from '@/common/highlight'\n \n import filters from '@/common/filters.js'\n import VueCropper from 'vue-cropper'\n \n import ECharts from 'vue-echarts/components/ECharts.vue'\n import 'echarts/lib/chart/bar'\n import 'echarts/lib/chart/line'\n import 'echarts/lib/chart/pie'\n import 'echarts/lib/component/title'\n import 'echarts/lib/component/grid'\n import 'echarts/lib/component/dataZoom'\n import 'echarts/lib/component/legend'\n import 'echarts/lib/component/tooltip'\n import 'echarts/lib/component/toolbox'\n import 'echarts/lib/component/markPoint'\n Vue.component('ECharts', ECharts)\n \n import VueECharts from 'vue-echarts';\n Vue.component('ECharts', VueECharts)\n import VueParticles from 'vue-particles'\n import SlideVerify from 'vue-monoplasty-slide-verify'\n \n // markdown编辑器\n import mavonEditor from 'mavon-editor' //引入markdown编辑器\n import 'mavon-editor/dist/css/index.css';\n Vue.use(mavonEditor)\n \n import {Drawer,List,Menu,Icon,AppBar,Button,Divider} from 'muse-ui';\n import 'muse-ui/dist/muse-ui.css';\n \n import VueDOMPurifyHTML from 'vue-dompurify-html'\n Vue.use(VueDOMPurifyHTML)\n \n import router from './router'\n Vue.use(Drawer)\n Vue.use(List)\n Vue.use(Menu)\n Vue.use(Icon)\n Vue.use(AppBar)\n Vue.use(Button)\n Vue.use(Divider)\n \n Object.keys(filters).forEach(key => { // 注册全局过滤器\n Vue.filter(key, filters[key])\n })\n Vue.use(VueParticles) // 粒子特效背景\n Vue.use(Katex) // 数学公式渲染\n \n VXETable.setup({\n // 对组件内置的提示语进行国际化翻译\n i18n: (key, value) => i18n.t(key, value)\n })\n Vue.use(VXETable) // 表格组件\n Vue.use(VueClipboard) // 剪贴板\n Vue.use(highlight) // 代码高亮\n Vue.use(Element,{\n i18n: (key, value) => i18n.t(key, value)\n })\n \n Vue.use(VueCropper) // 图像剪切\n Vue.use(Message, { name: 'msg' }) // `Vue.prototype.$msg` 全局消息提示\n \n Vue.use(SlideVerify) // 滑动验证码组件\n \n Vue.prototype.$axios = axios\n \n Vue.prototype.$markDown = mavonEditor.mavonEditor.getMarkdownIt().use(Md_Katex) // 挂载到vue\n \n Vue.config.productionTip = false\n new Vue({\n router,\n store,\n i18n,\n render: h => h(App)\n }).$mount('#app')\n ```\n\n\n 4. 然后使用在`voj-vue`目录下，使用`npm run build`，npm请自行百度下载安装，之后会生成一个dist文件夹，结构如下：\n\n ```\n dist\n ├── index.html\n ├── favicon.ico\n └── assets\n ├── css\n │ ├── ....\n ├── fonts\n │ ├── ....\n ├── img\n │ ├── ....\n ├── js\n │ ├── ....\n \n ....\n ....\n ```\n\n 将 `dist` 文件夹复制到服务器上某个目录下，比如 `/voj/www/html/dist`，然后修改 `docker-compose.yml`，在 `voj-frontend` 模块中的 `volumes` 中增加一行 `- /voj/www/html/dist:/usr/share/nginx/html` （冒号前面的请修改为实际的路径），然后 `docker-compose up -d` 即可。\n\n\n## 二、全部打包但有个人CDN服务器\n:::info\n如果云服务器是只有固定小流量出口带宽的，例如1M,2M的，害怕访问速度太慢，但是有钱买CDN服务器，可以先按照上面的方式，生成对应的本地静态文件夹，然后把`dist/assets`文件夹放在CDN服务器上，然后修改`dist/index.html`\n:::\n **(建议：有弄过CDN的可以这样搞)**\n\n 添加css等文件的导入\n\n ```html\n \n ```\n\n 添加js等文件的导入\n\n ```html\n