Debian 12 安装配置 Ghost 5
环境检查
环境依赖
- Systemd （Debian12 自带）
- 使用 SQLite3 作为数据库（无须安装 MySQL）
- 至少 1 GB 物理内存（可设置 1GB 以上的 Swap 代替）
- 一个非
root且拥有sudo权限的用户来安装 Ghost（用户名不能为ghost） - nginx（如需使用 HTTPS 则需要 nginx >= 1.9.5）
- Node.js（ 支持的 Node.js 版本 ，推荐 node@20）
检查系统内存
系统内存信息：
free
total used free shared buff/cache available
Mem: 1016168 100360 293520 356 622288 746024
Swap: 1048572 0 1048572
检查当前用户
安装 Ghost 需要使用一个非 root ，用户名不为 ghost（Ghost 默认会创建一个名为 ghost 的专用系统用户，目的是以最小权限运行 Ghost 进程）且拥有 sudo 权限的用户。如果没有，需要新建一个用户进行后续操作。
检查 nginx
检查 nginx 版本：
sudo nginx -v
nginx version: nginx/1.22.1
检查 Node.js
检查 Node.js 版本：
node -v
v20.19.1
安装 Ghost
配置 nginx
新建网站配置文件：
sudo vim /etc/nginx/sites-available/blog.avinzheng.com.conf
写入配置：
# blog.avinzheng.com
map $status $header_content_type_options {
204 "";
default "nosniff";
}
server {
listen 80;
server_name blog.avinzheng.com;
client_max_body_size 50m;
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 X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
add_header X-Content-Type-Options $header_content_type_options;
}
}
server_name 字段为自己解析到主机的域名，多个域名空格隔开。
建立符号链接到 /etc/nginx/sites-enabled/ 目录下：
sudo ln -s /etc/nginx/sites-available/blog.avinzheng.com.conf /etc/nginx/sites-enabled/blog.avinzheng.com.conf
验证 nginx 配置是否正确：
sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
重启 nginx 服务：
sudo systemctl restart nginx
配置 AppArmor
如果配置了 nginx 的 AppArmor 规则，需要修改规则文件：
sudo vim /etc/apparmor.d/usr.sbin.nginx
需要添加相应文件路径：
#include <tunables/global>
/usr/sbin/nginx {
...
/var/lib/nginx/body/** rw,
/var/lib/nginx/proxy/** rw,
}
加载 AppArmor 配置文件：
sudo apparmor_parser -r /etc/apparmor.d/usr.sbin.nginx
安装 Ghost-CLI
使用 npm 全局安装 Ghost-CLI ：
sudo npm install -g ghost-cli@latest
Ghost 在使用 Ghost-CLI 启动后会使用降权用户 ghost 来运行 Ghost 进程，如果使用 pnpm 或者 Yarn 安装需要确保 global bin 和 node_modules 均在系统级路径（ user/, user/local/ 等路径下），不能为默认的用户级路径（~/.local/ 等），不然启动 Ghost 会因为权限问题出错：
Can't connect to the bootstrap socket (localhost 8000) ECONNREFUSED
查看安装的 Ghost-CLI 版本：
ghost -v
Ghost-CLI version: 1.27.0
新建安装目录
新建安装目录并设置权限：
sudo mkdir -p <dir>
sudo chown <user>:<user> <dir>
sudo chmod 775 <dir>
<dir>为Ghost 安装目录<user>为当前用户（运行 Ghost 的用户）
安装 Ghost
进入安装目录：
cd <dir>
使用 Ghost-CLI 在当前目录安装 Ghost ：
ghost install --db=sqlite3 --no-setup-nginx --no-setup-ssl
安装时会自动创建 Ghost 服务并设置开机启动。
安装完成后，通过浏览器访问管理后台地址并注册管理员账号：
http://blog.avinzheng.com/ghost
配置 Ghost
生产环境下 Ghost 的配置位于config.production.json 文件中：
vim config.production.json
隐私配置
添加隐私配置：
"privacy": {
"useUpdateCheck": false,
"useGravatar": false,
"useRpcPing": true,
"useStructuredData": false
}
useUpdateCheck：自动版本更新检查和匿名统计数据收集，默认开启。useGravatar：自动下载用户邮箱对应的 Gravatar 头像，默认开启。useRpcPing：自动在发布文章后通知搜索引擎，默认开启。useStructuredData：自动生成适用于某些社交网站的结构化数据，默认开启。
安全配置
添加安全配置：
"security": {
"staffDeviceVerification": false
}
staffDeviceVerification：在新设备登录 Ghost 管理后台时发送邮件验证码，默认开启。
搜索配置
Ghost 使用 JsDeliver CDN 来加载用于本地搜索的 sodo-search 资源文件。
如果主题没有集成本地搜索功能，可以去掉加载的 sodo-search 的 JS 文件：
"sodoSearch": {
"url": false
}
如果集成了，可以将文件放到主题的 assets 目录里面，添加以下配置：
"sodoSearch": {
"url": "/assets/sodo-search/sodo-xxx.js",
"styles": "/assets/sodo-search/sodo-xxx.css"
}
Ghost 升级后该配置需要重新添加到到配置文件。
管理 Ghost
服务管理
查看配置的 Ghost 服务：
ghost ls
启动 Ghost 服务：
ghost start <service>
停止 Ghost 服务：
ghost stop <service>
重启 Ghost 服务：
ghost restart <service>
查看 Ghost 服务状态：
sudo systemctl status <service>
设置 Ghost 服务开机启动：
sudo systemctl enable <service>
停止 Ghost 服务开机启动：
sudo systemctl disable <service>