Halo博客安装
- 安装Docker
本文使用全新安装的系统,因此并没有安装Docker,已安装Docker则可跳过这一步。登录终端输入以下内容并按回车等待即可完成Docker安装,该命令同样适用于Ubuntu。
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
- 创建Halo博客的工作目录
本文将Halo博客工作目录置于home目录下,并命名为
.halo
。该目录将用来存放博客所有配置、文章、主题等数据,若有备份或迁移需要则可以直接复制该目录。创建目录并前往该目录
mkdir ~/.halo && cd ~/.halo
- 下载默认配置文件到工作目录
wget https://dl.halo.run/config/application-template.yaml -O ./application.yaml
该配置文件包含了端口,数据库,缓存,后台根路径等配置,一般下载后不用更改
- 拉取Halo镜像
docker pull halohub/halo:latest
- 创建容器
docker run -it -d --name halo -p 8090:8090 -v ~/.halo:/root/.halo --restart=unless-stopped halohub/halo:1.4.11
8090:8090
第一个8090为宿主机端口,第二个8090为容器端口,含义为将宿主机的8090端口映射到容器的8090端口。~/.halo:/root/.halo
含义为将宿主机的~/.halo
目录映射到容器的/root/.halo
目录,注意后者不可更改。其他参数具体含义请参考官方文档。
- 此时即可使用
http://ip:端口号
访问安装引导界面。但比较推荐完成下列反向代理以及SSL证书配置后再进行博客的初始化。
使用Nginx进行反向代理
注意下文内容基于使用8090宿主机端口,如有更改请注意在配置文件中将8090改为自行修改的端口
安装Nginx
# 下列代码适用于CentOS # 添加 Nginx 源 sudo rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm # 安装 Nginx sudo yum install -y nginx # 启动 Nginx sudo systemctl start nginx.service # 设置开机自启 Nginx sudo systemctl enable nginx.service
# 下列代码适用于Ubuntu sudo update sudo apt install nginx
配置Nginx
# 下载 Halo 官方的 Nginx 配置模板 curl -o /etc/nginx/conf.d/halo.conf --create-dirs https://dl.halo.run/config/nginx.conf
下载之后需要对其进行修改。以上方法安装的Nginx默认路径为
/etc/nginx
# 适用 vim 编辑 halo.conf vim /etc/nginx/conf.d/halo.conf
打开之后的内容应该类似
server { listen 80; server_name example.com www.example.com; # 将 example.com www.example.com 修改为自己的域名 location / { proxy_set_header HOST $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://127.0.0.1:8090/; # 如有更改默认的宿主机8090端口,请修改此处为执行选择的端口 } }
修改完成之后
# 检查配置是否有误 sudo nginx -t # 重载 Nginx 配置 sudo nginx -s reload
使用 certbot 申请并自动安装SSL证书
阿里云/腾讯云等云服务商也可以申请免费的SSL证书并下载,这类证书请查阅相关教程,本文仅介绍通过certbot申请证书并自动安装。
安装 certbot 和 certbot nginx 插件:
# 根据自己的系统选择相应命令 # CentOS 安装 certbot 以及 certbot nginx 插件 sudo yum install certbot -y sudo yum install python3-certbot-nginx -y # Ubuntu 安装 certbot 以及 certbot nginx 插件 sudo apt install certbot sudo apt install python3-certbot-nginx
申请并自动配置证书:
sudo certbot --nginx
需要输入邮箱并按
y
或a
同意相关协议,具体请参考输入命令后的输出自动续约
这里申请的免费证书可以免费续期,理论上可以一直免费使用,这里提供了自动执行续期的命令
sudo certbot renew --dry-run
结束语
到这里,即完成了所有的步骤,可以直接通过域名进行Halo博客的访问。注意,国内服务商注册的域名大多需要备案,否则无法使用,具体请参考云服务商的文档。
在设置完反向代理后,必须在博客的后台管理界面设置正确的博客地址,否则可能导致CSS加载不成功、样式混乱等错误。