讲师中心 微信公众号
AI工具推荐 视频效率加速

Linux系统快速搭建Node.js运行环境【教程】

千丽同学_6699

千丽同学_6699

发布时间:2026-05-07 10:05:19

|

897人浏览过

|

来源于php中文网

原创

Ubuntu 22.04 默认 apt 安装的 Node.js 版本过旧(v12),易导致 ESM 错误、require 报错或 npm install 卡死;推荐生产环境用 NodeSource 安装 LTS 版本,开发环境用 nvm 管理多版本,或手动解压二进制包实现隔离部署。

linux系统快速搭建node.js运行环境【教程】

直接用 apt 或 yum 装出来的 nodejs 版本太旧(Ubuntu 22.04 默认是 v12,CentOS 7 是 v10),跑现代项目大概率报错:比如 ERR_UNSUPPORTED_ESM_URL_SCHEME、require is not defined,或者 npm install 卡死在 prebuild-install。别硬扛,换方式。

用 NodeSource 安装 LTS 版本(推荐生产环境)

NodeSource 提供官方维护的二进制包,版本可控、更新及时、无编译依赖,适合服务器长期运行。

  • Ubuntu/Debian 执行:curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -,再 sudo apt install -y nodejs
  • RHEL/CentOS/Fedora 执行:curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -,再 sudo yum install -y nodejs(CentOS 8+ 用 dnf)
  • 装完立刻验证:node -v 应输出类似 v20.12.2,npm -v ≥ 10.2.2;低于这个 npm 版本可能无法安装带 peerDependenciesMeta 的包
  • 注意:NodeSource 不会覆盖系统自带的 node 命令冲突——它安装的是 /usr/bin/node,和 apt 冲突时优先级由 update-alternatives 管理,但一般不会打架

用 nvm 管理多版本(开发机首选)

如果你要同时跑多个项目,有的用 node@18,有的必须 node@20,或需要快速验证兼容性,nvm 是唯一靠谱方案。

chartjs-reporter
chartjs-reporter

此技能用于在用户需要将结构化数据(查询结果、CSV 摘要、JSON 记录或 Python 字典/列表)转换为独立的 HTML 页面时使用。

下载
  • 安装命令固定:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash,然后 source ~/.bashrc(zsh 用户用 ~/.zshrc)
  • 查可用 LTS:nvm list-remote --lts,装最新 LTS:nvm install --lts;装指定版:nvm install 20.12.2
  • nvm use 20.12.2 切换当前 shell 的 Node 版本;nvm alias default 20.12.2 设为默认,新终端自动生效
  • 坑点:nvm 安装的 node 和 npm 是用户级路径(~/.nvm/versions/...),不写入 /usr/bin,所以不能被 systemd 服务直接调用——部署服务时得用绝对路径,比如 /home/deploy/.nvm/versions/node/v20.12.2/bin/node app.js

手动解压二进制包(无 root 权限 / 隔离部署)

当你没有 sudo,或想把 Node 环境和系统彻底隔离(比如 CI 构建机、容器外挂载),就下载官方 .tar.xz 包解压即用。

  • 下载命令示例:wget https://nodejs.org/dist/v20.12.2/node-v20.12.2-linux-x64.tar.xz
  • 解压必须用 tar -xf(不是 tar -xzf):tar -xf node-v20.12.2-linux-x64.tar.xz -C /opt
  • 设全局命令有两种方式:
    → 软链接:sudo ln -s /opt/node-v20.12.2-linux-x64/bin/node /usr/local/bin/node(同理链 npm)
    → 改 PATH:export PATH="/opt/node-v20.12.2-linux-x64/bin:$PATH",加到 ~/.bashrc 或服务脚本里
  • 注意:.tar.xz 包里 bin/ 下只有 node 和 npm,没有 npx ——但 npm@8+ 自带 npx,只要 npm 能跑,npx 就能用

真正容易被忽略的点是:无论哪种方式,npm config get prefix 的输出决定了全局模块(如 pm2、nodemon)装在哪。如果没配好权限或路径,npm install -g 会静默失败或写入用户目录导致其他用户调用不到。动手前先确认这个值是否合理,比反复重装 Node 重要得多。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

10749

2023.09.19

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

434

2025.11.26

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

761

2026.02.10

JavaScript Node.js流处理与高效数据管道构建实践
JavaScript Node.js流处理与高效数据管道构建实践

本专题聚焦 Node.js 在大规模数据处理场景中的应用,系统讲解 Stream 流机制、背压控制、管道(Pipe)处理以及文件与网络数据流的高效传输方式。内容包括可读流、可写流、双工流与转换流的实现原理,并结合实际案例构建高性能数据处理管道,帮助开发者提升数据处理效率与系统吞吐能力。

324

2026.04.07

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

598

2026.06.16

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

4110

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3493

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2693

2023.06.30

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

60

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn