腾讯云服务器怎么部署Spring Boot加Vue的前后端分离项目

很多人买了腾讯云服务器，结果卡在“项目怎么放上去”这一步——后端打成jar包不知道放哪，前端打包完的dist文件不会配Nginx，连通性一调就是半天。不是缺端口，就是跨域报错，或者页面空白但控制台没报错，最后只能重装系统从头来。

这篇就带你从零开始，把一个真实的 Spring Boot + Vue 项目（带登录、用户管理、接口交互）完整部署到腾讯云服务器上，不跳步、不省略、不假设你懂Linux，每一步都对应你在控制台或SSH里真实要敲的命令和点的按钮。

先搞清楚你要部署的是什么项目

我们以一个典型的前后端分离结构为例：

• 后端：Spring Boot 2.7.x 写的 REST API，用 Maven 打包成 app.jar，内置 Tomcat，端口默认 8080；
• 前端：Vue 3 + Vue Router + Axios，用 npm run build 打出 dist/ 目录，静态资源，需要 Nginx 托管；
• 通信方式：前端请求后端接口走 /api/xxx，由 Nginx 反向代理到 http://localhost:8080；
• 运行环境：腾讯云 CentOS 7.9 系统（兼容性好，新手友好）。

注意：这不是“理论可行”，而是你照着做就能跑通的路径。所有操作都基于当前（2026年初）腾讯云控制台界面和默认配置逻辑，没有隐藏步骤。

第一步：买一台能跑项目的腾讯云服务器

别一上来就选“最低配”。Spring Boot + Vue 组合虽然轻量，但编译、运行、调试时内存压力不小。如果只选1核1G，部署中途容易卡死或 SSH 断连。

按实际需求建议配置：

选好后直接下单，腾讯云会自动分配公网IP。付款完成后，你就能在控制台看到这台服务器了。

点击实例右侧的 “登录”，用网页版 SSH 或本地工具（如 MobaXterm、FinalShell）连上去。首次登录需重置密码，按提示设一个含大小写字母+数字+符号的12位密码。

第二步：装好基础环境——JDK + Nginx + 进程管理

别急着传代码。先确认服务器“能干活”：

1. 装 JDK 11（Spring Boot 2.7 默认支持）：
   yum install java-11-openjdk-devel -y
   验证：java -version 应显示 11.0.x
2. 装 Nginx：
   yum install nginx -y
   启动：systemctl start nginx && systemctl enable nginx
   浏览器打开 http://你的公网IP，看到 “Welcome to nginx!” 就说明装对了
3. （可选但强烈建议）装 宝塔面板：
   一行命令搞定：curl -sSO http://download.bt.cn/install/install_6.0.sh && bash install_6.0.sh
   安装完会提示面板地址、用户名和密码。这时必须去腾讯云控制台的 安全组 → 添加规则 → 开放 8888 端口（宝塔面板）、80（网站）、8080（后端）。

如果你不想用宝塔，后面所有配置都可通过命令行完成，但宝塔对新手更直观——比如点两下就能开防火墙、看进程、查日志，省去记命令的负担。

第三步：上传并运行后端 Spring Boot 项目

假设你的后端项目本地已打包好，生成了 target/app.jar。

• 用 scp 或宝塔文件管理器，把 app.jar 上传到服务器任意目录，比如：/root/myapp/
• 给执行权限：chmod +x /root/myapp/app.jar
• 用 nohup 后台运行（避免关闭SSH后进程退出）：
  nohup java -jar /root/myapp/app.jar --server.port=8080 > /root/myapp/app.log 2>&1 &
• 检查是否运行：ps -ef | grep app.jar 或 curl http://localhost:8080/actuator/health（如有该端点）

如果返回 {"status":"UP"}，说明后端服务已就绪。此时它只监听 localhost:8080，外部还访问不到——这是正常设计，等前端Nginx来代理。

第四步：部署 Vue 前端 + 配置 Nginx 反向代理

本地运行 npm run build，生成 dist/ 文件夹。把整个文件夹压缩成 dist.zip，上传到服务器，比如放到 /www/wwwroot/myvue/（宝塔默认网站根目录）。

解压后，修改 Nginx 配置，让它干两件事：

• 把 http://你的IP/ 指向 dist/ 静态文件；
• 把所有 /api/ 开头的请求，转发给 http://127.0.0.1:8080/。

编辑配置文件：vi /etc/nginx/conf.d/default.conf，替换为以下内容：

server {
    listen       80;
    server_name  _;

    location / {
        root   /www/wwwroot/myvue;
        index  index.;
        try_files $uri $uri/ /index.;
    }

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

保存后重载 Nginx：nginx -s reload。现在访问 http://你的公网IP，就能看到 Vue 页面；点击登录按钮，请求会自动走到后端 /api/login，完成真实交互。

第五步：常见卡点和怎么一眼看出问题在哪

部署失败，90% 都出在这几个地方。别盲猜，按顺序查：

• 页面打不开（白屏/404）：先看浏览器按 F12 → Network → 刷一下，看哪个文件 404。99% 是 dist/ 路径配错了，或者 Nginx root 指向了空目录；
• 登录按钮点不动、控制台报跨域：说明 Nginx 没生效，前端还在直接请求 http://你的IP:8080/api/xxx。检查 Vue 项目里的 vue.config.js，确认 devServer.proxy 仅用于本地开发，上线必须删掉或注释；
• 后端接口返回 502 Bad Gateway：Nginx 转发失败。先 curl http://localhost:8080/api/health 看后端是否真在跑；再检查 proxy_pass 末尾有没有多余斜杠（http://127.0.0.1:8080/ ✓，http://127.0.0.1:8080 ✗）；
• SSH 断连、进程消失：没加 nohup 或没加 &；或服务器内存不足被 OOM Killer 杀掉——这时看 dmesg -T | grep -i "killed process"。

这些都不是玄学，是每台腾讯云服务器上都会发生的确定性现象。你只要把上面几条命令复制粘贴进去，按顺序执行，99% 的问题当场解决。

最后说一句实在话

部署本身不难，难的是第一次没人告诉你“哪一步错了，系统其实已经悄悄告诉你答案了”。日志在 /root/myapp/app.log，Nginx 错误在 /var/log/nginx/error.log，宝塔面板里点“网站”→“日志”也能直接看。别怕报错，报错才是系统在跟你说话。

如果你现在正对着黑窗口发呆，不如就打开腾讯云控制台，按本文顺序买一台 2核4GB CentOS 7.9 的服务器，从重置密码开始，一步步敲下去。半小时后，你自己的 Spring Boot + Vue 项目就会跑在公网IP上，别人用手机也能打开。

需要快速起步，可以访问 腾讯云服务器优惠入口，选择适合项目的配置直接下单。