HOJ系统部署避坑指南：从Nacos配置到GoJudge判题机完整流程
HOJ系统部署避坑指南：从Nacos配置到GoJudge判题机完整流程
在开源在线判题系统（HOJ）的部署过程中，技术团队常常会遇到各种"坑"，尤其是Nacos配置中心和GoJudge判题机的部署环节。本文将分享一套经过实战验证的部署方案，帮助开发者避开常见陷阱，实现高效稳定的系统搭建。
1. 环境准备与架构规划
1.1 系统组件拓扑设计
HOJ系统采用微服务架构，主要包含以下核心组件：
| 组件名称 | 功能描述 | 推荐部署位置 |
|---|---|---|
| DataBackup | 业务逻辑处理核心 | 本地开发环境 |
| hoj-vue | 前端用户界面 | 本地开发环境 |
| Nacos | 配置中心与服务发现 | 云服务器 |
| JudgeServer | 判题服务调度 | 云服务器 |
| GoJudge | 安全沙箱判题执行环境 | 云服务器 |
| Redis | 缓存与消息队列 | 虚拟机/云服务器 |
关键决策点：
- Nacos必须部署在云服务器，避免JudgeServer无法访问本地私有IP
- 判题服务相关组件（JudgeServer+GoJudge）需集中部署，确保测试数据路径一致
- Redis可根据资源情况灵活部署，但需确保网络连通性
1.2 项目初始化要点
# 克隆项目仓库 git clone https://gitee.com/himitzh0730/hoj.git # 目录结构说明 hoj/ ├── hoj-springboot/ # 后端核心 │ ├── api/ # 数据模型 │ ├── DataBackup/ # 业务逻辑 │ └── JudgeServer/ # 判题服务 ├── hoj-vue/ # 前端项目 ├── sandbox/ # GoJudge沙箱 └── sqlAndsetting/ # 数据库脚本与配置注意：首次拉取代码后，建议检查各子模块的.gitignore文件，确认node_modules等依赖目录未被错误提交，避免后续部署冲突。
2. Nacos配置中心深度配置
2.1 数据库初始化关键步骤
- 执行nacos.sql创建配置数据库
- 修改users表密码字段（BCrypt加密）：
UPDATE users SET password='$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfvUu' WHERE username='nacos'; - 调整application.properties关键参数：
# 取消以下注释 server.servlet.contextPath=/nacos spring.datasource.platform=mysql
2.2 容器化部署内存优化
对于资源有限的云服务器，必须限制Nacos内存使用：
docker run --name nacos-standalone \ -e MODE=standalone \ -e JVM_XMS=64m -e JVM_XMX=64m -e JVM_XMN=16m \ -p 8848:8848 \ -d nacos/nacos-server常见问题排查：
- 若出现OOM错误，逐步增加JVM_XMS/XMX参数（每次增加32m）
- 访问端口冲突时，检查服务器安全组和防火墙规则
- 数据库连接失败时验证MySQL远程访问权限：
UPDATE mysql.user SET host='%' WHERE user='root'; FLUSH PRIVILEGES;
3. GoJudge判题机实战部署
3.1 云服务器基础环境
# 安装必要工具链 sudo apt-get update sudo apt-get install -y git docker-ce # 配置Go环境（判题机编译依赖） wget https://studygolang.com/dl/golang/go1.14.1.linux-amd64.tar.gz tar -zxvf go1.14.1.linux-amd64.tar.gz -C /usr/local/ echo 'export PATH=$PATH:/usr/local/go/bin' >> /etc/profile source /etc/profile3.2 安全沙箱容器部署
# 启动特权模式容器（必须参数） docker run -d -it --rm --privileged \ --shm-size=256m \ -p 5050:5050 -p 5051:5051 \ criyle/executorserver -enable-grpc # 验证服务端口 netstat -anp | grep 5050关键配置说明：
--privileged：允许容器内进程获取宿主机权限--shm-size：设置共享内存大小，影响判题性能- 双端口设计：5050用于HTTP通信，5051用于gRPC协议
4. 判题服务全链路配置
4.1 JudgeServer打包避坑指南
在pom.xml中必须指定spring-boot-maven-plugin版本：
<plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>2.3.3.RELEASE</version> </plugin>4.2 目录结构规范化
# 创建标准化判题目录树 mkdir -p /hoj/{server,run,spj,log,testcase} # 目录权限设置（根据实际运行用户调整） chown -R www-data:www-data /hoj chmod -R 755 /hoj4.3 服务启动参数优化
# Java服务启动示例（内存限制很重要） java -jar -Xms256m -Xmx512m \ hoj-judgeServer.jar \ --server.port=8088 \ --hoj.judge.token=YOUR_SECRET_KEY重要提示：judge-token必须与Nacos配置中心的值保持一致，否则会导致鉴权失败。建议通过环境变量注入而非硬编码在配置文件中。
5. 前后端联调技巧
5.1 前端项目环境搭建
# 使用cnpm加速依赖安装 npm install -g cnpm --registry=https://registry.npmmirror.com cd hoj-vue cnpm install # 开发模式启动 npm run serve # 生产构建 npm run build5.2 跨域问题解决方案
在vue.config.js中添加代理配置：
devServer: { proxy: { '/api': { target: 'http://your-server-ip:8080', changeOrigin: true, pathRewrite: {'^/api': ''} } } }6. 部署验证与监控
6.1 服务健康检查清单
- [ ] Nacos控制台可访问（8848端口）
- [ ] GoJudge端口响应（5050/5051）
- [ ] JudgeServer接口测试（/api/judge/test）
- [ ] 前端静态资源加载正常
- [ ] Redis连接状态监控
6.2 日志排查要点
# 实时查看判题日志 tail -f /hoj/log/judge.log # 过滤错误信息 grep -E 'ERROR|Exception' /hoj/log/*.log # Docker容器日志查看 docker logs -f go-judge-container在实际部署中遇到最多的问题是环境变量注入失败，特别是当使用Docker Compose编排多个服务时。建议使用.env文件统一管理敏感配置，并通过docker-compose.yml中的env_file指令加载。对于判题超时问题，重点检查沙箱的timeout配置与服务器CPU负载情况。