从 0 到 1 搭建属于自己的博客

0. 前言

1.1 说在前面

之前一直有在各大平台发布博客内容，然后个人博客一直使用的是 Hexo + Github Pages 的方式，但随着内容增多，Github Pages 访问的也不稳定，所以想着自己搞个服务器和域名搭个博客，最终选定 Halo[1] 这个博客框架，搭建属于自己的博客。

此内容从零到一手把手记录如何搭建，记录自己的搭建过程，也给后面的朋友们提供一个指南，少走些冤枉路，尽快上手。

1.2 环境配置

自己花了 210 左右在 UCloud 买了三年的服务器，然后在腾讯花了将近 200 买了个域名，服务器版本是 Ubuntu 18.04 64 位，理论上讲下面的配置适合于 Ubuntu 系所有版本，个别有出入的地方还请谅解。所以在正式开始之前，你需要满足以下几个条件：

1. 一台 Ubuntu 系统的服务器（Centos 系统的参考 官网教程[2] 即可）；
2. 一个域名；

1. Java 环境配置

1.1 安装

1. 首先去 官网[3] 下载 JDK，选择自己想要的版本即可，一般推荐 JDK 1.8+ 的版本；

1. 解压下载后的文件；

tar -zxvf jdk-11.0.9_linux-x64_bin.tar.gz

1. 配置环境变量，切换到 root 用户，然后编辑 /etc/profile 文件，添加如下内容（注意路径切换为你自己放置解压缩包后的位置）；

export JAVA_HOME=/environment/jdk/jdk-11.0.9
export PATH=$JAVA_HOME/bin:$PATH

1.2 验证

安装好之后就是验证是否成功，一般我们用如下命令进行检测；

# 查看 jdk 版本
java -version

# 编译命令
javac

# 运行命令
java

2. 安装 Halo

2.1 下载 Halo 运行包

要下载 Halo 运行包，可以通过两种方式，更推荐第二种，下载起来更快：

1. Github releases：https://github.com/halo-dev/halo/releases
2. Nova 提供的下载站：https://dl.halo.run[4]

利用如下命令进行下载，以 1.4.2 版本为例，如果要下载其他版本，换版本号即可！

wget https://dl.halo.run/release/halo-1.4.2.jar

2.2 配置

1. 下载配置文件（下载后的文件存放在 ~/.halo/application.yaml）；

curl -o ~/.halo/application.yaml --create-dirs https://dl.halo.run/config/application-template.yaml

1. 修改配置，参考 官方文档[5] 修改即可；

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

2.3 运行 Halo

配置好 Java 环境，同时下载好 Halo 运行包之后，我们就可以使用如下命令运行了；

java -jar halo-latest.jar

然后在本地浏览器中访问如下地址即可；

“http://ip:8090 ”

3. 进阶配置

3.1 开机自启

1. 下载 Halo 官方 service 模板，然后对其进行修改（此时需要管理员权限）；

sudo curl -o /etc/systemd/system/halo.service --create-dirs https://dl.halo.run/config/halo.service

1. 修改配置文件

具体可以参考 官方文档[6]；

需要注意的几点：

• 填写你的 JDK 绝对路径；
• 填写你的 Halo 运行包所在绝对路径；
• 填写运行 Halo 服务的用户名；

1. 测试

# 修改 service 后需要 Systemd
sudo systemctl daemon-reload

# 使 Halo 开机自启
sudo systemctl enable halo

# 启动 Halo
sudo service halo start

# 重启 Halo
sudo service halo restart

# 停止 Halo
sudo service halo stop

# 查看 Halo 的运行状态
sudo service halo status

3.2 Halo 更新

Halo 是一个活跃的社区，目前一直在开发迭代中，后续如果发布了新的版本，而我们又想要升级，这时候就可以按照如下步骤来进行操作了；

1. 首先，我们需要对我们原有数据进行备份，防止丢失

cp -r ~/.halo ~/.halo.bak

1. 接着备份久的 Halo 安装包，防止新的安装包出现问题后无法回滚；

mv halo-latest.jar halo-latest.jar.bak

1. 做好备份工作之后，就是下载最新的 Halo 安装包了，其中 {{verison}} 对应最新版本号；

wget https://dl.halo.run/release/halo-{{version}}.jar -O halo-latest.jar

1. 测试一下最新版的 Halo 能否运行成功；

java -jar halo-latest.jar

1. 测试步骤如果成功了，那我们直接重启 Halo 服务就好了；

sudo service halo restart

4. 域名访问

通过上面的配置之后，我们只能通过 ip:port 的方式进行访问，如果我们想让别人来访问，那么有一个域名就十分有必要了。在正式进行配置域名之前，需要确保如下几件准备工作：

1. Halo 已经能够正确运行，且运行端口不是 80 端口；
2. 确保域名解析到服务器 IP，而且确保服务器已经备案（国内服务器都需要，国外无需）；
3. 打开服务器的 80 和 443 端口；

4.1 配置域名解析服务器 IP

因为我的域名是在腾讯买的，所以这里以腾讯为例；

1. 首先打开 域名解析列表[7]，并点击右侧解析进入解析界面；

1. 接着添加记录；

添加如下两条记录，其他字段保持默认即可；

4.2 打开服务器对应端口

1. 登录你的服务器，然后打开主机管理界面；
2. 接着编辑防火墙，将需要打开的端口打开即可，一般打开如下的协议端口就可以了；

• ICMP
• 3389
• 80
• 443
• 21
• 22
• 8090

4.4 利用 Nginx 进行反向代理

1. 安装 Nginx

sudo apt-get install nginx

1. 设置开机自启动 Nginx

systemctl enable nginx

1. 启动 Nginx

sudo service nginx start

1. 配置 Nginx

首先下载 Halo 官方的 Nginx 配置模板；

curl -o /etc/nginx/conf.d/halo.conf --create-dirs https://dl.halo.run/config/nginx.conf

然后对其进行修改；

sudo vim /etc/nginx/conf.d/halo.conf

只需要将其中的 example.com 修改成自己的域名即可，比如我的域名是 cunyu1943.site；

server {
    listen 80;

    server_name 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/;
    }
}

1. 自动配置 SSL 证书

首先安装 certbot nginx 插件；

sudo apt-get install python-certbot-nginx

接着执行配置，过程中会询问为哪个域名添加证书，以及是否重定向，如实选择即可；

sudo certbot --nginx

最后，设置自动续约即可；

sudo certbot renew --dry-run

1. 完成上述步骤之后，大功告成了，我们就可以通过自己的域名来访问自己的博客了，比如我的博客就是：

“https://cunyu1943.site ”

5. 总结

好了，经过上面的一系列设置，我们的博客就搭建完成了，是不是好简单的说，那就别犹豫，赶紧动手搞起来吧！

最后再贴以下自己的博客地址，欢迎大家来留言，交换友链呀！

“https://cunyu1943.site ”

参考资料

[1]

Halo: https://halo.run/

[2]

官网教程: https://halo.run/archives/install-with-linux.html

[3]

官网: https://www.oracle.com/java/technologies/javase-downloads.html

[4]

https://dl.halo.run: https://dl.halo.run/

[5]

官方文档: https://halo.run/archives/install-with-linux.html

[6]

官方文档: https://halo.run/archives/install-with-linux.html

[7]

域名解析列表: https://console.cloud.tencent.com/cns