如何自定义 Linux Node.js 配置文件

系统级环境配置（全局生效）

先说说最基础的一层。系统级配置，顾名思义，就是让 Node.js 在整个 Linux 环境里都能听你的调遣。它主要负责设定全局安装路径、环境变量（比如 NODE_ENV）这些，一次配置，全局受益，所有用户和项目都能用上。

操作起来无非三步：

第一步，编辑配置文件。 打开 Linux 的全局环境变量文件，像 /etc/profile 或者当前用户的 ~/.bashrc 都行。用 vi 或 nano 把下面的内容塞进去：

export NODE_HOME=/usr/local/node-v14.17.5-linux-x64  # 替换成你实际的 Node.js 解压路径
export PATH=$PATH:$NODE_HOME/bin                # 让系统能找到 node 命令
export NODE_PATH=$NODE_HOME/lib/node_modules    # Node.js 模块搜索路径，别漏了
export NODE_ENV=production                      # 默认环境，按需改成 development 或 test

一个小提示：NODE_HOME 的路径拿不准？用 which node 查一下就知道了。

第二步，让配置活起来。 文件保存后，得让系统马上认账：

source /etc/profile    # 全局生效
# 或者
source ~/.bashrc       # 只对当前用户生效

第三步，验个货。 跑几个命令确认一下：

echo $NODE_ENV    # 应该输出 production
node -v           # Node.js 版本号
npm -v            # npm 版本号

项目级配置管理（适配不同环境）

说完全局的，再说说项目级的。这才是实际开发中的大头——不同环境（开发、测试、生产）需要不同的参数，比如数据库地址、API 密钥。这时候，node-config 模块就是你的好帮手。

一套标准流程：

1. 装包。 在项目根目录下执行：

npm install --sa ve node-config

2. 建个配置文件夹。 在项目根目录下创建 config 目录，里面放这些文件：

• default.json：所有环境都通用的基础配置，比如应用名称。
• development.json：开发环境专属，比如本地数据库地址。
• production.json：生产环境专属，比如线上数据库地址。

结构长这样：

// default.json
{
  "app": { "name": "my-node-app" },
  "database": { "host": "localhost", "port": 3306 }
}

// production.json
{
  "database": {
    "host": "192.168.1.100",
    "port": 3306,
    "user": "prod_user",
    "password": "prod_password"
  }
}

3. 用环境变量来选档。 运行时通过 NODE_ENV 指定环境：

NODE_ENV=development node app.js   # 加载 development.json + default.json
NODE_ENV=production node app.js    # 加载 production.json + default.json

4. 代码里读配置。 在 Node.js 代码里引入 config 模块：

const config = require('config');
console.log(config.get('app.name'));        // 输出应用名称
console.log(config.get('database.host'));   // 自动根据环境切换

运行时内存限制配置

对于内存敏感的应用——比如大型 API 服务——你得管住 Node.js 的嘴，别让它吃太多内存。这里有几种办法：

方法一：启动时直接限制。 加个标志 --max-old-space-size，单位是 MB：

node --max-old-space-size=4096 app.js   # 限制到 4GB

方法二：通过环境变量统一设。 在启动脚本或系统环境变量里写上：

export NODE_OPTIONS="--max-old-space-size=4096"
node app.js

方法三：用 PM2 进程管理器。 如果你用 PM2 管理应用，在 ecosystem.config.js 里配：

module.exports = {
  apps: [{
    name: 'my-app',
    script: 'app.js',
    max_memory_restart: '4G'   // 内存超过 4GB 时自动重启
  }]
};

启动命令：pm2 start ecosystem.config.js。

注意事项

• 敏感信息保护： 数据库密码、API 密钥这些，千万别硬编码在配置文件里。建议通过环境变量传递（process.env.DB_PASSWORD），或者用 dotenv 模块加载 .env 文件。
• 版本控制策略： default.json 和配置示例文件（如 development.json.example）可以进 Git。但实际环境配置（比如 production.json）必须加到 .gitignore 里，防止敏感信息泄露。
• 配置优先级： node-config 的加载顺序是：命令行参数 > 环境变量 > 当前环境配置文件 > 默认配置文件。根据这个优先级来调整你的设置。

通过这几步，Linux 下 Node.js 的配置文件自定义就到手了，不同环境的需求也能灵活应对。