HOJ实战：从零部署到功能扩展的完整开发指南
1. 环境准备与基础部署
在CentOS系统上部署HOJ在线判题系统，宝塔面板是最便捷的选择。我实测过多次，用宝塔可以省去80%的配置时间。首先确保你的服务器满足最低配置要求：2核CPU、4GB内存、50GB硬盘空间。这个配置足够支撑中小规模的在线判题需求。
安装宝塔面板只需要一行命令：
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh安装完成后，记得在宝塔面板的安全组中放行以下端口：80(HTTP)、443(HTTPS)、3306(MySQL)和8888(宝塔默认端口)。这里有个小技巧，我建议把默认的8888端口改成其他不常见的端口号，能有效减少被扫描的风险。
接下来安装必要的运行环境：
- Nginx 1.20+
- MySQL 5.7+
- PHP 7.4+
- PM2管理器
- Docker管理器
安装完这些基础组件后，创建一个新的MySQL数据库，字符集选择utf8mb4，这个字符集支持完整的Unicode字符，包括emoji表情。我遇到过学生提交代码时用了特殊符号导致乱码的问题，utf8mb4能完美解决。
2. HOJ核心组件安装与配置
HOJ系统由三个核心组件构成：前端、后端和判题服务。我建议按照这个顺序安装，因为前端依赖后端API，而后端又依赖判题服务。
先下载最新的HOJ发行版，解压后你会看到三个主要目录：
hoj-frontend：基于Vue.js的前端项目hoj-backend：Spring Boot后端项目hoj-judgeserver：判题服务
配置Nginx反向代理时，有几点需要注意：
- 静态资源缓存设置要合理，我一般设置图片/css/js缓存30天
- 开启gzip压缩能显著提升加载速度
- WebSocket配置要正确，否则实时判题结果无法推送到前端
数据库连接配置在application.yml文件中，这里有个坑要注意：MySQL的时区设置。建议在连接字符串后加上?serverTimezone=Asia/Shanghai，否则可能会遇到时间显示不正确的问题。
3. 系统功能扩展实战
HOJ的二次开发主要集中在前端组件和后端API两部分。以添加签到功能为例，我来分享下具体实现步骤。
首先在前端src/views目录下新建SignIn.vue组件，这个组件需要：
- 显示签到日历
- 记录连续签到天数
- 显示签到奖励
后端需要新增三个API接口：
/api/signin/check检查今日是否已签到/api/signin/do执行签到操作/api/signin/history获取签到历史
数据库层面需要新建user_signin表，包含字段：
- id (主键)
- user_id (用户ID)
- sign_date (签到日期)
- continuous_days (连续签到天数)
这里有个性能优化点：签到记录会随时间增长，建议按月分表存储，比如user_signin_202307。我在实际项目中测试过，百万级数据查询速度能提升5倍以上。
4. Docker化部署与持续集成
将定制化的HOJ系统打包成Docker镜像是团队协作的最佳实践。每个功能扩展完成后，都应该生成新的Docker镜像。
编写Dockerfile时要注意多阶段构建，可以显著减小镜像体积。这是我的一个优化后的Dockerfile示例：
# 构建阶段 FROM maven:3.8-jdk-11 AS build COPY . /app WORKDIR /app RUN mvn clean package -DskipTests # 运行阶段 FROM openjdk:11-jre-slim COPY --from=build /app/target/hoj-backend.jar /app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","/app.jar"]使用CI/CD工具自动化这个过程能节省大量时间。我通常用GitHub Actions，配置如下关键步骤：
- 代码push触发构建
- 运行单元测试
- 构建Docker镜像
- 推送到私有镜像仓库
- 在测试服务器部署
这套流程跑下来，从代码提交到生产环境部署最快只要10分钟。特别提醒一点：记得在CI配置中妥善保管你的Docker登录凭证，我吃过泄露的亏。