前后端分离项目部署全攻略：云服务器+宝塔面板实战指南

一、部署前准备

1.1 环境要求

• 云服务器：推荐CentOS 8或Ubuntu 20.04系统，内存≥2GB（开发环境），生产环境建议≥4GB。
• 宝塔面板：最新稳定版（7.x版本），提供可视化服务器管理界面。
• 前端技术栈：Vue 3（或Vue 2）+ Vue Router + Axios。
• 后端技术栈：Spring Boot 2.7.x（或3.x）+ Spring MVC + MyBatis（或JPA）。
• 依赖工具：Node.js 16+、Maven 3.8+、JDK 11/17、Nginx。

1.2 服务器配置建议

• 安全组规则：开放80（HTTP）、443（HTTPS）、8080（后端端口）、22（SSH）端口。
• 防火墙设置：若未使用云平台安全组，需通过firewalld或ufw放行必要端口。
• 域名准备：建议提前申请域名并完成ICP备案（国内服务器必需）。

二、宝塔面板安装与基础配置

2.1 宝塔面板安装

# CentOS系统
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh
# Ubuntu系统
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

安装完成后，记录面板地址及初始账号密码。

2.2 基础环境搭建

1. 软件商店安装：

   • Nginx 1.20+
   • MySQL 5.7/8.0（或MariaDB）
   • Redis 6.0+
   • Java项目环境（选择JDK 11/17）
   • Node.js版本管理器（可选）

2. 数据库配置：

   • 创建专用数据库用户（避免使用root）。
   • 导入Spring Boot项目所需的SQL脚本。
   • 配置远程访问权限（生产环境建议限制IP）。

三、后端部署（Spring Boot）

3.1 项目打包

<!-- Maven配置示例（pom.xml） -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <excludes>
                    <exclude>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                    </exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

执行打包命令：

mvn clean package -DskipTests

生成target/*.jar文件。

3.2 宝塔部署流程

1. 创建Java项目：

   • 在宝塔面板「软件商店」→「Java项目」中添加项目。
   • 上传JAR包，配置启动参数（如--server.port=8080）。
   • 设置内存限制（建议-Xms512m -Xmx1024m）。

2. 反向代理配置：

   • 进入Nginx设置，添加反向代理规则：

     location /api/ {
       proxy_pass http://127.0.0.1:8080/;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
     }

   • 配置SSL证书（Let’s Encrypt免费证书）。

3.3 常见问题处理

• 端口冲突：使用netstat -tulnp | grep 8080检查占用。
• 数据库连接失败：检查application.yml中的URL、用户名、密码。
• 跨域问题：在Spring Boot中添加@CrossOrigin注解或全局配置。

四、前端部署（Vue）

4.1 项目构建

1. 环境变量配置：

   • 创建.env.production文件：

     VUE_APP_API_BASE_URL=/api/

2. 生产包生成：

   npm install
   npm run build

   生成dist/目录。

4.2 宝塔部署流程

1. 网站配置：

   • 在宝塔面板「网站」中添加站点，根目录指向dist/。
   • 配置SSL证书，开启HTTPS强制跳转。

2. 路径重写规则：

   location / {
       try_files $uri $uri/ /index.html;
   }

3. 静态资源优化：

   • 开启Gzip压缩（宝塔「软件商店」→「Nginx」→「配置修改」）。
   • 配置CDN加速（如阿里云OSS）。

五、进阶优化与安全配置

5.1 性能优化

• 后端优化：
  • 启用G1垃圾回收器（-XX:+UseG1GC）。
  • 配置连接池（HikariCP最佳实践）。
• 前端优化：
  • 路由懒加载（() => import('./views/Home.vue')）。
  • 图片压缩（使用image-webpack-loader）。

5.2 安全加固

1. 服务器安全：

   • 禁用root远程登录，创建专用用户。
   • 定期更新系统补丁（yum update -y）。

2. 应用安全：

   • 启用Spring Security防护。
   • 配置Nginx防DDoS规则：

     limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;
     server {
       limit_req zone=one burst=5;
     }

六、监控与维护

6.1 宝塔监控工具

• 实时监控：查看CPU、内存、磁盘使用率。
• 计划任务：设置日志切割、备份脚本。
• 错误日志：通过tail -f /www/server/logs/nginx_error.log排查问题。

6.2 自动化部署方案

1. Git Hook集成：

   • 在宝塔中创建SSH密钥，配置GitHub/Gitee Webhook。
   • 编写部署脚本（示例）：

     #!/bin/bash
     cd /path/to/project
     git pull origin main
     mvn clean package
     systemctl restart java-project

2. Docker化部署（可选）：

   # 后端Dockerfile示例
   FROM openjdk:11-jre
   COPY target/*.jar app.jar
   ENTRYPOINT ["java","-jar","/app.jar"]

七、常见问题解决方案

问题类型	排查步骤
前端空白页	检查Nginx根目录配置、控制台404错误
后端502错误	查看Java项目日志、检查端口监听状态
跨域失败	确认Spring Boot的@CrossOrigin或全局CORS配置
数据库连接超时	检查网络权限、最大连接数设置

八、总结与建议

1. 开发环境建议：

   • 使用本地Docker Compose模拟生产环境。
   • 编写详细的README.md文档。

2. 生产环境建议：

   • 实施蓝绿部署或灰度发布策略。
   • 配置Prometheus+Grafana监控体系。

3. 成本优化：

   • 合理选择云服务器规格（按流量计费模式）。
   • 使用对象存储（如OSS）替代服务器磁盘存储。

通过本文的详细指导，开发者可以系统掌握前后端分离项目的云部署流程，结合宝塔面板的可视化操作，大幅降低部署门槛。实际项目中，建议先在测试环境验证所有配置，再逐步迁移到生产环境。