SG-Exam 部署与快速上手如何跑起一套 Spring Boot 在线考试系统【免费下载链接】sg-exam基于Spring Boot搭建的新一代教学管理平台提供权限管理、考试、问卷、练习等功能项目地址: https://gitcode.com/gh_mirrors/sg/sg-exam想搭一套能开卷组考、管课程、评成绩的在线考试平台SG-Exam 就是干这个的基于 Spring Boot Vue覆盖在线考试、练习、问卷、课程和精细化权限管理。这篇文章带你从 clone 仓库到系统跑起来全程约 10 分钟。仓库第一眼先认这几样东西clone 下来先别急着点运行花一分钟看清这几个关键部分docker-compose.yml部署的总开关MySQL、Redis、MinIO 和主服务都在里面编排config-repo/所有运行期配置都在这——application.yml、环境变量、MySQL 初始化脚本、Nginx 配置frontend/三个前端并列web 端学员考试、admin 端后台管理、mobile 端H5sg-user-service等 Java 模块后端多模块工程settings.gradle 里列了全部模块项目架构长这样一图看清三个前端怎么挂到后端服务上快速跑起来Docker 最小启动步骤方式一Docker 部署推荐环境只需 Docker 和 Docker Compose。容器内已打包好 Nginx JDK 17不需要单独装 Java 环境git clone https://gitcode.com/gh_mirrors/sg/sg-exam cd sg-exam ./setup.sh -setup # 下载并加载离线镜像 ./setup.sh -start # 启动全部服务启动后浏览器访问http://localhost/Nginx 端口 80走的是 config-repo/nginx/nginx.conf 的路由http://localhost:8080是后端接口。方式二本地源码启动适合开发调试需要 JDK 17、MySQL、Redis、Node。后端入口是 sg-user-service/src/main/java/com/github/tangyi/UserServiceApplication.java用 Gradle 启动./gradlew :sg-user-service:bootRundevprofile 默认用 H2 文件库并自动执行建表脚本config-repo/h2/schema-h2.sql不装 MySQL 也能先跑起来看效果H2 控制台在/h2路径。前端则在frontend/sg-exam-web等目录里yarn安装后yarn serve起本地服务。想改功能按这个路径找代码后端是 Gradle 多模块工程像一条流水线sg-common是公共零件库sg-api定义接口和模型业务服务调用它们。改功能时记住这几个落点题库、考试模式、成绩计算 → sg-exam-service/考试业务核心都在这登录、用户、角色权限 → sg-user-service/Controller/Service 分层接口文档开了 Swagger/swagger-ui.html新增表想偷懒 →sg-generator代码生成器对着表结构一键生成 CRUD学员端页面 →frontend/sg-exam-web管理端页面 →frontend/sg-exam-admin配置要点真正影响运行的只有这几处1. 数据库与中间件 —— config-repo/sg-exam.env这是最关键的环境变量文件SG_DB_USER_HOST/SG_DB_USER_PASSWORD指向 MySQLSG_REDIS_USER_HOST指向 Redis。用自带容器时保持默认服务名mysql-service、redis-service即可换外部数据库就改成对应 IP。2. 存储 ——ATTACH_DEFAULT_STORAGE_TYPE默认 2MinIO。想换七牛云改为 1 并填 AK。重点注意MINIO_ACCESS_DOMAIN它决定前端怎么访问上传的图片/视频部署到服务器后必须改成服务器IP端口的访问地址结尾不能带反斜杠否则图片全挂。3. 端口与多环境 —— config-repo/sg-user-service.yml服务端口默认 8080context-path 是/sg-user-service。配置里用spring.profiles切环境dev走 H2docker走 MySQLSPRING_PROFILES_ACTIVE在 env 文件里指定一般不用动。常见坑与 FAQ图片/音频访问不到九成是MINIO_ACCESS_DOMAIN没配成真实可访问地址或结尾多了/3306、6379 端口被占compose 里内置了 MySQL/Redis如果机器上已跑同端口服务要么删掉 compose 里对应段改用外部实例要么改映射端口本地启动连不上数据库确认用了devprofileH2 自动建表否则需要先在 MySQL 里执行 config-repo/mysql/init.sql前端跨域/接口 404本地开发时注意后端 context-path 是/sg-user-service接口路径别漏前缀写在最后一句话总结compose 一把梭部署env 文件改三处连接dev profile 下 H2 零依赖试跑——SG-Exam 的上手成本确实不高。想深入的话docs/ 里有数据库设计文档CHANGELOG.md 记录了版本演进项目采用 Apache 2.0 协议欢迎直接提 issue 或 PR 参与完善。【免费下载链接】sg-exam基于Spring Boot搭建的新一代教学管理平台提供权限管理、考试、问卷、练习等功能项目地址: https://gitcode.com/gh_mirrors/sg/sg-exam创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考