Halo博客安装

1. 安装Docker

   本文使用全新安装的系统，因此并没有安装Docker，已安装Docker则可跳过这一步。登录终端输入以下内容并按回车等待即可完成Docker安装，该命令同样适用于Ubuntu。

   curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

2. 创建Halo博客的工作目录

   本文将Halo博客工作目录置于home目录下，并命名为.halo。该目录将用来存放博客所有配置、文章、主题等数据，若有备份或迁移需要则可以直接复制该目录。

   创建目录并前往该目录mkdir ~/.halo && cd ~/.halo

3. 下载默认配置文件到工作目录

   wget https://dl.halo.run/config/application-template.yaml -O ./application.yaml

   该配置文件包含了端口，数据库，缓存，后台根路径等配置，一般下载后不用更改，若需要更改使用的数据库等需求可参考官方文档。

4. 拉取Halo镜像

   docker pull halohub/halo:latest

5. 创建容器

   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目录，注意后者不可更改。

   其他参数具体含义请参考官方文档。

6. 此时即可使用http://ip:端口号访问安装引导界面。但比较推荐完成下列反向代理以及SSL证书配置后再进行博客的初始化。

使用Nginx进行反向代理

注意下文内容基于使用8090宿主机端口，如有更改请注意在配置文件中将8090改为自行修改的端口

1. 安装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

2. 配置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申请证书并自动安装。

   1. 安装 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

   2. 申请并自动配置证书：

      sudo certbot --nginx

   需要输入邮箱并按y或a同意相关协议，具体请参考输入命令后的输出

   1. 自动续约

      这里申请的免费证书可以免费续期，理论上可以一直免费使用，这里提供了自动执行续期的命令

      sudo certbot renew --dry-run

结束语

到这里，即完成了所有的步骤，可以直接通过域名进行Halo博客的访问。注意，国内服务商注册的域名大多需要备案，否则无法使用，具体请参考云服务商的文档。

在设置完反向代理后，必须在博客的后台管理界面设置正确的博客地址，否则可能导致CSS加载不成功、样式混乱等错误。