欢迎访问我的博客：飞鱼舍

前言：

Halo是一款现代化的个人独立博客系统。Halo [ˈheɪloʊ]，意为光环。当然，你也可以当成拼音读(哈喽)。轻快，简洁，功能强大，使用 Java 开发的博客系统。

具有以下几个特点：

1. 快速部署

   一条命令即可启动，完全没有上手难度。

2. 多主题

   完备的主题系统，支持在线下载和在线更新，并提供 9 款主题可供选择（主题开发文档正在开发中）。

3. 拓展性

   提供 Content Api 和 Admin Api。你可以用于开发单页面应用，微信小程序，桌面端管理软件，管理 APP（已有）等。

4. 附件管理

   支持本地上传，又拍云/七牛云/阿里云/SM.MS 等存储服务。

5. 评论管理

   拥有独立的评论插件，使用 Vue 开发，只需在页面引入构建好的 JS 文件即可，完美地和主题相结合。

6. 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

1. 如果需要自定义端口，修改 server 节点下的 port 即可。
2. 默认使用的是 H2 Database 数据库，这是一种嵌入式的数据库，使用起来非常方便。需要注意的是，默认的用户名和密码为 admin 和 123456，这个是自定义的，最好将其修改，并妥善保存。
3. 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

1. –rm：停止之后自动删除容器。
2. –name：容器名。
3. -p：占用端口，前者为宿主机端口，后者为 Halo 的运行端口，可在 application.yaml 配置。
4. -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
 }
}

1. 请把 https://www.simple.com 改为自己的域名。
2. tls 后面的 xxxx@xxx.xx 改为自己的邮箱地址，这是用于自动申请 SSL 证书用的。需要注意的是，不需要你自己配置 SSL 证书，而且会自动帮你续签。
3. 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博客用户文档，更多使用详情，请点击链接了解。