服务器上搭建hexo博客

最近在服务器上搭建了一个博客,用于存放主题资料。博客框架使用了Hexo,Web服务器使用了Nginx。
以前把Hexo搭建到Github上,这次本来想直接搭建到公司的Gitlab上,但是发现公司的Gitlab把Page功能禁用了,只能搭建到我们小组的服务器上。整体框架如下:

服务器上搭建hexo博客
文章图片
Architecture.png 注:图片来自《如何在服务器上搭建hexo博客》
简单来说,就是首先服务器部署Nginx,本地使用Hexo生成博客,然后推送到服务器的Git仓库,再使用git hook功能,当博客被推送到Git仓库后自动部署到Nginx的指定目录里,完成文章发布。
相关技术点

  • Git, SSH
  • Hexo
  • Nginx
环境介绍 本地与服务器都为Mac OS 系统
搭建流程
  1. 本地安装 Hexo
  2. 本地生成ssh公钥私钥,并把公钥复制到服务器
  3. 服务器安装Nginx,初始化Git仓库
  4. 本地使用Hexo生成博客,然后部署到服务器
本地环境搭建
  • 本地安装 Hexo ,具体流程参见官方文档 Hexo,安装成功后,再安装两个插件 hexo-deployer-git 和 hexo-server
    npm install hexo-deployer-git --save npm install hero-server --save

  • 生成ssh,具体参见 Github SSH ,这里有一点要注意,基本上本地都已经有ssh文件了,在生成的过程中,注意给本次生成的ssh改个名字,然后打开 ~/.ssh/config文件(如果没有就新增一个),在config新增一个 Host ,具体参见 Adding your SSH key to the ssh-agent 。
  • 将生成的.pub公钥文件拷贝到~/.ssh/目录下,并重命名为authorized_keys,如果已经存在authorized_keys,那么就新建一行将公钥文件的内容拷贝进去。修改authorized_keys权限为600(很重要,如果权限不安全,则无法使用该功能)
服务器环境搭建
  • 在服务器上使用Homebrew安装Nginx (如果没有Homebrew,请先安装),安装后,注意修改 nginx.conf文件,打开一个server 修改为:
    server { listen80; server_name10.100.10.10; //修改为你的服务器ip,后续就能直接浏览器输入ip打开网页location / { roothtml; indexindex.html index.htm; } }

    然后启动 Nginx服务
    sudo nginx

    ?
  • 新建git仓库,用以下命令初始化Git仓库
    sudo git init --bare blog.git

    配置 git hook,在 blog.git/hooks 目录下新建一个 post-receive 文件,然后输入以下内容
    git --work-tree=/home/www/hexo --git-dir=/var/repo/blog.git checkout -f

    注意,/home/www/hexo 要换成你自己Nginx 部署目录,/var/repo/blog.git 要替换成你自己的Git
    修改文件的可执行权限
    chmod +x post-receive

回到本地环境 修改hexo目录下的 _config.yml 文件
deploy: type: git repo: 服务器登录的用户名@服务器git仓库地址 branch: master

【服务器上搭建hexo博客】其中 repo 地址比如为 admin@10.10.10.10::/var/repo/blog.git
开始写博客发布
$ hexo new "Hello world"//新建文件 $ hexo g//生成博客 $ hexo d//部署

其中我遇到的一些坑,主要是权限问题,如果遇到部署不成功,注意排查是否是权限问题导致的。
附录:参考文章
如何在服务器上搭建hexo博客
Github SSH
Hexo
Nginx
极客学院 Nginx入门指南
Nginx配置文件nginx.conf中文详解

    推荐阅读