Express 项目环境搭建 -- 19. 部署

开发完成后要把它跑在稳定环境里。这一篇覆盖进程管理、容器化、反向代理三块,目标是:进程崩溃能重启、多核能利用、静态资源与 TLS 交给更合适的层。

进程管理:PM2

直接用 node bin/www 跑,进程崩溃就没了,多核也只能用一个。PM2 提供守护、集群、日志和监控:

1
npm install -g pm2
1
2
3
pm2 start bin/www --name app
pm2 save
pm2 startup

用配置文件表达更清晰:

1
2
3
4
5
6
7
8
9
10
11
12
// ecosystem.config.js
module.exports = {
apps: [{
name: "app",
script: "bin/www",
instances: "max", // 按 CPU 核数起多个实例
exec_mode: "cluster",
env: {
NODE_ENV: "production"
}
}]
};
1
pm2 start ecosystem.config.js

日志默认写到 ~/.pm2/logs,pm2 logs 查看;pm2 monit 看资源占用。

容器化:Docker

容器把运行时、依赖、启动命令固化,环境差异更小:

1
2
3
4
5
6
7
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "bin/www"]

构建时用多阶段或 .dockerignore 排除 node_modules、.env,避免把本地依赖和密钥打进镜像。

反向代理:Nginx

应用只监听本机端口,由 Nginx 对外提供 HTTP/HTTPS、静态资源、负载均衡:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
server {
listen 80;
server_name example.com;

location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

location /public/ {
alias /var/www/app/public/;
}
}

静态资源由 Nginx 直接返回,不占用 Node 进程;TLS 证书也在 Nginx 终止,应用内部走明文即可(见第 18 篇的安全提醒)。

健康检查

给应用加一个轻量端点,供负载均衡或编排系统探活:

1
2
3
app.get("/healthz", function (req, res) {
res.status(200).send("ok");
});

部署清单

  • 环境变量在部署平台注入,不打进镜像(见第 14 篇)。
  • 数据库迁移在部署流程中执行(见第 11 篇的 npm 脚本)。
  • 日志输出到 stdout/stderr,交给平台的日志系统采集(见第 16 篇)。
  • 进程崩溃自动重启,多实例时用 cluster 或编排系统扩容。

参考链接

系列导航


Express 项目环境搭建 -- 19. 部署
https://bubao.github.io/posts/7a8b9c0d.html
作者
一念
发布于
2026年11月21日
许可协议