Nest-Admin 项目部署指南：从本地开发到服务器上线

部署方式概述

Nest-Admin 作为一个基于 NestJS 的后台管理系统，提供了多种灵活的部署方案。开发者可以根据实际需求选择最适合的部署方式，主要包括传统部署和容器化部署两种主流方案。

传统部署方案

环境准备

在传统部署方式下，需要确保服务器已安装以下基础服务：

1. MySQL 数据库服务（5.7+版本）
2. Redis 缓存服务
3. Node.js 运行环境（建议16.x或18.x LTS版本）

配置调整

部署前需修改项目中的生产环境配置文件.env.production，主要配置项包括：

• 数据库连接参数（主机地址、端口、用户名、密码等）
• Redis连接参数
• JWT密钥等安全配置
• 其他业务相关参数

构建与启动

1. 执行构建命令：pnpm build，该命令会编译TypeScript代码并生成可运行的JavaScript文件
2. 测试运行：pnpm start:prod，验证应用是否能正常启动
3. 使用PM2进行进程管理：
   • 全局安装PM2：npm install -g pm2
   • 通过PM2启动应用：pnpm prod:pm2
   • 常用PM2命令：
     • pm2 list 查看运行中的进程
     • pm2 logs 查看日志
     • pm2 restart 重启应用

容器化部署方案

对于偏好使用Docker的团队，项目提供了docker-compose方案：

准备工作

1. 服务器安装Docker和Docker Compose
2. 准备docker-compose.yml文件，配置好各服务参数

部署步骤

1. 构建Docker镜像
2. 通过docker-compose up命令启动所有服务
3. 配置持久化存储（数据库数据卷等）

CI/CD自动化部署

对于需要持续集成的团队，可以配置自动化部署流程：

基于SSH的自动化

1. 在CI/CD平台配置服务器SSH访问权限
2. 编写部署脚本，通常包括：
   • 拉取最新代码
   • 安装依赖
   • 构建应用
   • 重启服务

容器化CI/CD

1. 在CI流程中构建Docker镜像
2. 推送镜像到私有仓库
3. 在服务器上拉取最新镜像并重新部署

部署方案选择建议

1. 小型项目或个人使用：推荐传统PM2方案，简单直接
2. 团队协作或生产环境：建议使用Docker方案，保证环境一致性
3. 需要频繁更新的项目：配置完整的CI/CD流水线

常见问题处理

部署过程中可能会遇到以下问题：

• 端口冲突：检查应用端口是否被占用
• 数据库连接失败：验证数据库配置和网络连通性
• 内存不足：Node应用可能需要调整内存限制
• 文件权限问题：确保应用有必要的文件系统权限

通过以上部署方案，开发者可以灵活地将Nest-Admin项目部署到各种环境，满足不同场景下的运维需求。