无法访问部署在CentOS7 VPS cPanel上的Node.js+Express项目URL

1. 确认cPanel的Node.js应用配置 #

• 登录cPanel，找到Node.js Selector（或同类Node管理工具），检查应用是否指向public_html/backend路径，且启动文件（如server.js/app.js）设置正确。
• Express代码不能硬写端口，必须读取cPanel分配的环境端口：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`Server running on port ${port}`);
  });
  

• 确认应用处于运行状态，修改代码后务必重启应用。

2. 配置.htaccess反向代理 #

cPanel需通过.htaccess将外部请求转发到Node服务端口：

• 若想通过https://mydomain/backend/apiV1/getGender访问，在public_html/backend目录创建.htaccess（替换XXXX为cPanel分配的端口）：

  RewriteEngine On
  RewriteRule ^$ http://127.0.0.1:XXXX/ [P,L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ http://127.0.0.1:XXXX/$1 [P,L]
  

• 若想通过https://mydomain/apiV1/getGender访问，在public_html根目录创建.htaccess：

  RewriteEngine On
  RewriteRule ^apiV1/(.*)$ http://127.0.0.1:XXXX/apiV1/$1 [P,L]
  

3. 验证Express路由正确性 #

检查代码中路由定义是否匹配请求路径，示例：

app.get('/apiV1/getGender', (req, res) => {
  // 业务逻辑
  res.json({ status: 'success', data: 'male' });
});

确认路径无拼写、大小写或斜杠错误。

4. 检查服务器权限与防火墙 #

• 登录CentOS7终端，开放Node应用端口（替换XXXX）：

  sudo firewall-cmd --add-port=XXXX/tcp --permanent
  sudo firewall-cmd --reload
  

• 临时关闭cPanel的ModSecurity测试，若恢复访问则排查规则冲突。

5. 查看应用日志 #

在cPanel的Node.js管理界面打开日志查看，检查启动报错（如依赖缺失、语法错误）或请求异常日志，快速定位问题。

内容的提问来源于stack exchange，提问作者MN A