用Halo+宝塔面板搭建一个自己的网站
本文最后更新于 2023-05-14,文章内容可能已经过时。
由于halo现版本已更新使用jdk11以下内容可能不适合新版本的搭建。
搭建教程可以查看halo官方文档:https://docs.halo.run/
前期准备
- 一个可解析的域名(没有域名可以使用公网IP+端口号的方式访问,但这样就要记一段v4协议的IP地址并且不太方便所以不建议这么操作)
- 一台远端服务器(可以是阿里云、华为云、腾讯云等云服务提供商)
注意:在中国境内的服务器搭建网站必须进行ICP备案和公安局备案如使用的不是中国境内的可以不用
- Linux命令的基本知识
官方链接
以下为Halo官方在GitHub的库:https://github.com/halo-dev/halo
Halo的官方网站:https://halo.run/
Halo的官方主题仓库:https://halo.run/themes.html
Halo官方的搭建教程:https://docs.halo.run/
开始搭建
环境要求
为了在使用过程中不出现意外的事故,给出下列推荐的配置
- CentOS 7.x或更高
- 512 MB 以上内存(建议使用1G)
服务器配置
使用SSH登录到服务器先更新软件包
sudo yum update -y
安装 Java 运行环境
如果已经存在Java运行环境的可以跳过这一部操作
安装OpenJRE
sudo yum install java-1.8.0-openjdk -y
检测是否安装成功
java -version
如果显示以下信息就表示安装成功
openjdk version "1.8.0_265"
OpenJDK Runtime Environment (build 1.8.0_265-b01)
OpenJDK 64-Bit Server VM (build 25.265-b01, mixed mode)
创建一个低权限的用户用于运行Halo
sudo useradd -m xxx
# xxx代表用户名 如创建用户名为a的用户
# sudo useradd -m a(以此类推,用户名可随意创建)
登录到该用户
sudo su xxx
安装 Halo
下载官方配置文件
Halo官方考虑到部分用户的需要,可能需要自定义比如端口等设置项,他们提供了公共的配置文件,并且该配置文件是完全独立于安装包的。当然,你也可以使用安装包内的默认配置文件,但是安装包内的配置文件是不可修改的。请注意:配置文件的路径为
/.halo/application.yaml
# 下载配置文件到 ~/.halo 目录
curl -o ~/.halo/application.yaml --create-dirs https://dl.halo.run/config/application-template.yaml
修改配置文件
# 使用 Vim 工具修改配置文件
vim ~/.halo/application.yaml
打开之后可以看见
默认的端口是8090这里我们不做修改
建议吧H2数据库的用户名admin和密码123456修改成为你自己的 用户名跟密码可随意
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
- 如果需要自定义端口,修改 server 节点下的 port 即可。
- 默认使用的是 H2 Database 数据库,这是一种嵌入式的数据库,使用起来非常方便。需要注意的是,默认的用户名和密码为 admin 和 123456,这个是自定义的,最好将其修改,并妥善保存。
- 如果需要使用 MySQL 数据库,需要将 H2 Database 的所有相关配置都注释掉,并取消 MySQL 的相关配置。另外,MySQL 的默认数据库名为 halodb,请自行配置 MySQL 并创建数据库,以及修改配置文件中的用户名和密码。
- h2 节点为 H2 Database 的控制台配置,默认是关闭的,如需使用请将 h2.console.settings.web-allow-others 和 h2.console.enabled 设置为 true。控制台地址即为 域名/h2-console。注意:非紧急情况,不建议开启该配置。
- server.compression.enabled 为 Gzip 功能配置,如有需要请设置为 true,需要注意的是,如果你使用 Nginx 或者 Caddy 进行反向代理的话,默认是有开启 Gzip 的,所以这里可以保持默认。
- halo.admin-path 为后台管理的根路径,默认为 admin,如果你害怕别人猜出来默认的 admin(就算猜出来,对方什么都做不了),请自行设置。仅支持一级,且前后不带 /。
- halo.cache 为系统缓存形式的配置,可选 memory 和 level,默认为 memory,将数据缓存到内存,使用该方式的话,重启应用会导致缓存清空。如果选择 level,则会将数据缓存到磁盘,重启不会清空缓存。如不知道如何选择,建议默认。
注意
使用 MySQL 之前,必须要先新建一个 halodb 数据库,MySQL 版本需 5.7 以上。
create database halodb character set utf8mb4 collate utf8mb4_bin;
测试运行 Halo
Halo 的整个应用程序只有一个 Jar 包,且不包含用户的任何配置,它放在任何目录都是可行的。需要注意的是,Halo 的整个额外文件全部存放在 ~/.halo 目录下,包括 application.yaml(用户配置文件),template/themes(主题目录),upload(附件上传目录),halo.db.mv(数据库文件)。一定要保证 ~/.halo 的存在,你博客的所有资料可都存在里面。所以你完全不需要担心安装包的安危,它仅是个服务而已。
# 下载最新的 Halo 安装包,目前最新的版本为1.4.1,更多下载地址请访问 https://halo.run/archives/download.html
wget https://halo.cary.tech/release/halo-1.4.1.jar -O halo-latest.jar
# 启动测试
java -jar halo-latest.jar
当你看到下面的日志输出时,就代表你已经启动成功了.
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
run.halo.app.listener.StartedListener : Halo has started successfully!
提示
以上的启动仅仅为测试 Halo 是否可以正常运行,如果我们关闭 ssh 连接,Halo 也将被关闭。要想一直处于运行状态,请继续看下面的教程。
上面已经完成了 Halo 的整个配置和安装过程,接下来我们对其进行更完善的配置,比如:需要开机自启?,更简单的启动方式?
实现以上功能我们只需要新增一个配置文件即可,也就是使用 Systemd 来完成这些工作。
如果当前用户为 halo 用户,则需要退出 halo 用户,进入一个拥有管理员权限的用户下:
# 查看当前登录用户
whoami
# 退出 当前用户 登录,进入一个有管理员权限的用户
如:root或者是你创建的其他带管理员权限的用户
su xxx 或者直接 exit
# 下载 Halo 官方的 halo.service 模板
sudo curl -o /etc/systemd/system/halo.service --create-dirs https://dl.halo.run/config/halo.service
下载完成之后,还需要对其进行修改。
# 修改 halo.service
sudo vim /etc/systemd/system/halo.service
使用 VIM 编辑器打开之后我们可以看到
[Unit]
Description=Halo Service
Documentation=https://halo.run
After=network-online.target
Wants=network-online.target
[Service]
User=halo
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
参数:
-Xms256m:为 JVM 启动时分配的内存,请按照服务器的内存做适当调整,512 M 内存的服务器推荐设置为 128,1G 内存的服务器推荐设置为 256,默认为 256。
-Xmx256m:为 JVM 运行过程中分配的最大内存,配置同上。
YOUR_JAR_PATH:Halo 安装包的绝对路径,例如 /www/wwwroot/halo-latest.jar。
提示
- 如果你不是按照上面的方法安装的 JDK,请确保 /usr/bin/java 是正确无误的。
- 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
在提供商的控制台安全策略里面放通8090端口
完成以上操作即可通过 IP+端口 访问了。
然后接下来安装宝塔面板
进入宝塔Linux面板的官网:https://www.bt.cn/bbs/thread-19376-1-1.html
里面有很多系统的安装命令找到了自己相应系统的安装命令复制到SSH安装即可
在安装过程中记得去安全策略里面放通默认的8888端口如后期修改了端口也需要去安全策略里放通
等待安装完成后提示的IP+端口号即可登录宝塔面板的后台
注意:安装完成后有默认的账户跟密码必须使用他创建的账户密码登录
登录进后台之后勾选完用户协议后会弹出一个窗口让你安装一些环境我们只需要安装一个 Nginx 1.18.0 即可其他的都可以取消勾选
修改默认的用户名跟密码
在安装过程中我们还可以去吧默认的用户名、密码和安全入口修改了(如果你不嫌麻烦也可以使用他默认创建的账户密码)
创建站点
等待 Nginx 1.18.0 安装完成之后就可开始创建站点
在域名处输入你购买的域名比如:WWW开头+域名的等等都是可以的其他的保持默认即可
设置反向代理
然后去到反向代理里添加反向代理
名称可随意填写 目标URL输入http:127.0.0.1:8090即可
这时候你就可以通过域名直接访问了
但是访问进去之后你会发现页面乱七八糟没有样式,这时候你只需要去后台吧地址修改成你域名的地址就可以了。
设置SSL证书
设置完反向代理之后点击SSL,获取免费的SSL证书;SSl证书用于使用常用的HTTPS协议访问
我们可以申请免费Let’s Encrypt的SSl证书在申请证书之前请确保你的80跟443端口是开放的
如你的服务器搭建在国内请你确保你的服务器已完成ICP备案和公安局备案否则可能出现SSL证书无法申请的情况
ICP备案可在你的服务器提供商内根据相关提示完成即可 公安局备案需要去到:全国互联网安全服务平台选择 联网备案登录 进行备案。ICP备案是必须的,公安局备案不是必须的 但建议大家都两个都进行备案。
在完成SSl证书申请后可以选择打开强制HTTPS按钮
别忘记了在服务器提供商的控制台里去放通80跟443端口还有宝塔面板的端口哦,在搭建完成之后可以关闭默认的8090端口 如果你不怎么进入宝塔的后台你也可以吧宝塔的端口也关闭了。
完成以上步骤你就拥有了一个属于自己的博客网站了
- 感谢你赐予我前进的力量