如何在 Linux 上部署 JavaScript 应用

山海之间

发布时间：2026-08-22 | 92人浏览过

原创

前言

很多人第一次把 JavaScript 应用放到 Linux 服务器上时，最容易混淆的不是某条命令，而是整条上线链路：本地能跑、服务器能常驻、域名能访问、出了问题能排查，这几件事其实分属不同层面。本文按实际部署顺序把流程重新整理，从 Node.js 环境、项目初始化、PM2 托管到 Nginx 反向代理与上线维护逐段拆开，帮助你判断哪些是必做项，哪些是按需补充。

把 JavaScript 应用部署到 Linux，难点通常不在某一条命令，而在于流程容易碎：本地能跑，不代表上线后能稳定、可维护地跑。下面按“开发准备、服务启动、对外暴露、上线维护”四个环节重组一遍，保留原文里的关键命令和配置，让你能判断自己现在卡在哪一步，以及生产环境还缺哪些基础项。

准备运行环境与项目骨架

在 Linux 上部署 JavaScript 应用，首先要确认基础运行时已经就绪。对于 Node.js 应用来说，最少需要 nodejs 和 npm。

sudo apt update
sudo apt install nodejs npm

如果你还没创建项目目录，可以先新建一个工作目录并进入其中：

mkdir my-js-app
cd my-js-app

随后初始化 Node.js 项目，生成 package.json，让依赖和脚本有统一管理入口：

npm init -y

编辑器方面，原文提到 Visual Studio Code、Sublime Text、Atom，都可以使用。这一步不影响部署流程，但建议至少保证代码、配置文件和日志查看工具顺手可用。

安装依赖并完成应用代码

项目骨架准备好后，就可以安装实际需要的依赖。以 Web 应用为例，常见选择是 Express：

npm install express --sa ve

这条命令会把 Express 写入 package.json 的依赖列表。原文中的命令写法保留不变，实际使用时要注意参数是否符合你当前 npm 版本的习惯。

代码层面，最关键的是让应用明确监听一个端口，例如 3000，这样它才能接收 HTTP 请求。无论你写的是页面服务还是 API，至少都要确认以下两点：

应用需要监听固定端口

如果服务没有正常监听端口，后面的 PM2、Nginx 和监控都无从谈起。

应用需要能返回有效响应

无论是浏览器页面还是接口数据，本地跑通后再进入部署阶段，排错成本会低很多。

展示从环境准备到 PM2 托管的 Node.js 应用部署流程图，强调命令与关键检查点。 — **部署主线流程图**用流程图梳理从系统准备到 PM2 启动应用的主线步骤，适合首次部署时对照检查。

先做本地验证，再补生产环境配置

在把服务交给进程管理器之前，先直接用 Node.js 启动一次，确认应用本身没有明显错误：

node app.js

启动后，可以在浏览器访问 http://localhost:端口号，检查页面或接口是否按预期返回。

本地验证通过后，不要急着直接上线。进入生产环境前，应该先把敏感配置从代码里拿出来。

不要把连接串和密钥硬编码进源码

数据库连接字符串、密钥等内容如果直接写在代码中，后续维护和安全控制都会很被动。

用 .env 管理环境变量

原文推荐使用 .env 文件配合 dotenv 包加载环境变量。这种做法的好处是配置与代码分离，切换开发、测试、生产环境时更容易管理。

用 PM2 托管 Node.js 进程

当应用已经能在本地正常运行后，就可以把它放到服务器上长期运行。相比直接用 node app.js 前台启动，PM2 更适合生产环境，因为它能负责进程托管和重启。

先全局安装 PM2：

npm install pm2 -g

然后启动应用，并给进程命名：

pm2 start app.js --name "my-js-app"

PM2 的核心价值在于两点：一是能持续管理进程状态；二是服务器重启后，应用也更容易恢复运行。对于初次部署的 Node.js 服务，这一步基本可以视为生产环境的默认配置。

需要对外提供服务时，再配置反向代理

如果应用只在本机测试，直接监听端口即可；但如果要对外提供访问，通常会在前面加一层 Nginx 或 Apache，把外部请求转发到 Node.js 服务。

展示 Nginx 反向代理到 Node.js 服务的请求转发关系，以及上线后安全与监控关注点。 — **对外访问与运维结构图**这张图把“域名入口、Nginx 转发、Node.js 进程、安全与监控”放到同一视图中。

以 Nginx 为例，可以在配置中加入一个 location 块：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:端口号;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

这段配置的作用，是把发往 yourdomain.com 的请求转发到本机对应端口上的 Node.js 应用。原文也提到，Apache 可以通过 mod_proxy 实现类似效果。