jcalaBlog 快速部署指南Docker Compose 一键启动 MySQL 与博客应用【免费下载链接】jcalaBloga personal blog site based on springbootsrpingMVCmybatisvelocitybootstrapmysql项目地址: https://gitcode.com/gh_mirrors/jc/jcalaBlog还在为搭建个人博客发愁本文是一份面向初学者的jcalaBlog 部署指南手把手教你使用Docker Compose一键启动MySQL 数据库并运行基于 Spring Boot Spring MVC MyBatis Velocity 的 jcalaBlog 博客应用。全程无需手动安装 MySQL、无需繁琐配置最快10 分钟即可在本地拥有一套功能完整的个人博客系统包括 Markdown 写作、标签归档、一键夜间模式与后台管理。jcalaBlog 是什么一个轻量强大的个人博客系统jcalaBlog 是一个开源的响应式个人博客网站后端采用Spring Boot全家桶Spring MVC MyBatis Velocity前端基于 Bootstrap数据库使用 MySQL并集成了 editor.md 提供所见即所得的 Markdown 编辑体验。它自带以下特色功能✍️Markdown 编辑器左侧编辑、右侧实时预览支持代码高亮与主题切换一键夜间模式点击导航栏 NIGHT/DAY 按钮白昼模式无缝切换️标签与归档按标签分类博客自动生成时间归档后台管理博客增删改、项目管理、个人信息与简历维护一应俱全轻量部署内置 Docker Compose 编排文件数据库一键拉起部署前需要准备什么开始之前请确保本机满足以下环境要求基本都是开发者的标配依赖版本要求用途Docker18.0含 Docker Compose一键启动 MySQLJDK1.8编译运行 Spring Boot 应用Gradle5.x 或使用项目自带 wrapper构建项目项目自带gradlew包装脚本即使本机没有安装 Gradle 也可以直接构建非常省心。第一步获取 jcalaBlog 源码首先将项目克隆到本地git clone https://gitcode.com/gh_mirrors/jc/jcalaBlog cd jcalaBlog克隆完成后你会看到项目根目录下的 docker-compose.yml 编排文件、gradlew 构建脚本以及src/main下的完整 Java 源码。第二步Docker Compose 一键启动 MySQL 数据库项目已经为你写好了 docker-compose.yml其中定义了 MySQL 5.7.17 容器默认账号密码为root / root端口映射到本机3306并将数据持久化到./mysql/mysql_data目录容器删掉数据也不丢。最快配置方法准备 MySQL 配置文件Compose 中挂载了/etc/mysql/conf.d/mysql_db.cnf请先手动创建该文件并写入UTF-8 字符集配置这一步能避免后续博客内容中文乱码mkdir -p mysql vim mysql/mysql_db.cnf文件内容如下[mysqld] character-set-serverutf8 collation-serverutf8_general_ci一键安装步骤启动 MySQL 容器在项目根目录执行docker-compose up -d mysql等待镜像拉取完成后使用下面的命令确认容器健康运行docker ps docker exec -it mysql mysql -uroot -proot为博客创建数据库jcalaBlog 连接的是名为jcala_blog的数据库需要提前创建注意使用 UTF-8 字符集CREATE DATABASE IF NOT EXISTS jcala_blog DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; 提示如果本机 3306 端口已被其他 MySQL 占用请先停止原服务或修改 docker-compose.yml 中的端口映射。第三步确认数据库连接配置项目默认激活dev环境见 application.yml开发环境的数据库连接配置位于 application-dev.ymlspring: datasource: username: root password: root url: jdbc:mysql://127.0.0.1:3306/jcala_blog?useUnicode:trueamp;characterEncoding:UTF-8 initialize: true默认连接地址127.0.0.1:3306与 Docker 映射的端口完全一致无需任何修改即可直接使用。initialize: true表示启动时自动执行 import.sql建表和 data.sql初始化数据表结构与示例文章会自动生成。第四步一键启动博客应用数据库就绪后在项目根目录执行./gradlew bootRunWindows 用户执行gradlew.bat bootRun等待 Gradle 下载依赖并完成编译看到 Spring Boot 启动日志后打开浏览器访问http://localhost:8080首页默认采用大图背景 三栏社交按钮的落地页设计向下滚动即可浏览博客列表、标签与归档内容。第五步登录后台管理与写作后台管理入口为导航栏的Admin地址为http://localhost:8080/admin初始账号密码均为admin。登录后左侧菜单包含 Monitor监控、Add Blog写博客、Blog List博客列表、Project项目、Info信息、Resume简历等模块Add Blog进入内置 editor.md 的写作页面左侧写 Markdown右侧实时预览支持代码块、表格、图片与主题样式切换Blog List以表格形式管理所有文章可编辑、删除并支持分页Info / Resume维护关于页的个人信息与在线简历常见问题排查与优化建议1. 页面中文显示乱码怎么办确认mysql/mysql_db.cnf中已配置character-set-serverutf8并重新创建数据库删除后重建jcala_blogSpring Boot 首次启动会自动重新执行建表脚本。2. 二次开发时报错缺少 getter/setter 方法项目使用了 Lombok 自动生成实体类方法请在 IDEA / Eclipse 中安装Lombok 插件并开启注解处理Annotation Processing。3. 生产环境部署如何切换端口参考 application-prod.yml生产环境默认监听 80 端口并关闭了数据库自动初始化initialize: false可将spring.profiles.active改为prod后构建部署。4. 想深入学习源码启动入口Application.java控制器层src/main/java/me/jcala/blog/controller/前端 FontEndCtrl.java、后台 admin 包服务与映射src/main/java/me/jcala/blog/service/、src/main/java/me/jcala/blog/mapping/页面模板src/main/resources/templates/Velocity 模板含 index、post、admin 等总结通过这套jcalaBlog 部署指南你仅需两条命令即可完成数据库与博客应用的启动docker-compose up -d mysql拉起MySQL./gradlew bootRun运行博客。无论是本机学习、二次开发还是快速搭建个人站点jcalaBlog 都称得上一个开箱即用的Spring Boot 博客项目赶快动手试试吧【免费下载链接】jcalaBloga personal blog site based on springbootsrpingMVCmybatisvelocitybootstrapmysql项目地址: https://gitcode.com/gh_mirrors/jc/jcalaBlog创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考