Ghost 博客平台安装和配置

「爱情、让人受尽委屈。」 2024-04-19 12:29 64阅读 0赞

[Ghost][] 是一个博客发布平台，和 Hexo 等类似。本文简要介绍如何安装和配置 Ghost，环境为 Ubuntu 16.04 系统上，假设你已经拥有一个服务器和一个域名。

## 安装 ##

安装过程主要参考[官方教程][Link 1]，下面我总结下：

1.  在系统上创建一个新用户。一般安装 Ghost 会使用一个新用户，当然这也不是必须的。创建用户可以使用 `useradd` 和 `adduser` 命令，然后使用 `usermod` 命令将其加到 `sudo` 组里，最后使用新用户登录系统。命令详细使用方法可参考其文档，假设我们创建的用户叫 `price`
2.  更新系统，安装 NGINX、MySQL、Node.js 和 Ghost-CLI
    
        sudo apt update
        
        # 安装 NGINX、MySQL
        # 安装 MySQL 时会弹出窗口让输入 MySQL 用户名和密码
        # 用户名默认 root，密码自己设置，安装 Ghost 时会用到
        # 如果你的系统是 18.04，那么需要额外的一些步骤
        # 参考 https://ghost.org/docs/install/ubuntu/#mysql-on-ubuntu-1804
        sudo apt install nginx mysql-server
        
        # 配置防火墙
        sudo ufw allow 'Nginx Full'
        
        # 安装 Node.js
        curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash
        sudo apt install nodejs
        
        # 安装 Ghost-CLI
        sudo npm install ghost-cli@latest -g
3.  创建安装目录，配置目录权限，安装 Ghost
    
        # 创建并配置目录
        sudo mkdir -p /var/www/ghost
        sudo chown price:price /var/www/ghost
        sudo chmod 775 /var/www/ghost
        cd /var/www/ghost
        
        # 安装 Ghost
        ghost install
4.  在 `ghost install` 命令执行之后，首先会下载安装 ghost，然后会让你一项一项的配置 ghost，主要有一下几项：
    
     *  博客地址：例如 `https://example.com`，带上 http 或者 https，如果使用 https， Ghost 会自动帮你设置。使用 IP 地址会报错，但是这个具体怎么报错不清楚，还没遇到过，还是推荐先自己买个域名
     *  MySQL hostname：如果 Ghost 和 MySQL 在一个服务器上的话，这一项默认 `localhost` 即可
     *  MySQL 用户名密码：前面安装 MySQL 的时候你设置的用户名密码
     *  Ghost 数据库名：默认即可
     *  是否设置一个 Ghost MySQL 用户：默认是，前提是你前面提供的 MySQL 用户是 root 用户
     *  是否设置 NGINX：默认是
     *  是否设置 SSL：如果你前面提供的博客地址是 `https`，那么就选是，Ghost 会自动帮你用 [Let’s Encrypt][Let_s Encrypt] 设置 SSL。你也可以之后手动执行 `ghost setup ssl` 来设置
     *  你的邮箱：输入你的邮箱地址，万一你的证书有问题（比如到期了），Let’s Encrypt 就会通知你，这个是和上面的 SSL 相关的
     *  是否设置 systemd：默认是
     *  是否启动 Ghost：默认是

至此，安装工作全部完成，顺利的话就可以输入你的博客地址进入博客了，也可以使用 `ghost ls` 来查看你的博客是否在运行。

## 配置 ##

Ghost 安装好启动后，就可以输入你的博客地址进入博客了，在你的博客地址后加上 `/ghost` 进入博客后台页面。第一次进入需要先创建一个新作者（用户），然后就可以进行编辑发表文章了。  
![Ghost 后台][Ghost 1]  
里面有很多项可以配置，下面我说下如何实现一些常用的功能。

### 代码高亮 ###

代码高亮可以使用 [Prism][] JS 库和 Ghost 的 Code injection 来实现，后者中的代码会加入到每个页面中。

具体做法是将 Prism 的 js（实现代码高亮） 和 css（主题） 地址分别插入到 Code injection 中的 foorter 和 header 中。地址可以使用 Cloudflare 提供的 [CDN 地址][CDN]。

对于 js 来说，需要至少两个：一个核心 js 和 N 个特定语言相关的 js。如果你只需要 Python 语法高亮，那么只用添加 Python 的 js 即可。首先将核心 js 放在最上面，然后依次放入你需要的语言的 js，例如我想要实现 bash 和 Python 的语法高亮，那么在 footer 中内容如下：

对于 css 来说，指定了背景主题。Prism 提供 8 种主题，为了能够直观看到每个主题的样子，我汇总起来做了一个图如下，你可以选择你想要的放入 header 即可：  
![主题预览][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAwOTkwODA_size_16_color_FFFFFF_t_70]  
例如：

import numpy as np
    import pandas as pd
    
    # numpy 随机数
    a = np.random.rand(5, 4)
    df = pd.DataFrame(a, columns=list('ABCD'))

### 数学公式 ###

数学公式一般使用 [MathJax][] 来渲染，同样将如下代码放入 Code injection 即可：

这样会自动时刻保持最新版本。

E = m c 2 E = mc^2 E=mc2

### 加密博客站点 ###

实际上是为博客设置一个密码，只能输入密码访问，并且会取消一切 SEO 优化。在 `SETTINGS -> General -> ADVANCED SETTINGS` 处启用 `Make this site private` 即可。

### 邮箱配置 ###

邮箱配置较长，放在了一篇单独博文中，参见[使用 Mailgun 配置 Ghost 邮箱][Mailgun _ Ghost]一文。

## Reference ##

*  [Adding code highlighting to Ghost blog][]
 *  [Prism][Prism 1]
 *  [How to Add Syntax Highlighting to Ghost | Biron Themes][How to Add Syntax Highlighting to Ghost _ Biron Themes]
 *  [prism - cdnjs.com - The best FOSS CDN for web related libraries to speed up your websites!][CDN]
 *  [MathJax | Beautiful math in all browsers.][MathJax _ Beautiful math in all browsers.]

## END ##

[Ghost]: https://ghost.org/
[Link 1]: https://ghost.org/docs/install/ubuntu/
[Let_s Encrypt]: https://letsencrypt.org/
[Ghost 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/81b5f518e0fb4939bfac1d44ba14158b.png
[Prism]: https://prismjs.com/
[CDN]: https://cdnjs.com/libraries/prism
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAwOTkwODA_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/64484c0febe8489a8d7a7e3d42eaaaa4.png
[MathJax]: https://www.mathjax.org/
[Mailgun _ Ghost]: https://blog.csdn.net/u010099080/article/details/100990638
[Adding code highlighting to Ghost blog]: https://www.grzegorowski.com/adding-code-highlighting-to-ghost-blog
[Prism 1]: https://prismjs.com/#basic-usage
[How to Add Syntax Highlighting to Ghost _ Biron Themes]: https://bironthemes.com/blog/how-to-add-syntax-highlighting-to-ghost/
[MathJax _ Beautiful math in all browsers.]: https://www.mathjax.org/#gettingstarted