前后端分离项目云上部署实战：腾讯云CVM云服务器Nginx反向代理+SpringBoot自动化发布完整代码

apphuang2026年07月01日 09:51:493

前言：为什么选择腾讯云CVM部署前后端分离项目

在当今的互联网开发体系中，前后端分离架构已经成为主流选择。前端负责UI交互与页面渲染，后端专注业务逻辑与数据接口，两者通过HTTP API进行通信。这种架构带来了开发效率的提升和团队协作的便利，但也对部署环境提出了更高的要求——前端静态资源需要高性能的Web服务器承载，后端API服务需要稳定可靠的运行环境，而两者之间的路由转发则需要一个灵活的反向代理层来统一调度。

腾讯云CVM（Cloud Virtual Machine）作为国内主流的云服务器产品，提供了弹性可扩展的计算资源、稳定的网络环境以及丰富的镜像市场，是部署前后端分离项目的理想选择。本文将从零开始，完整记录一个前后端分离项目在腾讯云CVM上的部署全过程，涵盖环境准备、Nginx反向代理配置、Spring Boot服务部署，以及通过Shell脚本和Jenkins流水线实现自动化发布的完整方案。所有代码均经过实战检验，可直接应用于生产环境。

需要先登录腾讯云控制台，点击：腾讯云控制台，还没有账号，点击：注册后再关联，已有账号点击：登录后再关联

一、云服务器环境准备

1.1 CVM实例选购与登录

在腾讯云控制台购买CVM实例时，建议选择以下配置作为起步方案：操作系统选择CentOS 7.9或Ubuntu 20.04 LTS，实例规格选用2核4GB内存，系统盘配置40GB以上SSD云硬盘，网络带宽按需选择（测试环境1Mbps即可，生产环境建议5Mbps起步）。地域选择上，优先考虑与目标用户群体最近的数据中心，以降低网络延迟。

实例创建完成后，通过SSH方式登录服务器。Linux环境下直接使用终端命令，Windows用户可通过Putty或Xshell等工具连接。登录命令格式如下：

ssh -i /path/to/your-private-key.pem root@your-server-ip

首次登录后，建议立即修改root密码并创建普通用户用于日常操作，以提升系统安全性。

1.2 基础环境安装

登录服务器后，首先更新系统软件包到最新版本，确保后续安装的依赖包均为稳定版本。CentOS系统使用yum包管理器，Ubuntu系统使用apt-get。以CentOS为例：

yum update -y
yum install -y wget curl git vim net-tools

这些基础工具在后续的软件下载、配置编辑和网络诊断中都会频繁使用。

1.3 安装JDK 11/17

Spring Boot 2.x系列推荐使用JDK 8或11，Spring Boot 3.x则要求JDK 17以上。本文以JDK 11为例进行安装。首先从Oracle官网或OpenJDK仓库下载安装包，这里推荐使用OpenJDK以避免潜在的商业授权问题：

yum install -y java-11-openjdk java-11-openjdk-devel

安装完成后，通过以下命令验证安装结果：

java -version

输出应显示openjdk version "11.0.x" 等信息。同时需要配置JAVA_HOME环境变量，编辑 /etc/profile 文件，在末尾添加：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
export PATH=$PATH:$JAVA_HOME/bin

执行 source /etc/profile 使配置生效。

1.4 安装MySQL数据库

多数前后端分离项目都需要数据库支持，MySQL是使用最为广泛的关系型数据库之一。在CentOS 7上安装MySQL 8.0的步骤如下：

wget https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
yum localinstall -y mysql80-community-release-el7-3.noarch.rpm
yum install -y mysql-community-server

安装完成后启动MySQL服务并设置开机自启：

systemctl start mysqld
systemctl enable mysqld

MySQL首次启动时会生成一个临时密码，通过以下命令查看：

grep 'temporary password' /var/log/mysqld.log

使用临时密码登录MySQL后，立即修改root密码并创建项目专用的数据库和用户：

ALTER USER 'root'@'localhost' IDENTIFIED BY 'YourStrongPassword123!';
CREATE DATABASE your_project_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'your_app_user'@'%' IDENTIFIED BY 'AppUserPassword123!';
GRANT ALL PRIVILEGES ON your_project_db.* TO 'your_app_user'@'%';
FLUSH PRIVILEGES;

出于安全考虑，生产环境中不建议开放root用户的远程访问权限，应使用专用应用程序账号并限定可访问的IP范围。

二、Nginx安装与反向代理配置

2.1 Nginx安装

Nginx是一款轻量级、高性能的HTTP和反向代理服务器，在前后端分离部署中承担着至关重要的角色——它既要作为Web服务器托管前端静态资源，又要作为反向代理将API请求转发给后端Spring Boot服务。在CentOS上安装Nginx推荐使用官方源以获取最新稳定版本：

yum install -y epel-release
yum install -y nginx

安装完成后启动Nginx并设置开机自启：

systemctl start nginx
systemctl enable nginx

此时在浏览器中访问服务器公网IP，如果看到Nginx的欢迎页面，说明安装成功。

2.2 理解反向代理的核心价值

在前后端分离架构中，前端通常运行在浏览器端，通过AJAX或Fetch API向后端发起请求。如果前端直接请求后端服务的IP和端口（如 http://backend-ip:8080/api/user ），会面临跨域问题（CORS），同时后端服务的真实地址暴露在外网也存在安全隐患。Nginx反向代理的核心作用在于：

统一入口：所有请求都通过Nginx的80或443端口进入，前端访问的是同一个域名下的不同路径
跨域解决：由于前端资源和后端API处于同一域名下（或同源策略允许的范围内），跨域问题自然消失
负载均衡：当后端有多个实例时，Nginx可以按策略分发请求
SSL终结：Nginx可以统一处理HTTPS证书，后端服务只需运行HTTP即可

2.3 配置Nginx反向代理

Nginx的主配置文件位于 /etc/nginx/nginx.conf ，但更推荐在 /etc/nginx/conf.d/ 目录下为每个项目创建独立的配置文件，便于管理和维护。创建一个名为 your-project.conf 的配置文件：

server {
    listen 80;
    server_name your-domain.com;

    # 前端静态资源根目录
    root /var/www/your-project/dist;
    index index.html;

    # 处理前端路由（Vue Router/React Router的history模式）
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 反向代理后端API请求
    location /api/ {
        proxy_pass http://127.0.0.1:8080/api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 静态资源缓存优化
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

配置完成后，通过以下命令检查配置文件语法是否正确：

nginx -t

如果显示 syntax is ok 和 test is successful，则重新加载Nginx使配置生效：

systemctl reload nginx

需要注意的是，如果使用HTTPS协议，还需要在配置中添加SSL证书相关配置，监听443端口并指定证书文件路径。

2.4 Nginx日志与调试

Nginx的访问日志和错误日志是排查问题的重要工具。默认情况下，访问日志位于 /var/log/nginx/access.log ，错误日志位于 /var/log/nginx/error.log 。在部署过程中，如果遇到404或502等错误，首先查看错误日志往往能快速定位问题。可以通过以下命令实时监控日志：

tail -f /var/log/nginx/access.log
 tail -f /var/log/nginx/error.log

在配置反向代理时，常见的错误包括 proxy_pass 地址写错、后端服务未启动、防火墙未开放端口等，这些都可以通过日志分析快速排查。

三、Spring Boot项目打包与部署

3.1 项目打包配置

在Spring Boot项目的 pom.xml 中，需要确保打包方式为 jar，并使用 spring-boot-maven-plugin 插件生成可执行JAR包。一个标准的打包配置如下：

<packaging>jar</packaging>

<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 文件，文件名通常为 artifactId-version.jar 。

3.2 将JAR包上传至服务器

有多种方式可以将本地JAR包上传到腾讯云CVM服务器：

scp命令： scp -i your-key.pem target/your-app.jar root@your-server-ip:/opt/apps/
rsync：支持断点续传，适合大文件
FTP/SFTP：通过FileZilla等图形化工具上传
CI/CD流水线：通过Jenkins或GitLab CI自动构建并推送

建议在服务器上创建统一的应用程序目录，如 /opt/apps/ 或 /home/your-app/ ，便于集中管理。

3.3 启动Spring Boot服务

Spring Boot的JAR包内置了Tomcat或Undertow等嵌入式Web容器，可以直接通过 java -jar 命令启动：

java -jar /opt/apps/your-app.jar

但这种启动方式在前台运行，一旦SSH会话断开，服务就会停止。实际生产环境中，需要让服务在后台持续运行。常用的方案有以下几种：

nohup： nohup java -jar your-app.jar > app.log 2>&1 &
systemd服务：将Spring Boot应用注册为系统服务，支持开机自启和自动重启
Supervisor：进程管理工具，提供Web界面和丰富的配置选项

3.4 注册为systemd系统服务

将Spring Boot应用注册为systemd服务是生产环境推荐的方案。在 /etc/systemd/system/ 目录下创建 your-app.service 文件：

[Unit]
Description=Your Spring Boot Application
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/apps
ExecStart=/usr/bin/java -jar /opt/apps/your-app.jar
ExecStop=/bin/kill -15 $MAINPID
Restart=on-failure
RestartSec=30

[Install]
WantedBy=multi-user.target

保存文件后，执行以下命令使服务生效：

systemctl daemon-reload
systemctl start your-app
systemctl enable your-app

通过 systemctl status your-app 可以查看服务的运行状态。这种方式的优势在于：服务异常退出时systemd会自动重启，服务器重启后服务也会自动启动，大大提高了服务的可用性。

3.5 多环境配置管理

在实际项目中，通常需要区分开发、测试、生产等多个环境。Spring Boot支持通过 application-{profile}.yml 的方式来管理不同环境的配置。在启动时通过 --spring.profiles.active 参数指定当前环境：

java -jar your-app.jar --spring.profiles.active=prod

对于数据库密码、API密钥等敏感信息，不建议硬编码在配置文件中，而是通过环境变量或外部配置中心（如Spring Cloud Config、Apollo）来管理。在systemd服务文件中，可以通过 Environment 指令注入环境变量：

[Service]
Environment="DB_PASSWORD=YourSecurePassword"
ExecStart=/usr/bin/java -jar /opt/apps/your-app.jar --spring.profiles.active=prod

四、自动化发布方案

手动上传JAR包并重启服务的部署方式在项目初期尚可接受，但随着迭代频率的提高，手工操作的低效和易错性会逐渐成为瓶颈。自动化发布是提升研发效能的关键环节。本节将介绍两种实用的自动化发布方案：轻量级的Shell脚本方案和企业级的Jenkins流水线方案。

4.1 方案一：Shell脚本自动化部署

对于中小型项目或初创团队，编写一个Shell脚本来完成代码拉取、构建、部署和重启的全流程，是一种成本低、见效快的自动化方案。以下是一个完整的部署脚本示例：

#!/bin/bash
# deploy.sh - Spring Boot应用自动化部署脚本

set -e

# 配置区域
APP_NAME="your-app"
APP_PORT=8080
GIT_REPO="git@github.com:your-org/your-repo.git"
BRANCH="main"
WORK_DIR="/opt/deploy/$APP_NAME"
JAR_DIR="/opt/apps"
LOG_DIR="/var/log/$APP_NAME"

# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
NC='\033[0m'

echo -e "${GREEN}开始部署 $APP_NAME ...${NC}"

# 1. 创建必要目录
mkdir -p $WORK_DIR $JAR_DIR $LOG_DIR

# 2. 克隆或拉取代码
if [ -d "$WORK_DIR/.git" ]; then
    cd $WORK_DIR
    git fetch origin
    git reset --hard origin/$BRANCH
else
    git clone -b $BRANCH $GIT_REPO $WORK_DIR
    cd $WORK_DIR
fi

# 3. Maven构建
echo -e "${GREEN}执行Maven构建...${NC}"
mvn clean package -DskipTests

# 4. 停止旧服务
if systemctl is-active --quiet $APP_NAME; then
    echo -e "${GREEN}停止旧服务...${NC}"
    systemctl stop $APP_NAME
fi

# 5. 备份旧JAR并部署新JAR
JAR_FILE=$(ls -t $WORK_DIR/target/*.jar | head -1)
if [ -f "$JAR_DIR/$APP_NAME.jar" ]; then
    mv $JAR_DIR/$APP_NAME.jar $JAR_DIR/$APP_NAME.jar.$(date +%Y%m%d%H%M%S)
fi
cp $JAR_FILE $JAR_DIR/$APP_NAME.jar

# 6. 启动服务
echo -e "${GREEN}启动服务...${NC}"
systemctl start $APP_NAME

# 7. 健康检查
sleep 5
if systemctl is-active --quiet $APP_NAME; then
    echo -e "${GREEN}部署成功！${NC}"
    systemctl status $APP_NAME --no-pager
else
    echo -e "${RED}部署失败，请检查日志${NC}"
    journalctl -u $APP_NAME -n 50 --no-pager
    exit 1
fi

将此脚本保存到服务器上，并赋予执行权限：

chmod +x deploy.sh

每次需要发布新版本时，只需执行 ./deploy.sh 即可完成从代码拉取到服务重启的全流程。如果需要回滚，可以手动将备份的JAR包恢复并重启服务。

4.2 方案二：Jenkins Pipeline流水线

对于需要更精细的构建流程控制、多人协作的团队，Jenkins是更为专业的CI/CD工具。Jenkins Pipeline允许将构建、测试、部署的整个过程定义为代码（Pipeline as Code），存储在项目的Jenkinsfile中。以下是一个完整的声明式Pipeline示例：

pipeline {
    agent any

    environment {
        APP_NAME = 'your-app'
        DEPLOY_HOST = 'your-server-ip'
        DEPLOY_USER = 'root'
        DEPLOY_PATH = '/opt/apps'
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scmGit(branches: [[name: 'main']], userRemoteConfigs: [[url: 'git@github.com:your-org/your-repo.git']])
            }
        }

        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
            }
        }

        stage('Unit Test') {
            steps {
                sh 'mvn test'
            }
            post {
                always {
                    junit 'target/surefire-reports/*.xml'
                }
            }
        }

        stage('Deploy') {
            steps {
                script {
                    def jarFile = sh(script: "ls -t target/*.jar | head -1", returnStdout: true).trim()
                    sh """
                        scp -o StrictHostKeyChecking=no $jarFile $DEPLOY_USER@$DEPLOY_HOST:$DEPLOY_PATH/$APP_NAME.jar
                        ssh $DEPLOY_USER@$DEPLOY_HOST "systemctl restart $APP_NAME"
                    """
                }
            }
        }

        stage('Health Check') {
            steps {
                sh """
                    sleep 10
                    curl -f http://$DEPLOY_HOST:8080/actuator/health || exit 1
                """
            }
        }
    }

    post {
        success {
            emailext (
                subject: "✅ 部署成功: $APP_NAME",
                body: "项目 $APP_NAME 已成功部署到 $DEPLOY_HOST",
                to: 'team@your-company.com'
            )
        }
        failure {
            emailext (
                subject: "❌ 部署失败: $APP_NAME",
                body: "项目 $APP_NAME 部署失败，请检查构建日志",
                to: 'team@your-company.com'
            )
        }
    }
}

此Pipeline包含了代码检出、Maven构建、单元测试、部署到服务器、健康检查以及部署结果通知等完整环节。配合Jenkins的Webhook功能，可以实现代码推送后自动触发构建部署，真正实现持续交付。

4.3 两种方案的对比与选择

Shell脚本方案的优势在于轻量、无额外依赖、易于理解和修改，适合小型项目或单机部署场景。Jenkins Pipeline方案的优势在于可视化的构建历史、丰富的插件生态、强大的权限管理和分布式构建能力，适合中大型团队和多环境部署场景。实际选择时，可以根据团队规模、项目复杂度和现有基础设施来决定。

五、前后端联调与常见问题排查

5.1 联调验证步骤

完成上述所有部署步骤后，需要进行完整的联调验证，确保前后端能够正常通信。验证流程如下：

在浏览器中访问前端页面（如 http://your-domain.com ），确认页面能够正常加载
打开浏览器开发者工具的Network面板，观察前端发起的API请求
确认API请求的URL为 /api/xxx 格式，且状态码为200
检查API返回的数据结构是否与前端预期一致
测试完整的业务流程，如登录、数据查询、表单提交等

5.2 常见问题及解决方案

问题1：前端页面加载正常，但API请求返回404

这种情况通常是因为Nginx的 proxy_pass 配置有误。检查 location /api/ 块中的 proxy_pass 地址是否正确，特别注意URL末尾的斜杠—— proxy_pass http://127.0.0.1:8080/api/ 和 proxy_pass http://127.0.0.1:8080/api 的转发行为是不同的。前者会将 /api/user 转发为 /api/user ，后者会转发为 /api/user （注意去掉了/api前缀）。

问题2：API请求返回502 Bad Gateway

502错误表示Nginx无法连接到后端服务。可能的原因包括：Spring Boot服务未启动、服务端口与Nginx配置的端口不一致、防火墙阻止了端口访问、服务绑定了127.0.0.1而Nginx尝试连接0.0.0.0等。首先通过 systemctl status your-app 确认服务是否正常运行，然后通过 curl http://127.0.0.1:8080/actuator/health 测试服务是否可访问。

问题3：跨域问题仍然存在

虽然通过Nginx反向代理可以解决同源策略问题，但如果前端直接请求了后端服务的IP和端口（绕过Nginx），跨域问题依然会出现。确保前端代码中的所有API请求都使用相对路径或指向Nginx的域名，而不是直接指向后端服务地址。

问题4：静态资源加载缓慢

前端静态资源（JS、CSS、图片等）如果未配置缓存，每次请求都会从服务器读取，影响页面加载速度。在Nginx配置中添加静态资源的缓存策略可以显著改善体验，如本文2.3节中所示。

六、性能优化与安全加固

6.1 Nginx性能调优

在高并发场景下，Nginx的配置参数需要进行适当调优。主要关注以下几个参数：

worker_processes auto;
worker_connections 10240;
keepalive_timeout 65;
gzip on;
gzip_min_length 1k;
gzip_types text/plain text/css text/javascript application/json application/javascript;

worker_processes设置为auto可以自动匹配CPU核心数，worker_connections决定了每个worker进程能处理的并发连接数，gzip压缩可以大幅减少传输数据量。

6.2 Spring Boot生产环境优化

Spring Boot应用在生产环境中需要关注以下几点：

使用 -Xmx 和 -Xms 参数合理设置JVM堆内存，避免OOM
启用Spring Boot的Actuator端点进行健康检查和监控，但需做好安全防护
配置日志滚动策略，防止日志文件无限增长
使用连接池（如HikariCP）管理数据库连接

一个优化的启动命令示例：

java -Xms512m -Xmx1024m -jar /opt/apps/your-app.jar --spring.profiles.active=prod

6.3 安全加固建议

防火墙配置：使用firewalld或iptables仅开放必要的端口（80、443、22），关闭其他所有端口
SSH安全：禁用root远程登录，使用密钥认证，修改默认SSH端口
HTTPS加密：为域名申请SSL证书（可使用Let's Encrypt免费证书），配置Nginx强制跳转HTTPS
敏感信息保护：数据库密码、API密钥等通过环境变量或配置中心管理，不入代码库
定期更新：及时更新操作系统和软件的安全补丁

七、总结与展望

本文完整地呈现了将前后端分离项目部署到腾讯云CVM的全过程，从云服务器环境搭建、Nginx反向代理配置、Spring Boot服务部署，到自动化发布脚本和Jenkins流水线的编写，涵盖了从零到上线的每一个关键环节。通过Nginx统一入口解决了跨域问题，通过systemd服务实现了进程守护和自动重启，通过自动化脚本和流水线大幅提升了部署效率。

随着项目规模的扩大和用户量的增长，还可以在现有架构基础上引入更多高级特性：使用Docker容器化部署实现环境一致性、引入Kubernetes进行容器编排、配置CDN加速静态资源分发、搭建ELK日志平台实现集中化日志管理等。云原生时代的部署架构正在不断演进，但理解最基础的部署原理和工具链，始终是每一位后端开发者和运维工程师的核心能力。

希望本文能够为正在探索云上部署的开发者提供一份切实可行的参考，帮助大家更高效地将自己的项目交付到生产环境中。

常见问题与解答

问1：Nginx反向代理配置后，访问页面出现502错误，该如何排查？

502错误表示Nginx无法连接到后端Spring Boot服务。首先通过 systemctl status your-app 确认服务是否运行，然后执行 curl http://127.0.0.1:8080/actuator/health 测试服务是否可访问。如果服务正常运行但仍返回502，检查Nginx配置中的 proxy_pass 地址是否正确，以及防火墙是否放行了对应端口。

问2：前端路由使用history模式时，刷新页面出现404怎么解决？

这是因为浏览器刷新时向服务器请求了具体的路径，而服务器上并没有对应的物理文件。解决方案是在Nginx配置的 location / 块中添加 try_files $uri $uri/ /index.html; ，将所有不存在的路径请求都指向 index.html，由前端路由接管。

问3：自动化部署脚本中，如何实现服务零停机更新？

可以通过滚动更新或蓝绿部署策略实现零停机。在单机环境下，一个常用的方法是先启动新版本服务（使用不同端口），然后通过Nginx的 upstream 配置进行流量切换，最后停止旧版本。更简单的做法是使用Spring Boot的优雅停机功能，配合负载均衡器的健康检查实现平滑过渡。

问4：Jenkins Pipeline中如何安全地存储服务器SSH私钥？

Jenkins提供了Credentials插件来管理敏感信息。可以将SSH私钥添加为"SSH Username with private key"类型的凭证，在Pipeline中通过 withCredentials 步骤引用。避免将私钥明文写在Jenkinsfile中或存储在代码仓库里。

问5：前后端分离项目中，Nginx如何配置HTTPS？

首先需要获取SSL证书（可通过Let's Encrypt免费申请）。然后在Nginx配置中新增一个监听443端口的server块，配置 ssl_certificate 和 ssl_certificate_key 指向证书文件，同时可以将80端口的请求通过 return 301 https://$server_name$request_uri; 强制跳转到HTTPS。

问6：Spring Boot应用内存溢出（OOM）如何预防和处理？

预防OOM的关键是合理设置JVM堆内存参数，通过 -Xmx 限制最大堆内存。同时，在代码层面避免内存泄漏（如未关闭的数据库连接、大对象驻留等）。如果发生OOM，可以通过 -XX:+HeapDumpOnOutOfMemoryError 参数生成堆转储文件，使用MAT或JVisualVM等工具分析内存占用情况，定位问题根源。