在Linux服务器上部署Node.js应用并输出hello world是很多开发者入门后端部署的基础操作,整个过程不需要复杂的配置,只需要按照步骤逐步操作就能完成。

准备工作
首先需要有一台可以远程登录的Linux服务器,常见的系统比如Ubuntu、CentOS都可以,确保你能通过SSH工具连接到服务器,并且有sudo权限可以安装软件。
安装Node.js环境
Linux系统默认可能没有安装Node.js,我们需要先完成环境安装,这里以Ubuntu系统为例,使用NodeSource源安装比较新的稳定版本。
步骤1:更新系统软件包
先执行更新命令,确保系统的软件包列表是最新的:
sudo apt update sudo apt upgrade -y
步骤2:安装Node.js
添加NodeSource的源,这里选择安装18.x的稳定版本,你也可以根据需求选择其他版本:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs
步骤3:验证安装结果
安装完成后,执行以下命令查看Node.js和npm的版本,确认安装成功:
node -v npm -v
如果正常输出版本号,说明Node.js环境已经安装完成。
创建hello world项目
接下来我们创建一个简单的Node.js应用,用来输出hello world。
步骤1:创建项目目录
在服务器上创建一个存放项目的目录,比如/home/nodejs_hello:
mkdir -p /home/nodejs_hello cd /home/nodejs_hello
步骤2:编写应用代码
创建app.js文件,写入以下代码:
// 引入http模块
const http = require('http');
// 创建服务器
const server = http.createServer((req, res) => {
// 设置响应头
res.writeHead(200, {'Content-Type': 'text/plain; charset=utf-8'});
// 输出hello world
res.end('hello world');
});
// 服务器监听3000端口
server.listen(3000, () => {
console.log('服务器运行在 http://127.0.0.1:3000');
});
步骤3:测试运行
执行以下命令启动应用:
node app.js
此时终端会输出服务器运行的提示,我们可以在服务器本地用curl命令测试访问:
curl http://127.0.0.1:3000
如果返回hello world,说明应用已经正常运行。
配置进程守护
上面的启动方式在终端关闭后进程就会停止,实际部署中我们需要用进程守护工具让应用持续运行,这里使用pm2作为示例。
步骤1:安装pm2
使用npm全局安装pm2:
sudo npm install -g pm2
步骤2:用pm2启动应用
在项目的目录下执行启动命令:
pm2 start app.js --name hello_node
步骤3:查看运行状态
执行以下命令查看pm2管理的进程状态:
pm2 list
如果看到hello_node的状态是online,说明应用已经在后台持续运行了。
常见问题解决
- 如果启动时报端口被占用,可以执行
lsof -i:3000查看占用端口的进程,然后kill掉对应进程再启动 - 如果是云服务器,需要到安全组规则里开放3000端口,才能从外部浏览器访问到应用
- 如果pm2启动后应用状态是errored,可以执行
pm2 logs hello_node查看错误日志排查问题
Node.jslinux部署hello_worldJavaScript修改时间:2026-06-15 17:21:28