debian nodejs如何配环境变量

debian

小樊

2026-09-29 11:25:42

栏目: 编程语言

在 Debian 上配置 Node.js 的环境变量，通常有两种常见场景：系统/用户级环境变量（如 PATH） 和 Node 应用运行所需的环境变量（如 PORT、NODE_ENV）。下面分别说明。

一、把 Node.js 加入 PATH（最常见）

1. 确认 node 安装位置

which node
# 常见路径
# /usr/bin/node
# /usr/local/bin/node
# ~/.nvm/versions/node/vxx/bin

如果 which node 为空，说明没进 PATH。

2. 配置用户级 PATH（推荐）

编辑当前用户环境变量：

nano ~/.bashrc

在末尾添加（示例）：

export PATH=$PATH:/usr/local/bin

或（nvm 示例）：

export PATH=$HOME/.nvm/versions/node/v20.11.0/bin:$PATH

生效：

source ~/.bashrc

3. 配置系统级 PATH（所有用户）

sudo nano /etc/profile

添加：

export PATH=$PATH:/usr/local/bin

或：

sudo nano /etc/environment

修改：

PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

二、给 Node.js 应用配置环境变量（如 NODE_ENV）

方式 1：临时环境变量（终端）

NODE_ENV=production PORT=3000 node app.js

方式 2：写入 shell 配置

nano ~/.bashrc

添加：

export NODE_ENV=production
export PORT=3000

source ~/.bashrc

方式 3：使用 .env 文件（推荐）

安装：

npm install dotenv

代码：

require('dotenv').config();
console.log(process.env.NODE_ENV);

.env 文件：

NODE_ENV=production
PORT=3000

三、使用 systemd 启动 Node（生产推荐）

编辑服务文件：

sudo nano /etc/systemd/system/node-app.service

示例：

[Unit]
Description=Node App
After=network.target

[Service]
User=www-data
WorkingDirectory=/var/www/app
ExecStart=/usr/bin/node app.js
Environment=NODE_ENV=production
Environment=PORT=3000

[Install]
WantedBy=multi-user.target

重载并启动：

sudo systemctl daemon-reload
sudo systemctl start node-app

四、验证

node -v
npm -v
echo $NODE_ENV

如果你是用 apt / nvm / 源码编译 安装的 Node，可以告诉我，我可以给你更精确的配置方式。