Ghost在Linux上需用非root用户安装：先创建ghostadmin用户，装Node.js v18.17+，再以该用户执行ghost install local --no-stack --db=sqlite3，确保content目录权限正确且current为指向版本目录的软链接。
Ghost 在 Linux 上不是“一键安装”的传统软件，它本质是 Node.js 应用，安装过程核心是：装对版本的 Node.js、用正确权限部署、区分开发/生产模式、绕过 root 直接运行的陷阱。直接用 sudo npm install -g ghost-cli 然后 ghost install 很可能失败——尤其在 Ubuntu 24.04 或 Debian 12+ 上，因为新版 ghost-cli 默认拒绝 root 权限，且对 systemd 服务管理有强依赖。
必须用非 root 用户运行 ghost-cli
Ghost 官方从 v5 起明确禁止 root 执行 ghost install，否则报错：Error: You cannot run ghost-cli as root。这不是限制，而是安全设计：Ghost 进程不该以最高权限监听网络或读写内容目录。
- 先创建专用用户，比如
ghostadmin：sudo adduser ghostadmin - 加进
sudo组（仅首次配置需要）：sudo usermod -aG sudo ghostadmin - 切换过去：
su - ghostadmin，所有后续操作都在该用户下进行 - 千万别在
root下chown -R ghostadmin:ghostadmin /var/www/ghost后还用sudo启动——这会破坏文件所有权和 systemd 单元文件绑定
Node.js 版本必须严格匹配 Ghost 要求
Ghost 5.x 要求 Node.js v18.17+ 或 v20.x（LTS），但不支持 v21+ 或 v22.x 的某些实验性 API。用 nodesource 源装错小版本，ghost install 会卡在 “Checking system compatibility” 并静默退出。
- 卸载已有的错版：
sudo apt remove nodejs npm，再清空/usr/lib/node_modules - 只启用 v18.x LTS 源：
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - - 安装：
sudo apt install -y nodejs - 验证：
node -v必须输出类似v18.20.2；npm -v≥9.6.7 - 别用
npm install -g n切版本——ghost-cli会读取系统 PATH 中第一个node，而n管理的二进制常不在标准路径
ghost install 命令必须带 --no-stack 参数才真正可用
默认 ghost install 会尝试自动配 Nginx、MySQL、SSL 和 systemd，但在多数 VPS（如 Kamatera、Hetzner）上，它因权限或端口冲突失败，最终只留一个半残的 config.production.json，且 ghost start 报 Cannot find service file。
- 先手动建目录：
sudo mkdir -p /var/www/ghost，再sudo chown ghostadmin:ghostadmin /var/www/ghost - 切到用户下：
su - ghostadmin，然后cd /var/www/ghost - 运行：
ghost install local --no-stack --db=sqlite3 -
--no-stack关闭自动 Nginx/MySQL 配置，只生成 systemd 服务文件和 SQLite 数据库 -
local模式跳过域名校验，适合调试；生产环境换成ghost install --no-stack --url=https://yourdomain.com
systemd 服务启动失败时查这三个地方
执行 ghost start 后没反应，或 sudo systemctl status ghost_localhost 显示 failed，问题通常不出在 Ghost 本身，而在环境链路。
- 看日志第一行：
sudo journalctl -u ghost_localhost -n 50 -f，重点找ENOENT: no such file or directory, open '/var/www/ghost/content/apps/...——说明content目录权限不对，应为ghostadmin:ghostadmin，不能是root - 检查
/var/www/ghost/system/files/ghost_localhost.service是否存在，若无，说明ghost install没走完，重跑带--no-stack的命令 - 确认
/var/www/ghost/current是软链接，指向类似/var/www/ghost/versions/5.99.0的真实版本目录；如果它是空目录或硬链接，ghost update会彻底失效
Ghost 的“配置”其实就两件事：一是让 config.production.json 里的 url、database、mail 字段值生效，二是确保 systemd 能干净加载那个自动生成的 service 文件。其他所谓“Nginx 反代”“Let’s Encrypt”都是外围，可延后手工配。最容易被忽略的，是每次 ghost update 后，current 软链接是否被正确更新——不检查这点，升级后网站白屏，却以为是主题或插件问题。
