You need to enable JavaScript to run this app. 在cPanel部署首个Node.js项目时运行JS脚本报错126问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

在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工具:

  • 修复可执行脚本权限
    1. 打开cPanel文件管理器,进入项目根目录 /home/manteia1/Area_SFTP
    2. 定位到 node_modules/.bin 目录,右键打开权限设置面板,将目录权限设为 755,勾选「应用到所有子目录、文件」选项,确保目录下所有可执行脚本均具备执行权限
    3. 单独核查 /node_modules/.bin/nodemon 文件的权限值与所有者,确认权限为755、所有者为当前cPanel账户,避免跨用户权限导致的拒绝访问
  • 修正启动命令与路径匹配问题
    1. 回到cPanel「Node.js应用」管理面板,找到Area_SFTP对应的项目配置
    2. 将原有启动脚本 nodemon app.js 替换为 node node_modules/nodemon/bin/nodemon.js app.js,绕开.bin目录的软链接权限校验问题
    3. 在项目环境配置中新增npm执行参数 --scripts-prepend-node-path=true,消除虚拟环境与全局node路径不匹配的警告
  • 启动验证
    1. 保存所有配置后,先点击面板的「停止应用」按钮,等待进程完全终止后,再点击「运行JS脚本」启动项目
    2. 查看实时输出日志,确认无权限拒绝、路径错误类提示

长期运行优化:项目验证可正常启动后,可将启动命令替换为 node app.js,避免nodemon常驻进程消耗额外服务器资源。

内容的提问来源于stack exchange,提问作者Fabio Brognara

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.05 06:24:02