ghost在linux上需严格配置node.js（v18.x）、非root用户、nginx反向代理及手动校验config.js中url/database/host等字段，任一环节出错均导致“能启动但无法访问”。
Ghost 在 Linux 上不是“装上就能用”的 CMS，它依赖 Node.js 运行时、明确的用户隔离、反向代理和环境配置。跳过任一环节，npm start 可能成功，但访问 2368 端口会失败，或无法绑定域名、无法持久运行。
Node.js 版本必须匹配 Ghost 官方要求（不是越新越好）
Ghost 官方明确要求 Node.js LTS 版本——当前稳定支持的是 v18.x（如 v18.20.2），v20.x 已部分支持，v22.x 则未被正式验证。Ubuntu/Debian 默认仓库的 nodejs 包往往太旧（v12 或 v16），直接 apt install nodejs 极大概率导致 npm install --production 报错或启动后 502/ERR_EMPTY_RESPONSE。
正确做法是使用 NodeSource 源：
curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs
验证是否到位：
-
node -v输出应为v18.x.x -
npm -v应 ≥10.2.0（Ghost v5+ 要求） - 不要用
sudo npm install -g ghost-cli—— Ghost-CLI 与手动部署冲突，且不适用于生产环境
config.js 必须手动编辑，不能只靠 cp config.example.js
Ghost 启动时会读取 /var/www/ghost/config.js，但这个文件不是模板填充完就完事了。常见错误是只改了 host 和 port，却忽略 url 和数据库路径。
关键字段必须显式设置：
-
url：必须填你对外访问的完整地址，如https://blog.example.com；填http://localhost:2368或留空会导致图片路径错乱、管理后台登录跳转失败 -
database：默认 SQLite，路径需确保/var/www/ghost/content/data/目录存在且ghost用户有写权限；否则启动时报SQLITE_CANTOPEN -
server.host：生产环境务必设为127.0.0.1，而非0.0.0.0或服务器公网 IP —— 否则 Nginx 无法反向代理，且暴露内部端口
别信“启动一次自动生成 config.js 就能用”。首次 npm start 失败后生成的 config.js 往往字段缺失或值非法，必须人工校验。
Nginx 配置里 proxy_pass 必须指向 127.0.0.1:2368，且要处理静态资源缓存
Ghost 自身不托管静态文件（CSS/JS/图片），全靠 Nginx 缓存并透传。若只写一个 location / 代理，所有请求都打到 Node 进程，性能差、易超时、且 gzip 不生效。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
标准 /etc/nginx/conf.d/ghost.conf 至少要有两段：
server {
listen 80;
server_name blog.example.com;
<pre class="brush:php;toolbar:false;">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-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
proxy_pass http://127.0.0.1:2368;
expires 1y;
add_header Cache-Control "public, immutable";
}}
注意点：
- 必须用
proxy_set_header X-Forwarded-Proto $scheme，否则 Ghost 后台会误判为 HTTP，导致重定向循环 - 静态资源正则要覆盖
.woff2和.svg，否则字体图标和 SVG 图片 404 - 执行
sudo nginx -t && sudo systemctl reload nginx后再测，别跳过语法检查
Ghost 必须以非 root 用户运行，且 forever/pm2 启动前要切换上下文
Ghost 明确禁止 root 用户启动：Running Ghost as root is not recommended。用 sudo npm start 看似能跑，但一旦挂掉就无法自动恢复，且 content 目录权限混乱，后续升级失败率极高。
正确流程是：
- 创建专用用户：
sudo adduser ghostuser，加进sudo组 - 把
/var/www/ghost所有权交给它：sudo chown -R ghostuser:ghostuser /var/www/ghost - 切过去再装依赖：
sudo -u ghostuser -i→cd /var/www/ghost && npm install --production - 用
pm2（比forever更可靠）守护：pm2 start index.js --name ghost --watch
容易漏的细节：
-
pm2 startup必须在ghostuser下执行，否则开机不自启 -
pm2 save要跟上，否则重启后进程丢失 - 日志查
pm2 logs ghost，不是journalctl
Ghost 的脆弱点不在安装命令本身，而在 Node.js 版本、用户权限、Nginx 头部传递、以及 config.js 里那个看似无关紧要的 url 字段——四个地方任意一个配错，整个站点就表现为“能启动但打不开”。
