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 软链接是否被正确更新——不检查这点,升级后网站白屏,却以为是主题或插件问题。











