You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

如何在CPANEL上部署Node服务器?求可行的部署启动方案

在cPanel上部署Node.js服务器的完整步骤

我之前帮朋友在cPanel上部署过Node.js服务,踩过不少坑,这里给你整理一套亲测有效的步骤,跟着走基本不会出问题:

1. 先确认你的cPanel支持Node.js

首先得检查主机商给的cPanel有没有Node.js功能,一般在主面板里找「Setup Node.js App」(不同主机商可能叫「Node.js管理器」之类的,名字略有差异)。如果找不到,直接联系主机客服确认是否需要手动开通——有些主机默认没开这个功能。

2. 创建Node.js应用实例

  • 打开「Setup Node.js App」,点击Create Application按钮
  • 填写这些关键信息:
    • Node.js version:选你项目用的版本,建议选LTS版(比如18.x、20.x),兼容性最稳
    • Application mode:开发测试选Development,正式上线一定要选Production
    • Application root:填你要放项目的文件夹路径,比如public_html/my-node-app(要和后面绑定的域名路径对应上)
    • Application URL:选你要绑定的域名/子域名,比如myapp.yourdomain.com
    • Application startup file:填你的项目入口文件,比如server.js或者app.js(就是你本地用node xxx.js启动的那个文件)
  • 填完点Create,cPanel会自动帮你配置好基础运行环境,还会生成初始的package.json和启动脚本。

3. 上传你的项目文件

别直接上传本地的node_modules文件夹!这是踩过的坑,cPanel会自动帮你装依赖,只需要上传这些文件:

  • 用cPanel的File Manager:进入刚才设置的Application root路径,把本地项目的源码(server.js/app.jspackage.jsonpackage-lock.json,还有静态文件、路由文件这些)全部上传进去
  • 用Git更方便:如果项目在Git仓库,打开cPanel的Git Version Control,创建仓库后把代码拉取到对应的Application root路径即可

4. 安装项目依赖

回到「Setup Node.js App」页面,找到你刚创建的应用,点击Run NPM Install按钮——cPanel会自动读取package.json里的依赖,帮你安装所有需要的包。
如果你的项目需要构建(比如React/Vue前端项目),点击Run Script,输入脚本名称(比如build)就能执行自定义脚本。

5. 调整代码里的端口配置

注意!cPanel的Node.js应用是通过反向代理运行的,不需要你硬编码端口(比如3000),必须改成读取环境变量的端口:

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

因为cPanel会自动设置PORT环境变量,硬编码端口会导致服务启动失败。

6. 启动和管理你的Node服务

  • 在「Setup Node.js App」页面,找到你的应用,点击Start就能启动服务
  • 修改代码后,一定要点击Restart重启应用,不然新代码不会生效
  • 遇到问题的话,点击Logs查看运行日志,大部分错误都能在这里找到原因

7. 可选的额外配置

  • HTTPS配置:如果需要用HTTPS,先在cPanel的Let's Encrypt里给域名申请免费SSL证书,Node应用会自动适配HTTPS,不需要改代码
  • 静态文件处理:如果用Express框架,直接用express.static('public')托管静态文件夹即可;cPanel的反向代理也会自动处理静态资源的请求

内容的提问来源于stack exchange,提问作者Muhammad Junaid Aziz

火山引擎 最新活动