在cPanel部署首个Node.js项目时运行JS脚本报错126问题咨询
cPanel环境Node项目启动返回码126问题定位与解决
报错根本原因
- 核心触发错误为执行权限不足:shell 调用
/home/manteia1/Area_SFTP/node_modules/.bin/nodemon时,因目标文件未配置可执行权限被直接拦截。错误码126的标准定义就是「命令已找到,但无执行权限无法运行」。 - 伴随的 node 路径不匹配警告为次要诱因:cPanel 创建的 Node 虚拟环境指向的 node 二进制路径,与系统全局 npm 调用时使用的 node 路径不一致,会进一步放大权限校验的异常概率。
可落地解决步骤
所有操作均可直接在cPanel面板内完成,无需额外调用SSH工具:
- 修复可执行脚本权限
- 打开cPanel文件管理器,进入项目根目录
/home/manteia1/Area_SFTP - 定位到
node_modules/.bin目录,右键打开权限设置面板,将目录权限设为755,勾选「应用到所有子目录、文件」选项,确保目录下所有可执行脚本均具备执行权限 - 单独核查
/node_modules/.bin/nodemon文件的权限值与所有者,确认权限为755、所有者为当前cPanel账户,避免跨用户权限导致的拒绝访问
- 打开cPanel文件管理器,进入项目根目录
- 修正启动命令与路径匹配问题
- 回到cPanel「Node.js应用」管理面板,找到
Area_SFTP对应的项目配置 - 将原有启动脚本
nodemon app.js替换为node node_modules/nodemon/bin/nodemon.js app.js,绕开.bin目录的软链接权限校验问题 - 在项目环境配置中新增npm执行参数
--scripts-prepend-node-path=true,消除虚拟环境与全局node路径不匹配的警告
- 回到cPanel「Node.js应用」管理面板,找到
- 启动验证
- 保存所有配置后,先点击面板的「停止应用」按钮,等待进程完全终止后,再点击「运行JS脚本」启动项目
- 查看实时输出日志,确认无权限拒绝、路径错误类提示
长期运行优化:项目验证可正常启动后,可将启动命令替换为
node app.js,避免nodemon常驻进程消耗额外服务器资源。
内容的提问来源于stack exchange,提问作者Fabio Brognara
相关产品推荐
相关产品推荐

