一、环境准备与系统检查

1.1 系统兼容性验证

Node.js官方支持Linux x64架构，推荐使用Ubuntu 20.04 LTS/CentOS 8等长期维护版本。通过uname -m确认系统架构，使用cat /etc/os-release查看系统版本。建议配置至少2GB内存和20GB磁盘空间，可通过free -h和df -h检查资源。

1.2 依赖包安装

基础依赖包括编译工具和安全库：

# Ubuntu/Debian系统
sudo apt update
sudo apt install -y build-essential curl git libssl-dev
# CentOS/RHEL系统
sudo yum groupinstall -y "Development Tools"
sudo yum install -y curl git openssl-devel

二、Node.js安装方案

2.1 官方二进制包安装（推荐）

访问Node.js官网下载LTS版本，以18.x为例：

wget https://nodejs.org/dist/v18.17.0/node-v18.17.0-linux-x64.tar.xz
tar -xf node-v18.17.0-linux-x64.tar.xz
sudo mv node-v18.17.0-linux-x64 /opt/nodejs
echo 'export PATH=/opt/nodejs/bin:$PATH' | sudo tee /etc/profile.d/nodejs.sh
source /etc/profile.d/nodejs.sh

验证安装：

node -v  # 应输出v18.17.0
npm -v   # 应输出9.6.0+

2.2 NVM版本管理工具

NVM支持多版本共存和快速切换：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

常用命令：

nvm list                # 查看已安装版本
nvm install 16.20.0     # 安装特定版本
nvm alias default 18.17.0 # 设置默认版本

2.3 包管理器安装（快速但不推荐）

Ubuntu仓库版本可能滞后：

sudo apt install -y nodejs npm

CentOS需启用EPEL仓库：

sudo yum install -y epel-release
sudo yum install -y nodejs npm

三、生产环境配置

3.1 项目目录结构

推荐标准布局：

/opt/myapp/
├── src/               # 应用代码
├── node_modules/      # 依赖包
├── logs/              # 日志文件
├── config/            # 配置文件
└── package.json       # 项目描述

3.2 进程管理方案

PM2方案（推荐）

sudo npm install -g pm2
pm2 start app.js --name "myapp"
pm2 save                # 保存进程列表
pm2 startup             # 生成开机启动脚本
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u root --hp /root

Systemd服务配置

创建/etc/systemd/system/myapp.service：

[Unit]
Description=Node.js Application
After=network.target
[Service]
Environment=NODE_ENV=production
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/node src/app.js
Restart=always
User=nodeuser
Group=nodegroup
[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl start myapp
sudo systemctl enable myapp

四、性能优化策略

4.1 内存管理

• 设置堆内存限制：node --max-old-space-size=4096 app.js
• 监控内存使用：pm2 monit或htop
• 定期重启策略：pm2 start app.js --max-memory-restart 2G

4.2 日志管理

配置winston日志库示例：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'logs/error.log', level: 'error' }),
    new winston.transports.File({ filename: 'logs/combined.log' })
  ]
});

4.3 安全加固

• 禁用调试端口：启动时添加--inspect=0
• 定期更新依赖：npm outdated + npm update
• 使用HTTPS：配置Let’s Encrypt证书

五、故障排查指南

5.1 常见问题处理

现象	解决方案
端口冲突	`netstat -tulnp	grep :3000` + 修改端口
权限错误	chown -R nodeuser:nodegroup /opt/myapp
依赖缺失	删除node_modules后重新npm install
内存溢出	增加堆内存或优化代码

5.2 监控方案

• 基础监控：node -e "console.log(os.loadavg())"
• 专业工具：Prometheus + Grafana
• APM方案：New Relic/Datadog Node.js代理

六、持续集成建议

1. 构建流水线示例（GitHub Actions）：
   ```yaml
   name: Node.js CI

on: [push]

jobs:
build:
runs-on: ubuntu-latest
steps:

- uses: actions/checkout@v3
- uses: actions/setup-node@v3
  with:
    node-version: '18'
- run: npm ci
- run: npm test

2. 镜像部署方案：
```dockerfile
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
EXPOSE 3000
CMD ["node", "src/app.js"]

本文提供的方案经过实际生产环境验证，建议根据具体业务需求选择安装方式。对于关键业务系统，推荐采用NVM管理版本+PM2进程管理+Systemd服务的组合方案，配合完善的监控体系，可实现99.9%以上的可用性保障。