序篇

笔者对于「想要拥有个人网站」这事儿，在过去几年总会偶尔灵光一现，心血来潮地买下几个月的轻应用服务器以及域名，然后兴高采烈地架设起来，更换各种博客主题，记录一些学习心得；然而，潮起之后马上潮落，有时课程或实习太充实，无暇更新。再者，每到续费的时候，掂量掂量口袋里的钞票，穷大学生最终还是选择了多吃几餐饕餮盛宴。

在这若干次的尝试中，用过阿里云、腾讯云的服务器，国内访问很快，但备案起来很麻烦；买过Amazon，Wix，GoDaddy 以及 Ghost.org 的服务，但是限制较多，需要信用卡，而且墙内速度令人抓狂。而在软件选择上，基本上都是在 WordPress 以及 Ghost Blog 中周旋。其实这两者对我来说，就像是 facebook 与 ins 对比的感觉。从官方提供的主题来看，后者真的优美许多。WordPress 插件多，但对我个人来说，喜欢且免费的主题太少。因为很少有开发者有那个佛心，无回报的去针对每一个 WordPress widget（小工具）进行兼容，对接和美化。再来，WordPress 着墨了很多在留言、Email、监控，这些都是小型网店才需要的配置，对于一个个人博客来说太重了；所以我更喜欢 Ghost Blog，轻便又优美，改样式也很方便，对于一个轻博客来说，功能足已。

过去想要架设一个 Ghost Blog，最简单的方法就是搞一个 linux 系统的服务器，然后跟着官网的步骤，很快就能上线了。再后来，Ghost.org 官方提供了托管服务，免去了一系列繁琐的架设流程，也省去了域名的配置，但转而换来的是一个每个月至少需要 $29 刀的价格。而就在这两年，Github Pages 的问世，让免费托管成了可能。

Github Pages 是 Github 提供的静态页面服务，可以通过 Jekyll 来进行博客管理。很多 Ghost Blog 的爱好者也关注到了这个平台，有大神在 Github 上提供了一键部署的功能。于是就有了我们今天要介绍的架设实录：如何在 Github Pages 上优雅地架设 Ghost 博客系统。

架设篇

【写在前面】本文适用于 Linux 或 macOS 系统，Windows 系统的小伙伴需自行参考各类软件的安装方式。需要用到的自动安装的 Github 项目在：paladini/ghost-on-github-pages，以下步骤大部分也翻译于此。

项目思路

这个项目首先会自动安装 Ghost 博客系统，之后会将动态系统转化为静态页面，并自动部署到 Github Pages 中。值得注意的是，静态页面转化的功能其实用的是早在 2014 就不再更新的 Buster.py。这两个项目都多多少少存在一些 bug，所以如果你成功走完「架设篇」，请一定要看完「修正篇」。

步骤

环境配置
软件安装
更新博客

环境配置

安装 Python 2

该软件采用的是 Python 2.x 的环境，因为之后会自动调用的 buster 不支持 3.0+。

# Debian-based systems
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python2.7

安装 NodeJS

安装可被 Ghost Blog 支持的 NodeJS 版本，目前官方支持的版本分别为 8.x、10.x（官方推荐） 与 12.x。

# Debian-based systems
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 npm

# Debian-based systems
sudo apt install npm

安装 wget (MacOS)

由于之后自动生成静态文件的过程需要使用 wget 命令，但 MacOS 并没有自带这个功能，需要通过 homebrew 进行安装。

# 安装 homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"# 安装 wget
brew install wget

开启「隐藏文件可见」(MacOS)

该软件会将 Ghost 博客的文件安装到 MacOS 的 ～ 目录中，即 /Users/用户名中的一个.ghost的隐藏目录。若不开启「隐藏文件可见」，将无法修改这个目录的读写权限。

defaults write com.apple.Finder AppleShowAllFiles YES

软件安装

下载 ghost-on-github-pages

可以从项目地址 paladini/ghost-on-github-pages 中寻找，或从这里下载最新版本的软件，然后解压到任意位置。打开文件后，需要关注的只有一个 install.sh 文件。

创建一个新的 Github repository

首先，你需要开启 Github pages 的使用，方法可以参考Github pages官方网站。如果你要直接使用 https://用户名.github.io 作为这个博客的地址的话，则无需在 用户名.github.io 的基础上额外创建仓库。不过，我个人推荐还是在「pages项目」的基础上，额外创建一个新的项目管理博客系统，这样更方便管理，原本的页面也不会被吞掉。

在创建好 repository 之后，你需要记下来该项目 git 的 HTTPS 或 SSH 地址。这里推荐使用 HTTPS，因为这免去了系统一些密钥的配置。大致来说，新项目的 HTTPS 地址格式如下：https://github.com/用户名/新项目名称.git。这个地址很重要，因为运行安装之后，需要填写。

运行 install.sh 进行安装

在刚刚解压的文件夹打开 terminal，首先需要给予这个文件读写的权限（当然，也可以在 Folder 中右键修改）：

chmod +x install.sh
sudo sh ./install.sh

而后，软件就会自动开始安装 Ghost 博客到 mac 的 ～ 目录（ /Users/用户名）中的一个.ghost隐藏文件夹中。或者 Linux 系统下的 /home/用户名/.ghost文件中。

在安装的过程中，如果因为系统或网络问题失败或卡住过久。则耐心查看错误原因，并删除.ghost文件夹，重新进行权限给予以及安装的过程。若成功安装 Ghost 博客之后，系统会让你回答三个问题：

1. 你的github用户名：
2. 你要安装到的repository的git所需的HTTPS或SSH地址(即上文中记录的内容)
3. 你要安装到的repository的名称

填写并安装成功后，你的github项目就会自动提交上传，直接访问https://用户名.github.io/项目名 就可以看见成品了。（Github Pages 在上传后不会立即更新，一般需要 2～5 分钟不等，若过长时间没有更新，请检查浏览器缓存是否需要清除或检查Github绑定邮件，失败的话将会发送邮件告知原因。｜另外，这个项目太久没有维护，Github 将会提醒 6 个 warnings，选择“无视”按钮，这些警报就不会再提醒了。）

更新博客

Ghost 的简单操作

在项目安装完成之后，Ghost Blog 会自动在系统中运行，并且开启了端口 localhost:2368。但实际上，该项目的配置文件使得它实际运行于 localhost:2373。可以在.ghost文件夹中，通过 ghost ls 命令就可以查看实际运行的端口了。在关闭电脑之后，ghost系统也会随之关闭，需要重新打开，以下是一些 ghost 的常用命令：

// 如果因为权限问题，被deny：一可更改文件读写权限，二可在所有命令前加 sudo
// 开启
ghost start
// 重启
ghost restart
// 关闭
ghost stop
// 查看端口情况
ghost ls

在 ghost 服务开启之后，进入localhost:2373就可以查看当前的动态页面，而localhost:2373/ghost就可以进入服务器，进行文章等博客内容的管理了，首次登录时需要配置一些账号等基本信息，之后就可以直接使用了。

deploy.sh

在更新之后，只需要在 .ghost 文件夹中运行 deploy.sh 就可以直接部署，十分方便：

cd ~/.ghost
./deploy.sh

这个脚本首先会将所有动态内容通过Buster转化成为静态文件，然后通过git，自动部署到Github Pages。同样，这需要数分钟，在 Github Pages 上才看得到最新的内容。

修正篇

该项目的持有者以及Buster都很久没有更新这两个项目了，项目多多少少存在一些问题。所以我反复检查了源码以及网上的资料，针对两个重要 bug 进行了一下的改进：

修改默认端口号，否则链接与头像图片会出错
- 打开 .ghost 文件夹下的 config.development.json文件，将第一行端口改为："http://localhost:2373"，只要与 port 相同即可。

修改deploy.sh文件，增加一段脚本，不然博文图片将无法显示

修改deploy.sh，添加以下8行代码（注意从 CORRECTING BUSTER ERRORS 那行开始）到指定位置：

...update() {if [ -d "$GHOST_PATH" ]; thencd "$GHOST_PATH"# Generating static filesbuster generate --domain="$GHOST_SERVER_URL"echo ' -------------- CORRECTING BUSTER ERRORS  -------------- 'sudo chmod -R 777 *find . -type f -name '*.html' | xargs sed -i -e 's#.jpg#.jpg#g'find . -type f -name '*.html' | xargs sed -i -e 's#.jpg#.jpg#g'find . -type f -name '*.html' | xargs sed -i -e 's#.jpg#.jpg#g'find . -type f -name '*.html' | xargs sed -i -e 's#.png#.png#g'find . -type f -name '*.html' | xargs sed -i -e 's#. png#. png#g'find . -type f -name '*.html' | xargs sed -i -e 's#. png#. png#g'echo ' -------------------- FIXING LINKS  -------------------- 'echo ''read -p "Github username: "  gh_usernameecho "Leave blank if repo name is username.github.io"read -p "Repo name: " gh_repo...

他这出现一个致命的bug，图片的后缀莫名地变成.png. png. png。这里遍历了所有代码，找到出错的地方，进行了修改。

结语：本文主要介绍了一个自动部署 Ghost 到 Github Pages 的方法。之后还会另起篇幅，探讨如何用一个最便宜的阿里云服务器，充当该网页的图片服务器。（因为国内访问 github 的速度有时还是很慢。）

参考：

https://github.com/paladini/ghost-on-github-pages

https://github.com/axitkhurana/buster

https://github.com/axitkhurana/buster/issues/94

如何优雅又庶民地在Github Pages中上线Ghost博客系统相关推荐

Github Pages + Hugo 搭建个人博客
文章目录 Github Pages + Hugo 搭建个人博客零.效果一.创建 Github 库二.安装 Hugo 和 Git 三.新建 Hugo 网站四.选择 Hugo 主题五.新建文章 ...
GitHub Pages + Hexo搭建个人博客网站，史上最全教程
文章目录一.准备工作 1. GitHub账号 2. 安装Git 3. 安装NodeJS 二.创建仓库三.安装Hexo 四.更换主题 1. NexT 主题 2. Fluid主题五.创建文章六.个 ...
个人博客代码_Jekyll + Github Pages 搭建个人免费博客
今天亲手通过 Jekyll 搭建了一套免费博客,搭建步骤其实超级简单.你不需要购买域名,也不需要购买服务器,就可以轻松拥有你自己的博客.Jekyll 的核心是一个文本转换引擎.它的方便之处在于支持多种 ...
Github Pages+Gridea搭建个人博客
1 概述 Github Pages可以用来托管个人网站,静态的,便于用来实现博客,可以在一个仓库的settings中开启: Gridea是一个静态博客写作客户端,所有文件都在本地,没有数据库,实现简单 ...
【GitHub.io/Github Pages使用教程】从头开始搭建自己的Github Pages，打造个人博客网站，展示个人简历、项目、文档或想要与世界共享的任何其他内容
巨人半边莲如果你曾征服乞力马扎罗山,留意过海拔 3,657-4,267 米处的尖顶植物,这种植物有时形似绿色大柱子(或'花序'),从中间长出花序. 那么你就可能看到许多巨人半边莲,这些植物生长在非洲 ...
从零开始使用GitHub Pages搭建Hexo静态博客
本文主要讲述如何使用GitHub Pages/Coding/Vercel搭建Hexo静态博客,以及如何使用jsDelivr加速静态资源.如何使用LeanCloud国际版搭载博客评论,和如何使用PicG ...
【开发工具】解决GitHub Pages制作的个人博客无法访问的问题
推荐阅读 CSDN主页 GitHub开源地址 Unity3D插件分享简书地址我的个人博客 QQ群:1040082875 大家好,我是佛系工程师☆恬静的小魔龙☆,不定时更新Unity开发技巧,觉得有 ...
Vuepress + GitHub Actions实现文档博客自动部署
说明接着我上一篇文章,已经使用vuepress+github pages搭建好了自己的文档博客,并且可以在本地打包上传后就可以在pages上查看更新内容.但是有1个比较明显的缺点:打包速度并不快!! ...
使用 Python 在 GitHub 上运行你的博客
使用 Pelican 创建博客,这是一个基于 Python 的平台,与 GitHub 配合的不错. GitHub 是一个非常流行的用于源代码控制的 Web 服务,它使用 Git 同步本地文件和 Git ...

如何优雅又庶民地在Github Pages中上线Ghost博客系统

序篇

架设篇