使用 Docker
部署 Halo
的指南,假设你已经安装好了 Docker
并了解它的基本使用。本篇教程以 CentOS 7.x
为例,其他系统大同小异。
如果您还没有购买服务器,推荐通过以下链接购买。如果您使用了以下链接购买了服务器,联系我们可免费提供部署服务。如不需要请直接往下看。
宝塔面板
之类的 Linux 管理面板,可能还需要在面板里设置端口。为了在使用过程中不出现意外的事故,给出下列推荐的配置
请确保服务器的软件包已经是最新的。
sudo yum update -y
如果你已经安装过
Docker
,请略过此步骤。
这里推荐使用官方文档进行安装 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
sudo yum makecache fast
sudo yum install docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
docker
命令需要将当前用户加入 docker
用户组。这样每次运行 docker
命令的时候,就不需要加 sudo
。
sudo usermod -aG docker your_name
注意:设置成功之后需要重新登录才会生效。
# 新建 daemon.json 文件
sudo vim /etc/docker/daemon.json
将下面的配置复制进去即可:
{
"registry-mirrors": ["http://hub-mirror.c.163.com"]
}
注意:修改完配置文件之后需要执行
service docker restart
才可生效。
考虑到部分用户的需要,可能需要自定义比如端口等设置项,我们提供了公共的配置文件,并且该配置文件是完全独立于安装包的。当然,你也可以使用安装包内的默认配置文件,但是安装包内的配置文件是不可修改的。请注意:配置文件的路径为 ~/.halo/application.yaml
。
# 下载配置文件到 ~/.halo 目录
curl -o ~/.halo/application.yaml --create-dirs https://dl.halo.run/config/application-template.yaml
完成上一步操作,我们就可以自己配置 Halo 的运行端口,以及数据库相关的配置了。
# 使用 Vim 工具修改配置文件
vim ~/.halo/application.yaml
打开之后我们可以看到:
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
,则会将数据缓存到磁盘,重启不会清空缓存。如不知道如何选择,建议默认。sudo docker pull ruibaby/halo
docker run --rm -it -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo ruibaby/halo
application.yaml
配置。完成以上操作即可通过 ip:端口
访问了。不过在此之前,最好先完成后续操作,我们还需要让域名也可以访问到 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