JS项目在Debian上如何管理

1. 安装Node.js与npm
在Debian上管理JS项目前，需先安装Node.js（运行环境）和npm（包管理器）。推荐通过NodeSource仓库安装最新稳定版（避免系统自带版本过旧）：

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -  # 替换为所需版本（如16.x、18.x）
sudo apt install -y nodejs

验证安装：node -v（查看Node.js版本）、npm -v（查看npm版本）。
若需管理多版本Node.js，可使用NVM（Node Version Manager）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 18  # 安装指定版本
nvm use 18      # 切换版本

2. 依赖管理（npm/Yarn）
JS项目的依赖（如Express、React）通过npm或Yarn管理。首先在项目根目录初始化package.json（记录依赖与脚本）：

npm init -y  # 快速生成默认配置（含name、version、scripts等）

• 安装依赖：
  生产依赖（如Express）：npm install express --save（自动添加到dependencies）；
  开发依赖（如ESLint）：npm install eslint --save-dev（自动添加到devDependencies）。
  Yarn等效命令：yarn add express（生产）、yarn add -D eslint（开发）。
• 更新依赖：
  使用npm update（根据package.json版本范围更新所有依赖）或npm update express（更新指定依赖）；Yarn用yarn upgrade。
• 移除依赖：
  npm uninstall express --save（从dependencies移除）；Yarn用yarn remove express。
• 锁定版本：
  运行npm ci（而非npm install）可根据package-lock.json精确安装依赖，确保团队环境一致。

3. 项目部署流程

• 上传代码：通过scp（命令行）或Git将本地项目推送至Debian服务器（如GitHub仓库）。
• 安装依赖：在服务器项目目录下运行npm install（或yarn install），自动下载package.json中定义的依赖。
• 进程管理：使用PM2（Node.js进程守护工具）保持应用在线（即使终端关闭）：

  sudo npm install pm2 -g  # 全局安装PM2
  pm2 start app.js --name "my-js-app"  # 启动应用（app.js为入口文件）
  pm2 save                 # 保存当前进程列表
  pm2 startup              # 设置开机自启动（需执行生成的命令）
  

• 反向代理（可选）：通过Nginx转发HTTP请求至Node.js应用（提升安全性与可扩展性）：

  sudo apt install nginx   # 安装Nginx
  sudo nano /etc/nginx/sites-available/default  # 编辑配置文件
  

  添加以下内容（替换yourdomain.com为域名/IP，3000为Node.js端口）：

  server {
      
      listen 80;
      
      server_name yourdomain.com;
  
      location / {
      
          proxy_pass http://localhost:3000;
      
          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;
  
      }
  
  }
      
  

  保存后重启Nginx：sudo systemctl reload nginx。

4. 环境与安全配置

• 环境变量：将敏感信息（如数据库密码、API密钥）存入.env文件（不要提交至Git），使用dotenv包加载：

  npm install dotenv --save  # 安装dotenv
  

  在项目入口文件（如app.js）顶部添加：require('dotenv').config()。
• HTTPS加密：通过Let’s Encrypt免费获取SSL证书（支持HTTP→HTTPS自动跳转）：

  sudo apt install certbot python3-certbot-nginx  # 安装Certbot（Nginx版）
  sudo certbot --nginx -d yourdomain.com  # 自动配置证书
  

  证书有效期为90天，后续会自动续期。

5. 版本控制与协作

• 初始化Git仓库：在项目根目录运行git init，创建.gitignore文件排除node_modules/（依赖目录）、.env（敏感信息）等：

  node_modules/
  .env
  dist/  # 构建产物（若有）
  

• 提交与推送：

  git add .                  # 添加所有文件
  git commit -m "Initial commit"  # 提交到本地仓库
  git remote add origin <
      repository-url>
        # 关联远程仓库（如GitHub）
  git push -u origin main    # 推送至远程分支
  

• CI/CD（可选）：通过GitHub Actions/GitLab CI实现自动化测试与部署（如代码推送至main分支时自动运行测试、部署至服务器）。

6. 日志与维护

• 查看应用日志：使用PM2查看实时日志：pm2 logs（显示所有应用日志）或pm2 logs my-js-app（显示指定应用日志）。
• 监控性能：通过PM2内置监控工具查看CPU、内存占用：pm2 monit。
• 备份与更新：定期备份项目文件（如/usr/src/app）与数据库，及时更新Node.js版本（通过NVM或NodeSource）及依赖（npm update），修复安全漏洞。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！