# 如何在 VPS 上部署 Node.js 应用？

> 6 个步骤在 VPS 上部署 Node.js 应用：通过 nvm 安装 Node 26 LTS，使用 systemd 服务或 pm2，并以 nginx 作为反向代理。

- URL: https://jadekvm.com/zh/guides/how-to-deploy-a-nodejs-app-on-a-vps/
- 最后更新: 2026-11-16
- 发布者: JadeKVM (https://jadekvm.com)

以下说明如何在运行 Debian 13 或 Ubuntu 24.04 的 VPS 上部署 Node.js 应用，包含重启策略并在前端放置 nginx。

**快速回答 — 如何在 VPS 上部署 Node.js 应用？**

要在 VPS 上部署 Node.js 应用，请创建一个应用用户，用 nvm 安装当前 LTS 版本 Node 26，将代码复制过去，将其作为 systemd 服务运行在 127.0.0.1:3000 上，然后在前端放置 nginx 作为带 HTTPS 的反向代理。**JadeKVM** 服务器在 KVM 内核上授予 root 权限，因此 pm2 也可以使用。

**简要概述**

- **应用无需 root**：以普通用户运行，并使用其自己的主目录。
- **Node 26 LTS**：nodejs.org 于 2026 年 11 月 16 日将其列为最新 LTS。
- **systemd 或 pm2**：两者都能在应用崩溃后重启，并在开机时启动。
- **前端放置 nginx**：应用监听 127.0.0.1；nginx 负责 80 和 443 端口。

## 6 个步骤在 VPS 上部署 Node.js 应用？

示例应用监听 3000 端口，通过 node server.js 启动。

1. **创建应用用户** — 运行 sudo adduser --disabled-password app，并用 sudo -iu app 切换到该用户。
2. **安装 Node.js** — 安装 nvm，然后运行 nvm install --lts。记下 which node 打印出的路径。
3. **复制代码** — 克隆仓库或用 rsync 上传，然后运行 npm ci --omit=dev。
4. **创建服务** — 编写一个 systemd 单元文件，使用该 node 路径、Restart=on-failure 以及应用用户。
5. **添加 nginx** — 将 example.com 代理到 http://127.0.0.1:3000，然后重新加载 nginx。
6. **添加 HTTPS** — 为 nginx 运行 certbot，使代理提供 TLS。

## Node.js 应用用 systemd 还是 pm2 更好？

*在 VPS 上让 Node.js 应用持续运行的两种方式，比较其设置、重启和日志*

| 比较项 | systemd 服务 | pm2 | 适合 |
| --- | --- | --- | --- |
| 安装 | 内置于 Debian 和 Ubuntu | npm install -g pm2 | systemd：无需额外安装 |
| 崩溃后重启 | Restart=on-failure | 自动 | 平手 |
| 开机启动 | systemctl enable | pm2 startup、pm2 save | 平手 |
| 日志 | journalctl -u app | pm2 logs | systemd：所有服务统一管理 |
| 集群模式 | 每个进程一个单元 | pm2 start -i max | 多核套餐上的 pm2 |

## 如何用 nvm 安装 Node.js 26 LTS？

**以应用用户身份安装 nvm，然后让它获取 LTS 版本。** 发行版软件包滞后：Ubuntu 24.04 的软件源中是 Node 18。nvm 将当前版本安装到用户的主目录中，无需 root。

此处使用的 nvm 版本为 v0.41.0，即 2026 年 11 月 16 日其 README 所示版本。运行前请在 README 中查看是否有更新的标签。

*nvm 与 Node LTS（以应用用户身份）*

```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
which node
```

## 如何将应用作为 systemd 服务运行？

**编写一个单元文件，指定用户、文件夹和完整的 node 路径，然后启用它。** 将 `which node` 打印的路径粘贴到 ExecStart 中。应用崩溃 5 秒后 systemd 会重启它，并在开机时启动。

将机密信息保存在仅 root 可读的环境文件中。日志写入 journal：`journalctl -u app -f` 可实时跟踪它们。

*/etc/systemd/system/app.service*

```ini
[Unit]
Description=Node.js app
After=network-online.target
Wants=network-online.target

[Service]
User=app
WorkingDirectory=/home/app/myapp
ExecStart=/home/app/.nvm/versions/node/v26.13.1/bin/node server.js
Environment=NODE_ENV=production PORT=3000 HOST=127.0.0.1
EnvironmentFile=-/etc/app.env
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
```

## 如何在 Node.js 应用前放置 nginx？

**一个简短的 server 块将请求转发到 127.0.0.1:3000，并保持 WebSocket 升级正常工作。** 先运行 `sudo systemctl daemon-reload` 和 `sudo systemctl enable --now app`。然后添加下面的块，并重新加载 nginx。

[如何在亚洲 VPS 上托管网站](https://jadekvm.com/zh/guides/how-to-host-a-website-on-an-asia-vps/ "How do you host a website on an Asia VPS?")] 一文解释了 sites-available。之后 Certbot 会添加 TLS，如 [如何安装免费 SSL 证书](https://jadekvm.com/zh/guides/how-to-install-a-free-ssl-certificate-on-a-vps/ "How do you install a free SSL certificate on a VPS?")] 所述。

*nginx 反向代理*

```nginx
server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## 亚洲哪个 VPS 城市最适合 Node.js API？

**将 API 放在其主要客户端附近。** JadeKVM 于 2026 年 11 月 16 日读取了 WonderNetwork 的公开 ping：东京距旧金山为 104 ms，香港为 162 ms；新加坡距孟买为 55 ms。JadeKVM 页面上的延迟数据是 WonderNetwork 于 2026 年 11 月 16 日在其自有服务器之间测得的公开平均值；它们说明各城市在网络上的距离，并不承诺任何一台 JadeKVM 服务器的表现。同时服务亚洲和美国西海岸的 API 通常适合东京；参见 [美国西海岸页面](https://jadekvm.com/zh/us-west-coast-to-asia-vps/ "Which Asian VPS city is closest to the US West Coast?")]。

Pendant 提供 1 shared vCPU, 3 GB RAM, 45 GB NVMe, 1 TB a month，足以满足大多数 API 的需要。

## 关于在 VPS 上部署 Node.js 的常见问题

### 2026 年我应部署哪个 Node.js 版本？

当前的 LTS 系列。2026 年 11 月 16 日，nodejs.org 将 Node 26 列为最新 LTS，24 和 22 仍在支持期内。

### 对 Node.js 而言，pm2 比 systemd 好吗？

pm2 增加了集群模式和友好的 CLI。systemd 无需额外工具。两者都能在应用崩溃后重启，并在重启后保持运行。

### Node.js 应用应当监听 80 端口吗？

不应该。让它保持在 127.0.0.1 上并使用高位端口，由 nginx 处理 80 和 443 端口。

### 如何部署更新？

拉取新代码，运行 npm ci，然后执行 sudo systemctl restart app。保留旧的发布文件夹，以便快速回滚。

### 应用能发送邮件吗？

可以，通过 465 或 587 端口的邮件服务商。JadeKVM 服务器的出站 25 端口是关闭的。

**结论**

- **普通用户、通过 nvm 安装的 Node LTS、systemd 单元以及前端的 nginx**，构成了稳健的 Node.js 部署方案。
- 如果你想在多核套餐（例如 Bangle）上使用集群模式，请选择 pm2。

## 来源

1. [下载 Node.js](https://nodejs.org/en/download) — OpenJS Foundation (read 2026-11-16)
2. [nvm，Node 版本管理器](https://github.com/nvm-sh/nvm) — nvm-sh (read 2026-11-16)
3. [systemd.service(5) 手册页](https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html) — freedesktop.org / systemd (read 2026-11-16)
4. [PM2 启动脚本](https://pm2.keymetrics.io/docs/usage/startup/) — PM2 (read 2026-11-16)
5. [ngx_http_proxy_module](https://nginx.org/en/docs/http/ngx_http_proxy_module.html) — nginx.org (read 2026-11-16)
6. [WonderNetwork：从东京的 ping](https://wondernetwork.com/pings/Tokyo) — WonderNetwork (read 2026-11-16)

**在东京部署你的 Node.js 应用** Pendant 提供 1 vCPU / 3 GB / 45 GB，12 个月期限 $4.50 每月。 [在东京订购 Pendant](https://jadekvm.com/app/checkout/?plan=pendant&term=12m&location=jp-tyo&from=how-to-deploy-a-nodejs-app-on-a-vps&lang=zh) · [查看所有套餐](https://jadekvm.com/zh/pricing/ "JadeKVM 服务器每月多少钱？")

---

JadeKVM: JadeKVM 在香港、东京和新加坡销售 Linux KVM VPS，支持加密货币支付，无需身份证件，并公布各城市到亚洲其他地区的实测延迟。5 款套餐内存从 1 GB 到 16 GB，三个城市价格相同；在 12 个月期限下，比 2026 年 11 月 16 日核对的一款可比的无 KYC 加密货币套餐至少低 25%。运营方为巴拿马的 DomaineGoat LLC。
