Node.js项目在Debian上如何部署

5月 4th, 2025

在Debian上部署Node.js项目通常涉及以下几个步骤：

安装Node.js和npm：
首先，你需要在你的Debian系统上安装Node.js和npm。你可以使用NodeSource的二进制分发库来安装特定版本的Node.js。
```
# 导入NodeSource库的GPG密钥
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -

# 安装Node.js和npm
sudo apt-get install -y nodejs
```
这里以安装Node.js 16.x版本为例，你可以根据需要更改版本号。
上传项目文件：
将你的Node.js项目文件上传到Debian服务器。你可以使用SCP、SFTP或其他文件传输方法。
安装项目依赖：
在项目目录中，运行以下命令来安装项目的依赖包。
```
npm install
```
配置环境变量（可选）：
如果你的应用需要特定的环境变量，比如数据库连接字符串或API密钥，你应该在服务器上设置这些变量。你可以在~/.bashrc、~/.profile或.env文件中设置它们。
启动应用：
使用npm脚本来启动你的应用。在你的package.json文件中，确保有一个start脚本。
```
"scripts": {
  "start": "node app.js"
}
```
然后运行以下命令来启动你的应用：
```
npm start
```
使用进程管理器（推荐）：
为了确保你的Node.js应用在后台稳定运行，并且在出现故障时能够自动重启，建议使用进程管理器，如PM2。

安装PM2：
```
sudo npm install pm2 -g
```
使用PM2启动你的应用：
```
pm2 start app.js --name "my-app"
```
PM2提供了许多有用的功能，比如日志管理、性能监控和负载均衡。

配置Nginx反向代理（可选）：
如果你希望通过HTTP/HTTPS访问你的Node.js应用，你可能需要配置一个Web服务器，如Nginx，作为反向代理。

安装Nginx：

sudo apt-get install nginx

配置Nginx以代理到你的Node.js应用。编辑Nginx配置文件（通常位于/etc/nginx/sites-available/default），并添加一个server块：

server {
    listen 80;
    server_name example.com; # 替换为你的域名或公网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;
    }
}