Debian上Node.js的部署流程是怎样的 - 问答

Debian上Node.js部署完整流程

1. 更新系统包

部署前需确保系统包为最新版本，避免依赖冲突：

sudo apt update && sudo apt upgrade -y

2. 安装Node.js与npm

Node.js的部署需先安装运行环境，推荐以下两种方式（根据需求选择）：

方式一：通过NodeSource仓库安装（推荐，支持自定义版本）
以安装Node.js 18.x（LTS版本）为例，执行以下命令添加NodeSource仓库并安装：
```
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
```
方式二：使用系统默认APT仓库安装（版本较旧）
若无需特定版本，可直接通过APT安装：
```
sudo apt install -y nodejs npm
```

验证安装：

node -v  # 查看Node.js版本（如v18.x.x）
npm -v   # 查看npm版本（如9.x.x）

3. 创建项目目录与初始化

创建项目目录：
选择一个存放项目的路径（如用户主目录下的my-node-app）：
```
mkdir ~/my-node-app && cd ~/my-node-app
```
初始化Node.js项目：
运行npm init -y生成package.json文件（包含项目元数据与依赖配置）：
```
npm init -y
```

4. 安装项目依赖

根据项目需求安装依赖包（以Express框架为例）：

npm install express --save  # --save参数将依赖写入package.json的dependencies

若需安装开发依赖（如nodemon），使用--save-dev：

npm install nodemon --save-dev

5. 配置进程管理（PM2）

为确保应用在后台持续运行、自动重启及监控状态，推荐使用PM2：

全局安装PM2：
```
sudo npm install pm2 -g
```
启动应用：
假设入口文件为app.js，执行以下命令启动：
```
pm2 start app.js --name "my-node-app"
```

常用PM2命令：

pm2 list          # 查看运行中的应用列表
pm2 logs          # 查看应用日志
pm2 save          # 保存当前进程列表（便于系统重启后恢复）
pm2 startup       # 设置PM2开机自启动（需根据提示执行后续命令）

6. 配置Nginx反向代理（可选但推荐）

Nginx可作为反向代理，处理HTTP请求转发、负载均衡及SSL卸载，提升应用性能与安全性：

安装Nginx：
```
sudo apt install -y nginx
```

配置反向代理：
编辑Nginx默认站点配置文件（或新建自定义配置）：

sudo nano /etc/nginx/sites-available/my-node-app

添加以下内容（将your_domain_or_ip替换为服务器域名或IP，3000替换为Node.js应用端口）：

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;
    }
}

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/my-node-app /etc/nginx/sites-enabled
sudo nginx -t  # 测试配置语法是否正确
sudo systemctl restart nginx

7. 配置防火墙

允许HTTP（80）与HTTPS（443）流量通过防火墙（若使用UFW）：

sudo ufw allow 'Nginx Full'  # 允许Nginx的全部流量（HTTP+HTTPS）
sudo ufw enable              # 启用防火墙（若未启用）

8. （可选）配置SSL证书

为应用启用HTTPS加密，推荐使用Let’s Encrypt免费证书：

安装Certbot：

sudo apt install -y certbot python3-certbot-nginx

获取并配置证书：
```
sudo certbot --nginx -d your_domain.com -d www.your_domain.com
```
按提示完成证书申请，Certbot会自动修改Nginx配置以支持HTTPS。

9. 部署验证

通过IP/域名访问：
在浏览器输入服务器IP或域名，若看到应用页面（如Express的“Hello World”），则部署成功。

查看PM2状态：

pm2 status  # 确认应用处于“online”状态

以上流程覆盖了Debian系统上Node.js从环境安装到生产部署的关键步骤，可根据实际需求调整（如切换Node.js版本、添加更多依赖或优化Nginx配置）。

0 赞

0 踩