794 字
4 分钟
Hexo 1 安装指南
2021-12-11

前言#

采用的配置如下:

  • 系统:Ubuntu
  • 服务器:Nginx
  • 博客框架:Hexo

2021/12/12 我并没有将博客部署到 Github 上,主要是因为 Github 在国内的访问不太可靠,且之前我有租华为的云服务器。

2022/08/13 - 我使用以上配置一年多了,还是推荐本地编写博客,然后远端发布,远程更新文章还是太麻烦了。

2022/08/15 - 思考了两天,尝试了一下把博客部署到 github 上,没啥问题,就是有点慢,还是等原来服务器过期吧…


安装 Nginx#

安装 Nginx:

Terminal window
sudo apt install nginx

Nginx 配置的参考:

# Default server configuration
server {
listen 80 default_server;
listen [::]:80 default_server;
# Hexo
root /var/www/hexo/public; #hexo下的public文件夹
server_name _;
index index.html index.htm index.nginx-debian.html;
}

安装 Git#

Linux (Ubuntu, Debian): sudo apt-get install git-core

Windows:git 官网

安装 Node.js 与 npm1#

Ubuntu#

apt 包管理工具

Terminal window
apt install nodejs npm

NodeSource 脚本

注意安装版本,如果使用 Hexo 发现如下问题可以用更低的版本:

nodejs 版本过高

写文章的时候,Node.js 的稳定版本为 16.13.1 LTS。

nodejs 版本

获取并执行 NodeSource 安装脚本(setup_ 后接需要的 Node.js 版本,例如 setup_14.x。):

Terminal window
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -

安装 Node.js 和 npm :

Terminal window
apt install nodejs

Windows#

Windows 安装 nodejs

前往 nodejs 官网 获取对应的 .msi 安装包,如果官网无法打开,可以尝试从 镜像网站 获取。


安装 Hexo#

参考了 Hexo 的官方文档2,完成上面步骤后,用 npm 安装 Hexo:

Terminal window
npm install -g hexo-cli

创建并进入指定目录:

Terminal window
mkdir /var/www/hexo
cd /var/www/hexo

由于需要使用 Nginx 进行代理,所以放在 /var/www 中,如果放在其他文件夹内,需要重新配置权限。

Hexo 初始化指定文件夹:

Terminal window
hexo init
npm install

通过 Hexo 生成一次静态文件:

Terminal window
hexo g

在当前目录下的 public 文件夹内看到生成的文件。

到这里,安装就基本结束了,如果修改过 Nginx 的配置文件,尤其是 root /var/www/hexo/public 根目录的设置,就可以直接通过域名或IP地址访问博客了。

Hexo - Hello World!

2023.07.11 Windows 环境下使用 hexo g 指令,出现报错 统上禁止运行脚本。有关详细信息,请参阅 https:/go.microso

  1. 打开 win11 开始界面(Win键)

  2. 搜索 powershell

  3. 设置 允许本地 PowerShell 脚本在不签名的情况下运行

  4. 打开 更改执行策略,以允许本地 PowerShell 脚本在未签名的情况下运行。远程脚本需要签名。


部署到 Github 仓库#

Step1. 创建 username.github.io 仓库

使用对应 github 账户,在该账户下创建一个同名的 repository,名称为 username.github.io

最终 repository 的访问链接为 https://github.com/username/username.github.io.git

Step2. 安装 hexo-deployer-git

进入 Hexo 项目所在文件夹,安装用于远程部署的插件:

Terminal window
npm install hexo-deployer-git

安装完成后,进入 Hexo 的 _config.yml 文件进行配置:

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repo: https://github.com/username/username.github.io.git
branch: master

保存并退出。

Step3. 远程部署到 Github

进入 Hexo 项目所在文件夹,输入如下指令:

Terminal window
hexo d

之后,项目就会部署到对应的 Github 仓库中,中间会有 Github 确认部署用的密钥,同意即可。

Step4. 访问

输入网址 https://username.github.io/ 即可访问。

Footnotes#

  1. 如何在Ubuntu 20.04上安装Node.js和npm

  2. Hexo 文档

Hexo 1 安装指南
https://fuwari.vercel.app/posts/建站/hexo/hexo-1-安装指南/
作者
Asuwee
发布于
2021-12-11
许可协议
CC BY-NC-SA 4.0