2021年8月15日星期日

从 0 开始搭建 hexo 博客

之前有好几个人问我怎么搭建和我的一样的博客。这次年终总结给同事安利写博客的好处后，也有不少同事来咨询。搭建博客虽然不难，但需要很多琐碎的小知识。我就简单整理一下整个流程和需要的知识点。

方案选择

可选方案

一般个人博客搭建主要有这两种方案选择。

选择商业博客方案，如国内的简书和国外平台 Medium 都是很优秀的博客平台。很适合只想简简单单写博客，不愿意折腾的人。
搭建独立博客，需要购买域名、购买VPS、搭建VPS环境等。需要折腾的东西比较多，但同时也能学到很多。

我个人喜欢第二种，独立博客能完完全全自己控制。没有限制，随便折腾，同时也能学到很多。

框架选择

当然搭建博客并不是说自己从 0 开始写每一个页面，实际上有很多现成的优秀的博客程序。只需要安装，配置并挑选主题就能直接拿来用了。常见博客平台有以下几个：

其中 Hexo 和 Ghost 可以使用 Markdown 写文章，很适合程序员。Wordpress 非常强大，有丰富的插件和主题。但是对于一个简单的博客来说过重，个人觉得不适合轻量级博客。

Hexo 采用本地保存源文件并渲染成静态页面部署的方式，Ghost 则采用数据库服务端查询渲染的方式。我个人比较喜欢 Hexo 。

部署方案

Hexo 产生的静态文件只要放到任何支持 html 的空间或者服务器均可访问。主要的选择方案有以下两种

GitHub Pages
VPS

GitHub Pages 本用于介绍托管在GitHub的项目，不过，由于他的空间免费稳定，用来做搭建一个博客再好不过了。
每个帐号只能有一个仓库来存放个人主页，而且仓库的名字必须是username/username.github.io，这是特殊的命名约定。你可以通过http://username.github.io 来访问你的个人主页。

Github Pages 好处是完全免费，搭建并部署到教程可以参考手把手教你使用Hexo + Github Pages搭建个人独立博客。我个人的方案是第二种，部署到自己的服务器。

独立博客部署到自己服务器一年需要费用如下

VPS $5 / 月
域名￥50-200 / 年

本地安装 Hexo

以下有些步骤可能需要翻墙，如果下载失败请参考为Mac Terminal设置代理配置代理。

安装依赖

Hexo 依赖于 Node.js 和 Git，需要先安装。
下载 Node.js
下载 Git

安装 Hexo

1	npm install hexo-cli -g

在 blog 目录下初始化 hexo 博客，也可以是任意你想要的名字

1	hexo init blog

进入博客根目录，并且安装相关插件依赖等

1 2	cd blog npm install

安装完成后需要用一下命令

1 2	hexo g # 渲染 Source 目录下文件问静态页面 hexo s # 本地跑一个 server 来看博客效果。

然后可以在 http://localhost:4000/ 查看运行效果。

发表文章、替换主题等功能，请参考文章手把手教你使用Hexo + Github Pages搭建个人独立博客。

配置服务器环境

服务器环境我选择使用 CentOS + Nginx 环境。 VPS 可以选择以下俩服务商

选择一个注册帐号，填写付款信息然后创建一个实例。选择 $5 的最低配置就够用了。用我上面提供的链接注册还能拿到 $20 - $30 的优惠卷，相当于免费用半年。

安装 Nginx

Nginx 是一个高性能的 HTTP 和反向代理服务器，同时也是一个 IMAP/POP3/SMTP 代理服务器。

首选需要安装 CentOS 7 EPEL 源，然后安装 Nginx

1 2	sudo yum install epel-release sudo yum install nginx

启动 Nginx

Nginx 安装完成后需要手动启动

1	sudo systemctl start nginx

如果开启了防火墙，记得添加 HTTP 和 HTTPS 端口到防火墙允许列表。

sudo firewall-cmd --permanent --zone=public --add-service=http
sudo firewall-cmd --permanent --zone=public --add-service=https
sudo firewall-cmd --reload
sudo systemctl restart firewalld.service

配置完成后，访问使用浏览器服务器 ip ，如果能看到以下界面，表示运行成功。

配置虚拟主机

虚拟主机（Virtual Host）可以在一台服务器上绑定多个域名，架设多个不同的网站，一般在开发机或者要部署多个小网站的服务器上需要配置虚拟主机。

创建新的网站目录

Nginx 默认把网页文件存在 /var/www/html 目录。为了方便期间，我们在 /var/www/ 目录下为每个站点创建一个文件夹。

1
2
3

sudo mkdir -p /var/www/blog/html
sudo chown -R $USER:$USER /var/www/blog/html
sudo chmod -R 755 /var/www

在 /var/www/blog/html/ 目录下创建 index.html 文件。写上以下内容，用于测试虚拟主机运行情况。

<html>
    <head>
        <title>Welcome to Blog!</title>
    </head>
    <body>
        <h1>Success! The Blog server block is working!</h1>
    </body>
</html>

创建虚拟主机配置文件

在 /etc/nginx/conf.d/ 创建虚拟主机配置文件 blog.conf

server {
        listen 80;
        listen [::]:80;

        root /var/www/blog/html;
        index index.html index.htm index.nginx-debian.html;

        server_name eliyar.biz www.eliyar.biz;

        location / {
                try_files $uri $uri/ =404;
        }
}

重启 Nginx 服务器，使服务器设定生效

1	sudo systemctl restart nginx

修改本地host，验证结果

在绑定域名到服务器之前，需要修改本地 host 文件来测试。本地电脑上修改 /etc/hosts 文件。

1	45.32.227.150 eliyar.biz

能看到一下结果就表示虚拟主机配置成功。

部署 Hexo 到服务器

Hexo 可以使用 git 方式部署。

配置服务器环境

首先在 VPS 上安装 git

1	yum install git

创建空白 git 仓库，并且设置 git hook

1
2
3

cd ~
mkdir blog.git && cd blog.git
git init --bare

在 /root/blog.git/hooks/post-receive 以下脚本

#!/bin/bash
GIT_REPO=/root/blog.git  #git仓库
TMP_GIT_CLONE=/tmp/blog
PUBLIC_WWW=/var/www/blog/html #网站目录
rm -rf ${TMP_GIT_CLONE}
git clone $GIT_REPO $TMP_GIT_CLONE
rm -rf ${PUBLIC_WWW}/*
cp -rf ${TMP_GIT_CLONE}/* ${PUBLIC_WWW}

赋予脚本的执行权限

1 2	chmod +x post-receive

配置本机环境

在博客目录下运行下面命令，安装 git 部署工具。

1 2	npm install hexo-deployer-git --save

修改博客的配置文件 _config.yml，修改deploy选项：

deploy:
  type: git
  message: update
  repo:
    s1: root@45.32.227.150:/root/blog.git/,master

然后运行 hexo d 部署本地渲染网页到服务器上。

参考

手把手教你使用Hexo + Github Pages搭建个人独立博客
How To Install Nginx on CentOS 7
How To Set Up Nginx Server Blocks on CentOS 7
[从 0 开始搭建 hexo 博客](https://eliyar.biz/how_to_build_hexo_blog/)

2021年8月13日星期五

使用Certbot自动申请Let's Encrypt的SSL证书

Let’s Encrypt

一个公益性质的免费SSL证书签发的机构，目前由Linux Foundation托管。

Let’s Encrypt的证书可通过Certbot申请，有效期是90天，可以通过Certbot自动续期。

正文

环境：

OS: Debian 10 Buster i686
WebServer: Apache 2.4.38

安装Certbot

BASH

1 2	sudo apt update sudo apt install certbot

申请证书

此操作需要root权限

BASH

1	sudo certbot certonly

等待片刻……

CODE

Saving debug log to /var/log/letsencrypt/letsencrypt.log

How would you like to authenticate with the ACME CA?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: Spin up a temporary webserver (standalone)
2: Place files in webroot directory (webroot)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel):

这里进行网站的身份验证，简单来说就是检查你要开通SSL的网站是否归你。

启用一个临时的Web服务器；
将文件放在网站根目录中。

由于我的Web服务部署在本地，所以我选2。

CODE

1
2
3

Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2
Plugins selected: Authenticator webroot, Installer None
Please enter in your domain name(s) (comma and/or space separated)  (Enter 'c' to cancel):

在这里输入你的域名，这里以www.ussr.gov为例。

CODE

Please enter in your domain name(s) (comma and/or space separated)  (Enter 'c' to cancel): www.ussr.gov
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for www.ussr.gov
Input the webroot for www.ussr.gov: (Enter 'c' to cancel):

在这里输入网站的根目录。Apache2的默认网站根目录是/var/www/html。

CODE

1	Waiting for verification...

然后就会提示这样的信息，稍等片刻就能返回结果。

CODE

Waiting for verification...
Cleaning up challenges

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/www.ussr.gov/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/www.ussr.gov/privkey.pem
   Your cert will expire on 2018-01-26. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot
   again. To non-interactively renew *all* of your certificates, run
   "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

如果有这样的提示，那么就说明证书办成功了。

记住这两个路径：

chain: /etc/letsencrypt/live/www.ussr.gov/fullchain.pem
key: /etc/letsencrypt/live/www.ussr.gov/privkey.pem

配置服务

如果你使用的是nginx，可以参考nginx添加ssl证书升级为https（免费证书）

可以直接参考第二部分的内容，因为你已经拿到证书了。

以下的内容的环境是Debian特色apache2，其他OS下面的大同小异。

首先，我们要启用Apache2的SSL子站点配置文件。

BASH

1 2	cd /etc/apache2 ln -s sites-available/default-ssl.conf sites-enabled/000-default-ssl.conf

然后修改sites-enabled下面的000-default-ssl.conf

CODE

# 以下内容省略源配置文件中的注释
<IfModule mod_ssl.c>
        <VirtualHost _default_:443>
                ServerAdmin stalin@ussr.gov

                DocumentRoot /var/www/html

                ErrorLog ${APACHE_LOG_DIR}/error.log
                CustomLog ${APACHE_LOG_DIR}/access.log combined

				# SSLEngine必须启用
                SSLEngine on

				# 下面是需要修改的内容
				# 
				# SSLCertificateFile 证书文件（/etc/letsencrypt/live/www.ussr.gov/fullchain.pem）
				# SSLCertificateKeyFile 私钥文件 （/etc/letsencrypt/live/www.ussr.gov/privkey.pem）
                SSLCertificateFile    /etc/letsencrypt/live/www.ussr.gov/fullchain.pem
                SSLCertificateKeyFile    /etc/letsencrypt/live/www.ussr.gov/privkey.pem



                <FilesMatch "\.(cgi|shtml|phtml|php)$">
                                SSLOptions +StdEnvVars
                </FilesMatch>
                <Directory /usr/lib/cgi-bin>
                                #Header set Access-Control-Allow-Methods "www.wssr.gov"
                                SSLOptions +StdEnvVars
                </Directory>



        </VirtualHost>
</IfModule>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet

修改完，启用Apache2的SSL模块。

BASH

1 2	sudo a2enmode ssl sudo systemctl restart apache2

顺利的话，是可以通过https访问网站的。

（完）

参考

订阅：博文 (Atom)

Yang's Blog

2021年8月15日星期日

从 0 开始搭建 hexo 博客

方案选择

可选方案

框架选择

部署方案

本地安装 Hexo

安装依赖

安装 Hexo

配置服务器环境

安装 Nginx

启动 Nginx

配置虚拟主机

创建新的网站目录

创建虚拟主机配置文件

修改本地host，验证结果

部署 Hexo 到服务器

配置服务器环境

配置本机环境

参考

2021年8月13日星期五

使用Certbot自动申请Let's Encrypt的SSL证书

正文

环境：

安装Certbot

申请证书

配置服务

参考

博客归档

链接表

标签