如何高效掌握Ghost-CLI？

Ghost-CLI 是官方提供的命令行工具，用于在服务器上高效安装、配置、升级和管理自托管的 Ghost 博客系统，简化部署和维护流程。

Ghost 是一个强大的开源内容发布平台，其官方命令行工具 Ghost-CLI 是管理 Ghost 安装、配置和维护的核心工具，掌握这些命令能高效完成站点管理任务。

核心前提

环境要求：确保运行在 Linux 环境（推荐 Ubuntu），并已安装：
- Node.js (推荐 LTS 版本，如 v18.x)
- NPM 或 Yarn
- 支持的数据库 (MySQL 8.0+ 或 SQLite 3)
- Nginx (生产环境推荐)
权限要求：大部分命令需使用 sudo 或以拥有足够权限的用户执行。
安装位置：命令需在 Ghost 安装目录 下执行（包含 content, versions 等子目录）。

核心安装与配置命令

安装 Ghost-CLI (全局安装管理工具)：
```
npm install -g ghost-cli@latest
```
- 作用：安装或更新 Ghost 命令行工具本身。
- E-A-T 提示：始终使用官方 @latest 确保获取最新稳定版和安全更新。
全新安装 Ghost：
```
ghost install
```
- 作用：在当前目录执行完整的 Ghost 安装流程，CLI 会交互式引导你：
  - 配置站点 URL
  - 设置 MySQL 或 SQLite 数据库
  - 创建系统服务 (Systemd)
  - 配置 Nginx (可选)
  - 设置管理员账户
- 关键参数：
  - --db=sqlite3 / --db=mysql：明确指定数据库类型。
  - --dbhost, --dbuser, --dbpass, --dbname：自定义 MySQL 连接信息。
  - --url：设置你的博客完整访问地址。
  - --no-setup-nginx：跳过自动 Nginx 配置。
  - --no-setup-systemd：跳过自动 Systemd 服务创建。
  - --no-setup-ssl：跳过自动 SSL 证书申请 (Let’s Encrypt)。
  - --no-start：安装完成后不自动启动 Ghost。
- E-A-T 提示：生产环境强烈推荐使用 --db=mysql 和配置 SSL (--setup-ssl)，交互式安装是最安全、最推荐的方式。
配置现有安装：
```
ghost setup
```
- 作用：重新运行安装后的配置向导，用于修改 URL、数据库连接、SSL 设置、服务配置等。不会数据。
- 适用场景：迁移服务器、更换域名、修改数据库密码后。
- E-A-T 提示：修改关键配置（如 URL、数据库）前务必备份 (ghost backup)。

日常运维命令

启动 Ghost：
```
ghost start
```
- 作用：启动 Ghost 进程。
停止 Ghost：
```
ghost stop
```
- 作用：停止正在运行的 Ghost 进程。
重启 Ghost：
```
ghost restart
```
- 作用：重启 Ghost 进程，应用配置更改或更新后常用。
查看 Ghost 状态：
```
ghost status
```
- 作用：显示 Ghost 进程是否运行、版本号、环境 (production/development)、URL 和日志文件路径。故障排查第一步。
查看 Ghost 日志：
```
ghost log
```
- 作用：实时显示 Ghost 的日志输出，按 Ctrl+C 退出。
- 参数：-f 或 --follow 等同于实时查看（默认行为）。-n 显示最近 N 行。

更新与维护命令

检查 Ghost 更新：
```
ghost update --check
```
- 作用：检查是否有新版本的 Ghost 可用，不执行更新，输出可用版本信息。
更新 Ghost：
```
ghost update
```
- 作用：将 Ghost 升级到最新可用版本，流程包括：
  1. 执行备份 (ghost backup 自动触发)。
  2. 停止当前进程 (ghost stop)。
  3. 下载并安装新版本。
  4. 启动新版本 (ghost start)。
- 参数：--force 强制更新（即使有小版本不兼容警告，慎用）。
- E-A-T 提示：更新前务必手动备份 (ghost backup)，定期更新是保持安全性和功能性的关键。
备份 Ghost：
```
ghost backup
```
- 作用：创建当前 Ghost 安装的完整备份，包含：
  - 数据库转储 (SQL 文件)
  - content/ 目录 (图片、主题、配置文件等)
  - 备份元数据 (JSON 文件)
- 输出：在 Ghost 安装目录下生成 .backup 文件夹存放备份文件。
- E-A-T 提示：定期备份是数据安全生命线，更新、迁移、重大修改前必须备份，考虑将备份文件异地存储。
恢复 Ghost 备份：
```
ghost restore 
```
- 作用：从指定的备份文件恢复 Ghost 安装。此操作会覆盖当前数据库和 content/ 目录！
- 流程：
  1. 停止 Ghost (ghost stop)。
  2. 解压备份文件。
  3. 恢复数据库。
  4. 恢复 content/ 文件。
  5. 启动 Ghost (ghost start)。
- E-A-T 提示：恢复是高风险操作，确保备份文件完整且在相同或兼容的 Ghost 版本上恢复，恢复前备份当前状态。

其他实用命令

查看 Ghost-CLI 帮助：
```
ghost --help
ghost  --help # 查看特定命令帮助
```
- 作用：获取所有命令列表或特定命令的详细参数说明。
查看 Ghost 版本：
```
ghost version
```
- 作用：显示当前安装的 Ghost 版本和 Ghost-CLI 版本。
以开发模式运行：
```
ghost run
```
- 作用：在前台启动 Ghost (通常用于 development 环境调试)，日志直接输出到控制台，按 Ctrl+C 停止。生产环境勿用。
安装/切换主题：
- 将主题 ZIP 包上传到 content/themes/ 目录。
- 在 Ghost Admin -> Design -> Themes 中激活。
- CLI 不直接管理主题安装，但 ghost restart 常用于激活新主题后。

重要安全与最佳实践 (E-A-T 核心体现)

最小权限原则：避免使用 root 用户直接操作 Ghost，使用 sudo 执行需要特权的命令。
定期备份：ghost backup 是核心命令，自动化备份策略（如 cron 任务）至关重要。
及时更新：ghost update 保持软件安全，关注 Ghost 官方博客的安全公告。
生产环境配置：
- 必须使用 production 环境 (ghost config --environment production)。
- 强烈推荐使用 MySQL 数据库 (--db=mysql)。
- 强制要求使用 HTTPS (ghost setup ssl 或自行配置)。
- 配置防火墙 (如 UFW)。
官方文档优先：遇到问题时，Ghost 官方文档是最权威的解决方案来源。
理解命令后果：特别是 ghost restore 和带 --force 的操作，务必确认风险。
错误排查：ghost status 和 ghost log 是诊断问题的起点，检查日志中的 ERROR 和 FATAL 信息。

常见问题 (FAQ)

Q: 命令提示 Command 'ghost' not found？
A: Ghost-CLI 未全局安装或 PATH 未包含，用 npm install -g ghost-cli@latest 安装，或使用完整路径 (如 /usr/bin/ghost 或 ~/.npm-global/bin/ghost)。
Q: ghost install 卡住或报错？
A: 检查网络连接、系统资源（内存/磁盘）、依赖项（Node.js, MySQL, Nginx）是否满足要求，仔细阅读错误信息，通常包含具体原因（如端口冲突、权限不足、数据库连接失败），查看详细日志 /var/log/ghost/。
Q: 更新 (ghost update) 失败怎么办？
A: 1) 检查 ghost status 和 ghost log 获取错误详情，2) 尝试手动备份后 ghost restart，3) 常见问题可能是权限问题或磁盘空间不足，4) 参考官方更新指南或社区支持。
Q: 如何迁移 Ghost 到新服务器？
A: 1) 在旧服务器执行 ghost backup，2) 将备份文件 .backup 复制到新服务器，3) 在新服务器安装相同版本的 Ghost (可用 ghost install 但不启动)，4) 在新服务器 Ghost 目录执行 ghost restore，5) 运行 ghost setup 配置新服务器环境 (URL/IP、数据库等)，6) ghost start。