跳至主要內容

Halo 博客搭建教程

村雨遥原创大约 6 分钟博客搭建halo博客

Halo 博客搭建教程

前言

说在前面

之前一直有在各大平台发布博客内容，然后个人博客一直使用的是 Hexo + Github Pages 的方式，但随着内容增多，Github Pages 访问的也不稳定，所以想着自己搞个服务器和域名搭个博客，最终选定 Haloopen in new window 这个博客框架，搭建属于自己的博客。

此内容从零到一手把手记录如何搭建，记录自己的搭建过程，也给后面的朋友们提供一个指南，少走些冤枉路，尽快上手。

环境配置

自己花了 210 左右在 UCloud 买了三年的服务器，然后在腾讯花了将近 200 买了个域名，服务器版本是 Ubuntu 18.04 64 位，理论上讲下面的配置适合于 Ubuntu 系所有版本，个别有出入的地方还请谅解。所以在正式开始之前，你需要满足以下几个条件：

  1. 一台 Ubuntu 系统的服务器（Centos 系统的参考 官网教程open in new window 即可）；
  2. 一个域名；

Java 环境配置

安装

  1. 首先去 官网open in new window 下载 JDK，选择自己想要的版本即可，一般推荐 JDK 1.8+ 的版本；
  1. 解压下载后的文件；
tar -zxvf jdk-11.0.9_linux-x64_bin.tar.gz
  1. 配置环境变量，切换到 root 用户，然后编辑 /etc/profile 文件，添加如下内容（注意路径切换为你自己放置解压缩包后的位置）；
export JAVA_HOME=/environment/jdk/jdk-11.0.9
export PATH=$JAVA_HOME/bin:$PATH

验证

安装好之后就是验证是否成功，一般我们用如下命令进行检测；

# 查看 jdk 版本
java -version

# 编译命令
javac

# 运行命令
java

安装 Halo

下载 Halo 运行包

要下载 Halo 运行包，可以通过两种方式，更推荐第二种，下载起来更快：

  1. Github releases：https://github.com/halo-dev/halo/releases
  2. Nova 提供的下载站：https://dl.halo.runopen in new window

利用如下命令进行下载，以 1.4.2 版本为例，如果要下载其他版本，换版本号即可！

wget https://dl.halo.run/release/halo-1.4.2.jar

配置

  1. 下载配置文件（下载后的文件存放在 ~/.halo/application.yaml）；
curl -o ~/.halo/application.yaml --create-dirs https://dl.halo.run/config/application-template.yaml
  1. 修改配置，参考 官方文档open in new window 修改即可；
server:
  port: 8090

  # Response data gzip.
  compression:
    enabled: false
spring:
  datasource:
    # H2 database configuration.
    driver-class-name: org.h2.Driver
    url: jdbc:h2:file:~/.halo/db/halo
    username: admin
    password: 123456

    # MySQL database configuration.
  #    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

  # H2 database console configuration.
  h2:
    console:
      settings:
        web-allow-others: false
      path: /h2-console
      enabled: false

halo:
  # Your admin client path is https://your-domain/{admin-path}
  admin-path: admin

  # memory or level
  cache: memory

运行 Halo

配置好 Java 环境，同时下载好 Halo 运行包之后，我们就可以使用如下命令运行了；

java -jar halo-latest.jar

然后在本地浏览器中访问如下地址即可；

http://ip:8090

进阶配置

开机自启

  1. 下载 Halo 官方 service 模板，然后对其进行修改（此时需要管理员权限）；
sudo curl -o /etc/systemd/system/halo.service --create-dirs https://dl.halo.run/config/halo.service
  1. 修改配置文件

具体可以参考 官方文档open in new window；

需要注意的几点：

  • 填写你的 JDK 绝对路径；
  • 填写你的 Halo 运行包所在绝对路径；
  • 填写运行 Halo 服务的用户名；
  1. 测试
# 修改 service 后需要 Systemd
sudo systemctl daemon-reload

# 使 Halo 开机自启
sudo systemctl enable halo

# 启动 Halo
sudo service halo start

# 重启 Halo
sudo service halo restart

# 停止 Halo
sudo service halo stop

# 查看 Halo 的运行状态
sudo service halo status

Halo 更新

Halo 是一个活跃的社区，目前一直在开发迭代中，后续如果发布了新的版本，而我们又想要升级，这时候就可以按照如下步骤来进行操作了；

  1. 首先，我们需要对我们原有数据进行备份，防止丢失
cp -r ~/.halo ~/.halo.bak
  1. 接着备份久的 Halo 安装包，防止新的安装包出现问题后无法回滚；
mv halo-latest.jar halo-latest.jar.bak
  1. 做好备份工作之后，就是下载最新的 Halo 安装包了，其中 {{verison}} 对应最新版本号；
wget https://dl.halo.run/release/halo-{{version}}.jar -O halo-latest.jar
  1. 测试一下最新版的 Halo 能否运行成功；
java -jar halo-latest.jar
  1. 测试步骤如果成功了，那我们直接重启 Halo 服务就好了；
sudo service halo restart

域名访问

通过上面的配置之后，我们只能通过 ip:port 的方式进行访问，如果我们想让别人来访问，那么有一个域名就十分有必要了。在正式进行配置域名之前，需要确保如下几件准备工作：

  1. Halo 已经能够正确运行，且运行端口不是 80 端口；
  2. 确保域名解析到服务器 IP，而且确保服务器已经备案（国内服务器都需要，国外无需）；
  3. 打开服务器的 80 和 443 端口；

配置域名解析服务器 IP

因为我的域名是在腾讯买的，所以这里以腾讯为例；

  1. 首先打开 域名解析列表open in new window，并点击右侧解析进入解析界面；
  1. 接着添加记录；

添加如下两条记录，其他字段保持默认即可；

主机记录记录类型记录值
@A你的服务器 IP
wwwA你的服务器 IP

打开服务器对应端口

  1. 登录你的服务器，然后打开主机管理界面；
  2. 接着编辑防火墙，将需要打开的端口打开即可，一般打开如下的协议端口就可以了；
  • ICMP
  • 3389
  • 80
  • 443
  • 21
  • 22
  • 8090

利用 Nginx 进行反向代理

  1. 安装 Nginx
sudo apt-get install nginx
  1. 设置开机自启动 Nginx
systemctl enable nginx
  1. 启动 Nginx
sudo service nginx start
  1. 配置 Nginx

首先下载 Halo 官方的 Nginx 配置模板；

curl -o /etc/nginx/conf.d/halo.conf --create-dirs https://dl.halo.run/config/nginx.conf

然后对其进行修改；

sudo vim /etc/nginx/conf.d/halo.conf

只需要将其中的 example.com 修改成自己的域名即可，比如我的域名是 cunyu1943.site；

server {
    listen 80;

    server_name example.com www.example.com;

    location / {
        proxy_set_header HOST $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_pass http://127.0.0.1:8090/;
    }
}
  1. 自动配置 SSL 证书

首先安装 certbot nginx 插件；

sudo apt-get install python-certbot-nginx

接着执行配置，过程中会询问为哪个域名添加证书，以及是否重定向，如实选择即可；

sudo certbot --nginx

最后，设置自动续约即可；

sudo certbot renew --dry-run
  1. 完成上述步骤之后，大功告成了，我们就可以通过自己的域名来访问自己的博客了，比如我的博客就是：

https://cunyu1943.site

总结

好了，经过上面的一系列设置，我们的博客就搭建完成了，是不是好简单的说，那就别犹豫，赶紧动手搞起来吧！

最后再贴以下自己的博客地址，欢迎大家来留言，交换友链呀！

https://cunyu1943.site

上次编辑于:
贡献者: 村雨遥
All rights reserved.
Copyright © 2024 村雨遥