阿里云服务器搭建Halo博客系统
欢迎访问我的博客:飞鱼舍
前言:
Halo是一款现代化的个人独立博客系统。Halo [ˈheɪloʊ],意为光环。当然,你也可以当成拼音读(哈喽)。轻快,简洁,功能强大,使用 Java 开发的博客系统。
具有以下几个特点:
-
快速部署
一条命令即可启动,完全没有上手难度。
-
多主题
完备的主题系统,支持在线下载和在线更新,并提供 9 款主题可供选择(主题开发文档正在开发中)。
-
拓展性
提供 Content Api 和 Admin Api。你可以用于开发单页面应用,微信小程序,桌面端管理软件,管理 APP(已有)等。
-
附件管理
支持本地上传,又拍云/七牛云/阿里云/SM.MS 等存储服务。
-
评论管理
拥有独立的评论插件,使用 Vue 开发,只需在页面引入构建好的 JS 文件即可,完美地和主题相结合。
-
APP
拥有使用 Flutter 开发的管理端 APP,支持 Android 和 iOS,随时随地发表你的想法。
之前我使用的是Typecho博客系统,现在来尝试一下Halo博客系统。
使用Docker部署Halo
环境要求
- CentOS 7.x
- 1G 以上内存
服务器配置
更新软件包
请确保服务器的软件包已经是最新的。
sudo yum update -y
配置 Docker 运行环境
安装必要依赖
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
添加软件源信息
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
更新 yum 缓存
sudo yum makecache fast
安装Docker
sudo yum install docker-ce docker-ce-cli containerd.io
启动Docker后台服务
sudo systemctl start docker
允许当前用户直接运行 docker
命令
sudo usermod -aG docker your_name#修改your_name
镜像加速
# 新建 daemon.json 文件
sudo vim /etc/docker/daemon.json
将下面的配置复制进去即可:
{
"registry-mirrors": ["http://hub-mirror.c.163.com"]
}
安装 Halo
自定义配置文件
考虑到部分用户的需要,可能需要自定义比如端口等设置项,我们提供了公共的配置文件,并且该配置文件是完全独立于安装包的。当然,你也可以使用安装包内的默认配置文件,但是安装包内的配置文件是不可修改的。请注意:配置文件的路径为 ~/.halo/application.yaml
。
# 下载配置文件到 ~/.halo 目录
curl -o ~/.halo/application.yaml --create-dirs http://halo.ryanc.cc/config/application-template.yaml
修改配置文件
完成上一步操作,我们就可以自己配置 Halo 的运行端口,以及数据库相关的配置了。
# 使用 Vim 工具修改配置文件
vim ~/.halo/application.yaml
打开之后我们可以看到:
H2 配置如下:
server:
port: 8090
spring:
datasource:
type: com.zaxxer.hikari.HikariDataSource
# H2 Database 配置
driver-class-name: org.h2.Driver
url: jdbc:h2:file:~/.halo/db/halo
username: admin
password: openadmin
h2:
console:
settings:
web-allow-others: false
path: /h2-console
enabled: false
- 如果需要自定义端口,修改
server
节点下的port
即可。 - 默认使用的是
H2 Database
数据库,这是一种嵌入式的数据库,使用起来非常方便。需要注意的是,默认的用户名和密码为admin
和123456
,这个是自定义的,最好将其修改,并妥善保存。 h2
节点为H2 Database
的控制台配置,默认是关闭的,如需使用请将h2.console.settings.web-allow-others
和h2.console.enabled
设置为true
。控制台地址即为域名/h2-console
。注意:非紧急情况,不建议开启该配置。
拉取最新 Halo 镜像
sudo docker pull ruibaby/halo
创建容器并运行
docker run --rm -it -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo ruibaby/halo
- --rm:停止之后自动删除容器。
- --name:容器名。
- -p:占用端口,前者为宿主机端口,后者为 Halo 的运行端口,可在
application.yaml
配置。 - -v:目录映射,一般不要修改。
更新 Halo 版本
# 停止容器
sudo docker stop halo
# 拉取最新的 Halo 镜像
sudo docker pull ruibaby/halo
# 创建容器
docker run --rm -it -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo ruibaby/halo
完成以上操作即可通过 ip:端口
访问了。不过在此之前,最好先完成后续操作,我们还需要让域名也可以访问到 Halo,请继续看配置域名访问。
使用 Caddy 进行反向代理
Caddy
是一款使用 Go
语言开发的 Web
服务器。其配置更为简洁,并可以自动申请及配置 SSL 证书(推荐)。
安装 Caddy
# 安装 Caddy 软件包
yum install caddy -y
配置 Caddy
# 下载 Halo 官方的 Caddy 配置模板
curl -o /etc/caddy/conf.d/Caddyfile.conf --create-dirs http://halo.ryanc.cc/config/Caddyfile
下载完成之后,我们还需要对其进行修改。
# 使用 vim 编辑 Caddyfile
vim /etc/caddy/conf.d/Caddyfile.conf
打开之后我们可以看到
https://www.simple.com {
gzip
tls xxxx@xxx.xx
proxy / localhost:port {
transparent
}
}
- 请把
https://www.simple.com
改为自己的域名。 tls
后面的xxxx@xxx.xx
改为自己的邮箱地址,这是用于自动申请 SSL 证书用的。需要注意的是,不需要你自己配置 SSL 证书,而且会自动帮你续签。localhost:port
请将port
修改为 Halo 的运行端口,默认为 8090。
修改完成之后启动 Caddy
服务即可。
# 开启自启 Caddy 服务
systemctl enable caddy
# 启动 Caddy
service caddy start
# 停止运行 Caddy
service caddy stop
# 重启 Caddy
service caddy restart
# 查看 Caddy 运行状态
service caddy status
注意
如果 Caddy 启动出现诸如 [/usr/lib/systemd/system/caddy.service:23] Unknown lvalue 'AmbientCapabilities' in section 'Service'
这样的问题,请使用 yum update -y
更新系统。然后再使用 service caddy restart
重启,已知 CentOS 7.3
会出现该问题。
进阶设置
多网址重定向到主网址,比如访问 simple.com
跳转到 www.simple.com
应该怎么做呢?
# 使用 vim 编辑 Caddyfile
vim /etc/caddy/conf.d/Caddyfile.conf
打开之后我们在原有的基础上添加以下配置
https://simple.com {
redir https://www.simple.com{url}
}
将 https://simple.com
和 https://www.simple.com{url}
修改为自己需要的网址就行了,比如我要求访问 ryanc.cc
跳转到 www.ryanc.cc
,完整的配置如下:
https://ryanc.cc {
redir https://www.ryanc.cc{url}
}
https://www.ryanc.cc {
gzip
tls i@ryanc.cc
proxy / localhost:8090 {
transparent
}
}
最后我们重启 Caddy
即可。
到这里,关于 Caddy
反向代理的配置也就完成了,现在你可以访问一下自己的域名,并进行 Halo
的初始化了。
注意
在设置了反向代理之后,请一定记得去 halo 的管理端设置一下正确的博客地址,否则会造成资源获取不成功。
以上内容来自于Halo博客用户文档,更多使用详情,请点击链接了解。