在云服务(centos7 )上部署halo博客——使用H2数据库

in halo with 0 comment

前言

本教程参考https://halo.run
本教程以 CentOS 7.x 为例,使用阿里服务器,配置并运行 Halo,其他 Linux 发行版大同小异,也应该差不多。
这里的用户为root,根目录为/root,没有什么权限问题,其它用户的话注意权限问题。
halo默认端口为8090,需要外网访问8090端口的,需要在云服务器控制台开放8090端口。
至于如何绑定域名后面再说,这里就讲如何halo博客在我们的服务器跑起来,如何安装jre或者jdk看前面文章。
步骤如下

  1. 现在jar安装包
  2. 测试运行
  3. 将halo设置为服务
  4. 修改默认配置

下载halo安装包兵测试运行

这个可以先下载到本地,然后上传到服务器,也可以直接在服务器上下载。这里以在服务器上下载为例,最新版本可参考https://dl.halo.run/
image

# 下载最新的 Halo 安装包,{{version}} 为版本号,不带 v 版本自行替换
wget http://halo.ryanc.cc/release/halo-{{version}}.jar -O halo-latest.jar

# 或者
wget http://halo.ryanc.cc/release/halo-latest.jar -O halo-latest.jar

# 或者,{{version}} 为版本号,不带 v
wget https://halo.nova.moe/release/halo-{{version}}.jar -O halo-latest.jar

# 备用地址(建议海外服务器使用)
wget https://github.com/halo-dev/halo/releases/download/v1.2.0/halo-1.2.0.jar -O halo-latest.jar

# 启动测试
java -jar halo-latest.jar

只要jre/jdk安装正确,测试启动最后输出如下代表启动成功,不出意外会在用户目录生成隐藏文件夹./halo,shh关闭,该程序(Halo)停止
图片.png

图片.png
Halo 的整个应用程序只有一个 Jar 包,且不包含用户的任何配置,它放在任何目录都是可行的。需要注意的是,Halo 的整个额外文件全部存放在 ~/.halo(隐藏) 目录下,ls -a可查看到 ,包括 application.yaml(用户配置文件,这个需要自己下载的),template/themes(主题目录),upload(附件上传目录),halo.db.mv(数据库文件)。一定要保证 ~/.halo 的存在,你博客的所有资料可都存在里面。所以你完全不需要担心安装包的安危,它仅仅是个服务而已。

run.halo.app.listener.StartedListener    : Halo started at         http://127.0.0.1:8090
run.halo.app.listener.StartedListener    : Halo admin started at   http://127.0.0.1:8090/admin

自定义配置

考虑到部分用户的需要,可能需要自定义比如端口等设置项,我们提供了公共的配置文件,并且该配置文件是完全独立于安装包的。当然,你也可以使用安装包内的默认配置文件,但是安装包内的配置文件是不可修改的。请注意:配置文件的路径为 ~/.halo/application.yaml。

# 下载配置文件到 ~/.halo 目录并重命名 ~是一般为用户目录,比如我为/root
curl -o ~/.halo/application.yaml --create-dirs http://halo.ryanc.cc/config/application-template.yaml

修改配置文件,如果觉得vim难用,也可以使用第三方的连接工具,直接修改

# 使用 Vim 工具修改配置文件
vim ~/.halo/application.yaml

打开后能看到如下,这里使用的是H2数据库,除了端口外,其它基本不需要动。

1. 如果需要自定义端口,修改 server 节点下的 port 即可。
2. 默认使用的是 H2 Database 数据库,这是一种嵌入式的数据库,使用起来非常方便。需要注意的是,默认的用户名和密码为 admin 和 123456,这个是自定义的,最好将其修改,并妥善保存。
3. 如果需要使用 MySQL 数据库,需要将 H2 Database 的所有相关配置都注释掉,并取消 MySQL 的相关配置。另外,MySQL 的默认数据库名为 halodb,请自行配置 MySQL 并创建数据库,以及修改配置文件中的用户名和密码。
4. h2 节点为 H2 Database 的控制台配置,默认是关闭的,如需使用请将 h2.console.settings.web-allow-others 和 h2.console.enabled 设置为 true。控制台地址即为 域名/h2-console。注意:非紧急情况,不建议开启该配置。
5. server.compression.enabled 为 Gzip 功能配置,如有需要请设置为 true,需要注意的是,如果你使用 Nginx 或者 Caddy 进行反向代理的话,默认是有开启 Gzip 的,所以这里可以保持默认。
6. halo.admin-path 为后台管理的根路径,默认为 admin,如果你害怕别人猜出来默认的 admin(就算猜出来,对方什么都做不了),请自行设置。仅支持一级,且前后不带 /。
7. halo.cache 为系统缓存形式的配置,可选 memory 和 level,默认为 memory,将数据缓存到内存,使用该方式的话,重启应用会导致缓存清空。如果选择 level,则会将数据缓存到磁盘,重启不会清空缓存。如不知道如何选择,建议默认。
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

将Halo设置为服务

上面我们已经完成了 Halo 的整个配置和安装过程,接下来我们对其进行更完善的配置,比如:需要开机自启?,更简单的启动方式?
实现以上功能我们只需要新增一个配置文件即可,也就是使用 Systemd 来完成这些工作。

# 下载 Halo 官方的 halo.service 模板
sudo curl -o /etc/systemd/system/halo.service --create-dirs http://halo.ryanc.cc/config/halo.service
# 修改 halo.service
sudo vim /etc/systemd/system/halo.service
[Unit]
Description=Halo Service
Documentation=https://halo.run
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/bin/java -server -Xms256m -Xmx256m -jar YOUR_JAR_PATH
ExecStop=/bin/kill -s QUIT $MAINPID
Restart=always
StandOutput=syslog

StandError=inherit

[Install]
WantedBy=multi-user.target

1. -Xms256m:为 JVM 启动时分配的内存,请按照服务器的内存做适当调整,512 M 内存的服务器推荐设置为 128,1G 内存的服务器推荐设置为 256,默认为 256。
2.  -Xmx256m:为 JVM 运行过程中分配的最大内存,配置同上
3.  YOUR_JAR_PATH:Halo 安装包的绝对路径,这个必须要修改的,例如 /root/halo/halo-latest.jar。

如果按照前面方式安装的jre,其它的基本不需要改。如果不是请确保 /usr/bin/java 是正确无误的,或者将路径指向jre/jdk的安装目录。 systemd 中的所有路径均要写为绝对路径,另外,~ 在 systemd 中也是无法被识别的,所以你不能写成类似 ~/halo-latest.jar 这种路径。 如何检验是否修改正确:把 ExecStart 中的命令拿出来执行一遍。

修改 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

升级的话需要备份的话,可以先备份安装包,不需要的的话,直接下载最新安装包然后重启即可(注意前后名字应该保持一致)。

# 备份旧的安装包
mv halo-latest.jar halo-latest.jar.bak

# 下载最新的 Halo 安装包,{{version}} 为版本号,不带 v
wget http://halo.ryanc.cc/release/halo-{{version}}.jar -O halo-latest.jar

# 或者
wget http://halo.ryanc.cc/release/halo-latest.jar -O halo-latest.jar

# 或者,{{version}} 为版本号,不带 v
wget https://halo.nova.moe/release/halo-{{version}}.jar -O halo-latest.jar

# 备用地址(建议海外服务器使用)
wget https://github.com/halo-dev/halo/releases/download/v1.2.0/halo-1.2.0.jar -O halo-latest.jar

# 重启应用
service halo restart

X O