Debian下Node.js项目如何管理

Debian下Node.js项目管理指南

一、基础环境准备：安装Node.js与npm

在Debian系统中，Node.js和npm（Node包管理器）是管理Node.js项目的核心工具。推荐通过NodeSource仓库安装最新稳定版本（避免系统自带版本过旧），步骤如下：

1. 更新系统包列表：sudo apt update
2. 安装NodeSource仓库脚本（以Node.js 18.x为例）：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
3. 安装Node.js及npm：sudo apt install -y nodejs
4. 验证安装：node -v（查看Node.js版本）、npm -v（查看npm版本）。
   若需管理多个Node.js版本（如同时使用16.x、18.x），可使用NVM（Node Version Manager）：

• 安装NVM：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash，随后运行source ~/.bashrc生效；
• 安装指定版本：nvm install 18.17.1；
• 切换版本：nvm use 18.17.1。

二、项目初始化与依赖管理

1. 初始化项目：
   在项目根目录下运行npm init -y，自动生成package.json文件（记录项目元数据、依赖及脚本）。若需手动配置（如项目名称、版本），可省略-y参数，按提示填写信息。

2. 依赖安装与版本控制：

   • 安装依赖：使用npm install <package-name> --save（生产依赖，自动添加到package.json的dependencies）或npm install <package-name> --save-dev（开发依赖，添加到devDependencies）；
   • 更新依赖：运行npm update更新所有过时依赖，或npm update <package-name>更新指定依赖；
   • 删除依赖：使用npm uninstall <package-name> --save（生产依赖）或npm uninstall <package-name> --save-dev（开发依赖）。
     为避免依赖版本冲突，建议将node_modules添加到.gitignore文件（排除版本控制），并通过package-lock.json（npm自动生成）锁定依赖版本。

三、进程管理与自动化

使用PM2（进程管理器）可实现Node.js应用的后台运行、自动重启、日志管理及负载均衡：

1. 全局安装PM2：sudo npm install -g pm2；
2. 启动应用：pm2 start app.js --name "my-node-app"（app.js为入口文件，--name指定应用名称）；
3. 常用命令：
   • 查看应用状态：pm2 status；
   • 查看实时日志：pm2 logs my-node-app；
   • 停止应用：pm2 stop my-node-app；
   • 重启应用：pm2 restart my-node-app；
   • 设置开机自启：pm2 startup（按提示执行命令），随后保存当前进程列表：pm2 save。

四、版本控制：Git配置与协作

使用Git进行版本控制，确保项目代码的可追溯性与团队协作：

1. 安装Git：sudo apt update && sudo apt install git；
2. 配置Git全局信息：git config --global user.name "Your Name"、git config --global user.email "your_email@example.com"；
3. 初始化本地仓库：git init（在项目根目录下运行）；
4. 添加文件到暂存区：git add .（添加所有文件）或git add <file>（添加指定文件）；
5. 提交更改：git commit -m "Initial commit"（-m后为提交信息）；
6. 关联远程仓库（如GitHub）：git remote add origin <repository-url>（<repository-url>为远程仓库地址）；
7. 推送代码：git push -u origin main（首次推送需设置上游分支）。
   建议创建.gitignore文件，排除node_modules/、logs/、*.env（环境变量文件）等无需版本控制的目录。

五、生产环境优化：Nginx反向代理与SSL

1. Nginx反向代理：
   安装Nginx：sudo apt install nginx；
   编辑配置文件（如/etc/nginx/sites-available/default），添加反向代理规则：

   server {
       listen 80;
       server_name your_domain_or_ip;
       location / {
           proxy_pass http://localhost:3000;  # 转发到Node.js应用端口
           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;
       }
   }
   

   测试配置有效性：sudo nginx -t，随后重载Nginx：sudo systemctl reload nginx。

2. SSL证书配置（HTTPS）：
   使用Let’s Encrypt免费获取SSL证书：

   • 安装Certbot：sudo apt install certbot python3-certbot-nginx；
   • 获取证书：sudo certbot --nginx -d yourdomain.com（替换为你的域名）；
   • 按提示完成配置，Certbot会自动修改Nginx配置以支持HTTPS。

六、部署流程总结

1. 在Debian服务器上安装Node.js（通过NodeSource或NVM）、npm、Git；
2. 克隆远程仓库到服务器：git clone <repository-url>；
3. 安装依赖：npm install（或yarn install，若使用Yarn）；
4. 配置PM2启动应用：pm2 start app.js --name "my-app"；
5. 配置Nginx反向代理及SSL；
6. 推送代码到远程仓库，通过PM2自动重启应用（或手动触发）。