Halo 开源项目学习（一）：项目启动

项目启动

Halo 是一个优秀的开源博客发布应用，在 GitHub 上广受好评，正好最近在练习写博客，借此记录一下学习 Halo 的过程。

项目下载

从 GitHub 上拉取项目源码，Halo 从 1.4.3 开始，最低支持的 JRE 版本为 11，因为本人一直使用 JDK 1.8，所以下载了之前的版本 1.3.2。

在 idea 中导入项目，Halo 使用 Gradle 构建，与 Maven 不同，Gradle 项目的依赖在 build.gradle 中添加。

Halo 中主要使用了如下依赖：

• Spring Boot：一个用来简化 Spring 的搭建和开发过程的全新框架；
• Spring Data JPA：持久层框架；
• Spring Web：构建 Web 应用；
• Undertow：高性能 Web 容器；
• Freemarker：模板引擎；
• H2 Database：嵌入式数据库，无需安装；
• MySQL：关系型数据库；
• Lombok：Java 高效开发工具；
• Swagger：生成接口文档；
• Hutool：开源 Java 工具类；
• 七牛云：云存储服务器；
• 阿里云 OSS：提供海量、安全、低成本、高可靠的云存储服务；
• Flexmark：将 Markdown 转化为 HTML。

修改配置文件

Halo 默认使用 H2 Database，该数据库无需安装，因此可以直接启动项目。因为本人比较熟悉 MySQL，所以在 application.yaml 文件中注释掉了 H2 Database 的配置，并添加 MySQL 的相关配置（数据库名为 'halodb'）：

    # MySQL 配置
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: 123456

启动项目

前提准备

项目启动前请做好如下准备：

1. 确保 JDK 的版本符合要求，本文使用 JDK 1.8；
2. 确保所有的依赖都正常导入（本次实践未发生异常）；
3. 如果使用 MySQL，则需要创建对应的数据库（如上文配置的 'halodb'，数据表无需创建）。

运行

点击运行，项目正常启动。

控制台信息：

上述信息提示我们访问 127.0.0.1:8090，首次访问该页面时，页面会重定向到初始化页面，用户需要设置博主、博客的相关信息，如用户名、密码等。

安装：

信息填写完毕后，点击安装，之后页面会跳转到登录页面，此时用户可以使用之前设置的账号和密码进行登录。登录成功后进入 'Halo Dashboard' 页面，且系统会自动创建一篇文章 'Hello Halo!'。'Halo Dashboard' 页面是博客的后台管理页面，供管理员使用，访问 127.0.0.1:8090/admin 时就会进入该页面（需登录）。博客的主页可访问 127.0.0.1:8090，在该页面可看到博主发表的所有文章。

后台管理界面：

博客首页：

到此，Halo 项目在 idea 上启动成功。