> For the complete documentation index, see [llms.txt](https://avincheng.gitbook.io/notebook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://avincheng.gitbook.io/notebook/server/ghost/centos7-an-zhuang-pei-zhi-ghost.md).

# CentOS7 安装配置 Ghost

## 准备工作

### 环境依赖

* 至少 1 GB 物理内存（可设置 1GB 以上的 Swap 代替）
* Systemd （CentOS 7 自带）
* 一个非 root 且拥有 sudo 权限的用户（用户名不能为 ghost ）
* NGINX（如需使用 HTTPS 则需要 NGINX >= 1.9.5）
* Node.js（ [支持的 Node.js 版本](https://ghost.org/faq/node-versions/)  ，推荐 node\@10）
* Yarn（替代 npm 管理 Node.js 软件包）

### 检查系统内存

查看当前系统内存：

```
free
```

> ​ total used free shared nbuff/cache available
>
> Mem: 1016168 100360 293520 356 622288 746024
>
> Swap: 0 0 0

可见当前系统物理内存为 1GB，虚拟内存为 0，可以不设置。

如果物理内存不足 1GB，可设置 1GB 交换分区作为虚拟内存使用：

```
# 创建一个 1GiB 大小空文件 /var/swap
sudo dd if=/dev/zero of=/var/swap bs=1k count=1024k

# 设置该文件为只读
sudo chmod 600 /var/swap

# 在该文件上建立交换分区
sudo mkswap /var/swap

# 启用交换分区
sudo swapon /var/swap

# 写入交换分区信息到开机分区挂载配置文件中
# 该命令需要切换至 root 用户才能执行
echo '/var/swap swap swap default 0 0' >> /etc/fstab
```

再次查看系统内存信息：

```
free
```

> ​ total used free shared buff/cache available Mem: 1016168 100360 293520 356 622288 746024 Swap: 1048572 0 1048572

### 检查当前用户

安装运行 Ghost 需要使用一个非 root ，用户名不为 ghost 且拥有 sudo 权限的用户。如果没有，需要新建一个用户进行后续操作。

### 检查 NGINX

检查 NGINX 版本：

```
nginx -v
```

> nginx version: nginx/1.10.2

如果需要使用 HTTPS，则需要 NGINX >= 1.9.5。

### 检查 Node.js

检查 Node.js 版本：

```
node -v
```

> v10.16.3

### 检查 Yarn

查看当前安装的 Yarn 版本：

```
yarn -v
```

> 1.19.0

查看 Yarn 全局 bin 路径：

```
yarn global bin
```

> /usr/local/bin

如果 `yarn global bin` 路径不是公共路径，需要设置成公共路径。

> **Tips:** Ghost 服务启动时，是以 ghost 这个用户的身份启动的，这个用户没有访问其他用户个人目录文件的权限。Yarn 全局安装的 Ghost-CLI 命令在 `yarn global bin` 路径，如果该路径不是公共路径，会导致 Ghost-CLI 命令执行失败。

查看当前用户的环境变量中的 `$PATH` ：

```
echo $PATH
```

> /usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin

如果 Yarn 全局 bin 路径不在其中，需要手动添加到环境变量中。

## 安装 Ghost

### 安装 Ghost-CLI

使用 Yarn 全局安装 Ghost-CLI ：

```
sudo yarn global add ghost-cli@latest
```

查看安装的 Ghost-CLI 版本：

```
ghost -v
```

> Ghost-CLI version: 1.11.0

### 新建 Ghost 安装目录

新建 Ghost 安装目录：

```
sudo mkdir -p <dir>
```

修改安装目录所有者为安装运行 Ghost 的用户：

```
sudo chown <user>:<user> <dir>
```

修改安装目录权限：

```
sudo chmod 775 <dir>
```

进入安装目录：

```
cd <dir>
```

### 使用 Ghost-CLI 安装 Ghost

使用 Ghost-CLI 在当前目录安装 Ghost ，并使用 SQLite 3 数据库，安装完不启动 ：

```
ghost install --no-stack --db=sqlite3 --no-start
```

> ...... ? Enter your blog URL: (<http://localhost:2368>)

输入博客访问地址：

> ? Enter your blog URL: <http://blog.avincheng.com> ...... ? Do you wish to set up Systemd? (Y/n)

输入 `Y` 或者直接回车，自动创建 Systemd 服务 ：

> ..... Ghost was installed successfully! To complete setup of your publication, visit:
>
> <https://blog.avincheng.com/ghost/>

此时完成安装。

### 配置 NGINX

新建配置文件：

```
sudo vim /etc/nginx/conf.d/blog.avincheng.com.conf
```

写入配置：

```
# blog.avincheng.com
server {
  listen 80;
  server_name blog.avincheng.com;
  client_max_body_size 5m;

  location / {
    proxy_pass http://127.0.0.1:2368;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}
```

修改 `server_name` 字段为自己解析的域名，多个域名空格隔开。

保存退出，重启 NGINX 服务：

```
sudo systemctl restart nginx
```

### 启动 Ghost

搜索 Ghost-CLI 创建的 Systemd 服务文件：

```
find /lib/systemd/system -name 'ghost_*'
```

> /lib/systemd/system/ghost\_blog-avincheng-com.service

使用 Systemd 服务启动 Ghost：

```
sudo systemctl start ghost_blog-avincheng-com
```

设置 Ghost 开机启动：

```
sudo systemctl enable ghost_blog-avincheng-com
```

通过浏览器访问管理后台地址并注册管理员账号：

```
http://blog.avincheng.com/ghost
```

## 管理 Ghost

在 CentOS 7 上，Ghost-CLI 相关命令在检查 Ghost 的 Systemd 服务状态时返回值为 `unknown` ，会导致命令执行失败。所以相关命令如 `ghost start/stop/restart/ls` 等均无法执行，需要直接使用 Systemd 启动或停止 Ghost 服务。

启动 Ghost：

```
sudo systemctl start <service>
```

停止 Ghost：

```
sudo systemctl stop <service>
```

重启 Ghost：

```
sudo systemctl restart <service>
```

设置 Ghost 开机启动：

```
sudo systemctl enable <service>
```

停止 Ghost 开机启动：

```
sudo systemctl disable <service>
```

## 参考文献

* [How to install Ghost on Ubuntu](https://ghost.org/docs/install/ubuntu/)
* [Ghost CLI](https://ghost.org/docs/api/v2/ghost-cli/)