Ghost Blog安装笔记

淮城一只猫 • 奇技淫巧

• 发布于 2018年10月06日 • 更新于 2023年11月09日

• 阅读量 0 次 • 评论量 0 个

Cap1 前言

本文在2023.11.09更新。

目前 Ghost 已经升级到 5.x 大版本了。

大概用了接近三年的 WordPress 博客平台，因为诸多原因放弃了它，目前看好的依然是Ghost平台，现在版本已经更新到 Version 2，本地测试下的确不错，所以写下这篇文章。

由于 Version 2 还没好很好的解决从 WordPress 过渡，所以我放弃原来的文章转移并且转移到 Hexo博客上。目前博客当作新博客来写作吧。

Cap2 安装Node.js环境

目前主机配置是腾讯云低配机：1 CPU/1G RAM/1Mbps/40G ROM，系统是 Ubuntu 20.04。关于系统脚手架只支持：Ubuntu 16.04, Ubuntu 18.04 或 Ubuntu 20.04。Ghost博客需要在 Node.js 环境下运行，查看Ghost文档有了自己脚手架：Ghost-Cli，所以很大的程度上比之前方便多了。

nvm是一个nodejs版本管理的工具，为什么需要nvm？nodejs版本迭代很快，而且转移包依赖很麻烦，总之nvm解决很对版本问题。具体可以查看Github的说明：nvm。

由于 Ghost 不允许 root 安装，所以需要新建一个普通的账户：

adduser <user> # ghost不允许root用户安装，所以需要新建个<user>用户
usermod -aG sudo <user> # 给予<user>用户为超级权限
su - <user> # 登录用户
sudo apt update
sudo apt upgrade # 更新软件

这里的 <user> 用户名可以自己任意修改，例如 jaxson 、 ubuntu 等。

但请不要使用 ghost 作为用户名，因为和 ghost-cli 用户名产生冲突。

2020.12.31更新：

安装 Node.js 没有上面那么麻烦，直接执行下面命令就行了：

# 添加 Nodejs 14 源
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash
 
# 安装 Node.js
sudo apt-get install -y nodejs # 大陆服务器暂时别执行这一步，看看下面的内容

国内的机器安装可能比较慢，因为不可描述的原因导致的，如果着急的话可以使用下面的方法。

2020.12.31更新：

针对国内服务器修改 Node.js 源：

sudo cp /etc/apt/sources.list.d/nodesource.list /etc/apt/sources.list.d/nodesource.list.bak # 备份
sudo vim /etc/apt/sources.list.d/nodesource.list

将里面的内容修改成，注意系统代号 focal ：

deb https://mirrors.ustc.edu.cn/nodesource/deb/node_14.x focal main
deb-src https://mirrors.ustc.edu.cn/nodesource/deb/node_14.x focal main

参考文档：中国科学技术大学 Node 源

保存后执行安装 Nodejs：

sudo apt update
sudo apt-get install -y nodejs # 安装 Node.js

设置npm镜像源（非中国大陆机器不用设置）：

npm config set registry https://r.npm.taobao.org # npm 镜像替换为淘宝npm节点
npm config set disturl https://npm.taobao.org/dist # node-gyp 编译依赖的 node 源码镜像
npm config set node_sqlite3_binary_host_mirror https://npm.taobao.org/mirrors # sqlite3 镜像
npm config set sqlite3_binary_site https://npm.taobao.org/mirrors/sqlite3/
npm config set sharp_binary_host https://npmmirror.com/mirrors/sharp
npm config set sharp_libvips_binary_host https://npmmirror.com/mirrors/sharp-libvips

sudo npm install -g npm # 更新 npm

# ghost-cli 使用 yarn 包管理器，所以进行源配置
sudo npm install -g yarn
yarn config set registry https://r.npm.taobao.org # yarn 镜像替换为淘宝npm节点
yarn config set disturl https://npm.taobao.org/dist # node-gyp 编译依赖的 node 源码镜像
yarn config set node_sqlite3_binary_host_mirror https://npm.taobao.org/mirrors # sqlite3 镜像
yarn config set sharp_binary_host https://npmmirror.com/mirrors/sharp
yarn config set sharp_libvips_binary_host https://npmmirror.com/mirrors/sharp-libvips
yarn config set sqlite3_binary_site https://npm.taobao.org/mirrors/sqlite3/ # sqlite3 镜像

Cap3 安装Nginx环境

如果你需要SSL配置需要NGINX 1.9.5或更高版本，当然你可以选择下载Nginx源码进行编译安装，省事可以直接执行：

sudo apt-get install nginx
nginx -v # 输出版本号

如果ufw已激活，则防火墙允许HTTP和HTTPS连接，所以打开防火墙：

sudo ufw allow 'Nginx Full'

Cap4 安装数据库

Ghost安装数据库推荐的是MySQL:

sudo apt install mysql-server

如果运行的是Ubuntu 18.04，则需要输入密码以确保MySQL与Ghost-CLI兼容：

# 进入数据库管理
sudo mysql
 
# 执行下列语句进行修改数据库密码
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '这是你要替换的密码';
 
# 退出数据库管理
quit;
 
# 退出mysql用户并且登录用户账户
su - <user>

不推荐安装 MariaDB 是因为不支持了，建议使用 MySQL，如果使用 MySQL8.x 大版本内存不足可以看看下面的解决方案。

Cap5 安装 Ghost-Cli & Ghost

sudo npm install ghost-cli@latest -g # 安装Ghost脚手架

创建网站目录：

# 创建ghost文件夹的网站目录，这个名字可以自己随便定义
sudo mkdir -p /var/www/ghost
 
# 使文件夹拥有权限，<user>是当前用户名
# 例如当前用户名是ubuntu，那么应该是：sudo chown ubuntu:ubuntu /var/www/ghost
sudo chown <user>:<user> /var/www/ghost
 
# 设置读写权限
sudo chmod 775 /var/www/ghost
 
# 定位
cd /var/www/ghost
 
# 进行Ghost博客平台安装
ghost install

安装过程根据主机性能来决定，下面是选项配置讲解：

Enter your blog URL: 博客展示地址，格式:http(s):(www.)example.com，不支持ip地址。
Enter your MySQL hostname: 数据库主机地址，回车默认是localhost。
Enter your MySQL username: / Enter your MySQL password: 数据库用户名/密码，上面安装的数据库用户名是root，密码是自己设置的。
Enter your Ghost database name: Ghost博客数据库名
Do you wish to set up "ghost" mysql user? 设置数据库用户名为ghost，这个为了避免权限太大导致数据瞎搞，Ghost官方推荐是y。
Do you wish to set up Nginx? 自动化Nginx，推荐y。
Do you wish to set up SSL? 配置SSL证书，推荐y，如果你有证书问题，请查看文章最下面的问题。
Enter your email (For SSL Certificate):个人邮箱，配置ssl证书需要的邮箱地址。
Do you wish to set up Systemd? 使用ghost进程管理工具，推荐y，个人觉得海星。
Do you want to start Ghost? 启动Ghost博客就可以进入网址访问。

Cap6 异常解决

如果在安装 Ghost 过程中经常性卡住，就需要一些特殊的方法，例如脚手架经常在第五步卡住，可以停止服务删除安装目录下所有文件重新执行：

ghost uninstall # 卸载原有 ghost 程序
sudo rm -rf /var/www/ghost/*
npm cache clean --force # 清空缓存
ghost install -V # -V 是把所有的安装日志打印到控制台，方便查看安装日志 不过大量的日志输出可能导致安装失败，所以在特殊情况下使用。

然后大部分安装或者升级的时候卡在：

node-pre-gyp WARN Using request for node-pre-gyp https download

如果卡在这边基本上是下载 sqlite3 卡住了，所以需要设置镜像：

npm config set registry https://r.npm.taobao.org # npm镜像替换为淘宝npm节点
npm config set disturl https://npm.taobao.org/dist # node-gyp 编译依赖的 node 源码镜像
npm config set node_sqlite3_binary_host_mirror https://npm.taobao.org/mirrors # sqlite3 镜像
ghost install -V # 重新安装
ghost upgrade -V # 升级博客

如果这样再不行建议大家安装 tbify 这个插件：

npm install -g tbify
tbify ghost install

插件详细介绍：https://github.com/fjc0k/tbify

如果遇到错误没有能力解决的，请在 ghost install -V 或者 ghost upgrade -V 执行中所有的命令贴上发送到我的邮箱或者评论中，这样我尽力为你解决问题。

Cap7 图片优化

图床使用的是 Ghost qiniu 图床：https://github.com/JaxsonWang/Ghost-Theme/tree/master/Ghost-QiNiu-Store

之前使用别人开源的图床插件，但是升级到 v3 版本后出现各种问题，无奈之下自己动手开发一套了，支持最新版。

例如在/var/www/ghost/content/adapters文件下新建个storage文件夹

cd /var/www/ghost/content/adapters/storage # 定位
git clone https://github.com/JaxsonWang/Ghost-QiNiu-Store.git qn-store # 拉取源码
cd qn-store # 定位
npm install # 安装模块依赖

然后打开/var/www/ghost/config.production.json文件，添加代码：

{
  // ...
  "storage": {
    "active": "qn-store",
    "qn-store": {
      "accessKey": "your access key", // https://portal.qiniu.com/user/key获取AK密匙
      "secretKey": "your secret key", // https://portal.qiniu.com/user/key获取SK密匙
      "bucket": "your bucket name", // 存储对象空间名字
      "domain": "http://xx.xx.xx.glb.clouddn.com", // 七牛CDN地址
      "format": "${year}/${month}/${name}${ext}"
    }
  }
  // ...
}

然后重启Ghost：

cd /var/www/ghost
ghost restart

Cap8 SSL错误

如果你域名设置@域名例如：https://iiong.com，访问是没有问题，但如果是访问www.iiong.com就会报错，如何解决这个问题呢：

重新配置：ghost config url https://www.mydomain.com
执行ghost setup nginx ssl
再修改回来：ghost config url https://mydomain.com

打开 /var/www/ghost/system/files/ 下的俩个www.*.conf文件，添加301跳转到顶级域名代码：

if ($ssl_protocol = "") {
    return 301 https://$host$request_uri;
}
if ($host != iiong.com) {
    return 301 $scheme://iiong.com$request_uri; #请注意这里的iiong.com替换你的域名。
}

重启sudo nginx -s reload服务

如果 /var/www/ghost/system/files/ 文件夹不存在，请在 /etc/nginx/sites-available 目录下修改文件。

Cap9 SSL 续费

参考：Ghost Let's Encrypt 得知：

/etc/letsencrypt/acme.sh --home "/etc/letsencrypt"

是证书管理目录，根据 acme.sh 得知手动续签执行：

/etc/letsencrypt/acme.sh --cron --home "/etc/letsencrypt"

不过我这个告知没有 root 权限：

sudo /etc/letsencrypt/acme.sh --cron --home "/etc/letsencrypt"

又被告之不推荐使用 sudo 执行，可以强制忽略：

sudo /etc/letsencrypt/acme.sh --cron --force --home "/etc/letsencrypt"

这样应该就可以了。

Cap10 内存不足

如果你的系统一直提示系统内存不足请参考：腾讯云开启 swap 分区

Cap11 自动化备份

如果需要自动化备份请参考：Ghost 实现自动化备份

Cap12 权限操作不足等问题

这个问题好几次遇到过了，但一直没有做总结，这个操作一般出自于 ghost 升级或者对 ghost 一些操作，例如重启、开启和关闭等，如果进行上列操作则会报错：

+ sudo systemctl is-active ghost_iiong-com
✔ Checking system Node.js version - found v14.21.3
✔ Ensuring user is not logged in as ghost user
✔ Checking if logged in user is directory owner
✔ Checking current folder permissions
✖ Checking folder permissions
✖ Checking file permissions
✖ Checking content folder ownership
✔ Checking memory availability
✔ Checking free space
One or more errors occurred.

1) Checking folder permissions

Message: Command failed: /bin/sh -c find ./ -type d ! -perm 775 ! -perm 755
find: ‘./content/themes/pomelo’: 权限不够

然后提示让你运行：

sudo find ./ ! -path "./versions/*" -type f -exec chmod 664 {} \;
# 或者
ghost setup linux-user systemd

依然没有效果，报错还是和上面一样，其实这个问题就是 Ghost 根目录权限不对导致的：

ubuntu@VM-4-8-ubuntu:/var/www/iiong.com$ ls -l
总用量 16
-rw-rw-r--  1 ubuntu ubuntu 1235 Mar 29 20:32 config.production.json
drwxrwxr-x 12 ubuntu  ubuntu  4096 Mar 24 17:11 content
lrwxrwxrwx  1 ubuntu ubuntu   34 Mar 29 20:32 current -> /var/www/iiong.com/versions/5.40.2
drwxrwxr-x  3 ubuntu  ubuntu  4096 Mar 28 21:46 system
drwxrwxr-x  5 ubuntu  ubuntu  4096 Mar 29 20:20 versions

按照官方默认的权限应该是：

ubuntu@VM-4-8-ubuntu:/var/www/iiong.com$ ls -l
总用量 16
-rw-rw-r--  1 ubuntu ubuntu 1235 Mar 29 20:32 config.production.json
drwxrwxr-x 12 ghost  ghost  4096 Mar 24 17:11 content
lrwxrwxrwx  1 ubuntu ubuntu   34 Mar 29 20:32 current -> /var/www/iiong.com/versions/5.40.2
drwxrwxr-x  3 ghost  ghost  4096 Mar 28 21:46 system
drwxrwxr-x  5 ghost  ghost  4096 Mar 29 20:20 versions

所以改回去就完事了：

sudo chown ghost:ghost ./content
sudo chown ghost:ghost ./system
sudo chown ubuntu:ubuntu ./versions