You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

在Plesk服务器部署Strapi遇异常:域名返回默认模板求助

在Plesk部署Strapi后显示默认模板的排查与解决

核心排查方向

1. 反向代理与端口映射问题

Plesk需要把域名请求正确转发到Strapi服务,这是最常见的问题点:

  • 确认Plesk的Node.js设置中,应用根目录指向Strapi项目根文件夹(包含package.json的目录)
  • 启动配置优先用npm start作为启动命令(对应Strapi默认的strapi start脚本),而非直接指定server.js,避免路径或权限问题
  • 检查Apache & Nginx设置,添加反向代理规则确保请求转发到Strapi端口(默认1337):
    location / {
        proxy_pass http://localhost:1337;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    
    没有这条规则的话,Plesk会直接加载默认静态模板。

2. 静态文件优先级冲突

Plesk默认优先加载域名根目录下的静态文件(比如index.html),如果项目目录里存在Plesk默认模板文件或误生成的静态页面,会覆盖Strapi服务:

  • 删除项目根目录下的index.html等无关静态文件
  • 若应用完全由Strapi接管,可在Apache & Nginx设置中勾选「禁用静态文件服务」

3. Strapi配置与环境变量问题

Strapi需要正确的绑定配置才能对外提供服务:

  • 在Plesk的Node.js环境变量中添加:NODE_ENV=production、SERVER_URL=https://你的域名、STRAPI_ADMIN_BACKEND_URL=https://你的域名
  • 检查config/server.js,确保host设为0.0.0.0(允许外部访问):
    module.exports = ({ env }) => ({
      host: env('HOST', '0.0.0.0'),
      port: env.int('PORT', 1337),
      url: env('SERVER_URL'),
    });
    

4. 服务实际启动状态验证

部署无报错不代表Strapi真的启动成功:

  • 查看Plesk Node.js模块的「日志」,确认是否出现Server is running on http://0.0.0.0:1337的启动成功提示
  • 若日志显示依赖缺失,在Plesk终端进入项目根目录执行npm install补全依赖

关于启动文件的说明

Strapi v4的启动文件确实是server.js,但更推荐用npm start作为启动命令(package.json已默认配置对应脚本),无需额外指定其他文件。

成功部署情况

已有大量开发者在Plesk上成功部署Strapi,核心是做好反向代理配置、环境变量设置,并确保Strapi服务正常启动,按上述步骤排查即可解决默认模板问题。

内容的提问来源于stack exchange,提问作者Oscar Figueroa

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.01 22:53:21