如何在VPS上正确部署SpringBoot项目？

部署方式	适用场景	优势	缺点
Jar包部署	微服务架构、云原生应用	无需外部Web容器，开箱即用	不适合与旧系统共用Tomcat
War包部署	传统JavaWeb项目、企业级容器化管理	可与现有Tomcat环境兼容	需要外部Web容器支持
Docker部署	跨环境部署、持续集成	环境隔离、易于扩展	需要额外学习Docker技术
传统部署	简单测试环境	配置简单、快速验证	缺乏环境一致性保障

VPS上如何部署SpringBoot项目？_从环境配置到安全上线的完整指南

SpringBoot项目的VPS部署是Java开发者需要掌握的重要技能，合理部署能够确保应用的稳定运行和高效维护。

部署步骤概览

步骤	主要内容	预计耗时	关键工具
1	VPS环境准备	10-15分钟	云服务商控制台
2	JDK安装配置	5-10分钟	yum/apt包管理器
3	项目打包构建	3-5分钟	Maven/Gradle
4	文件传输部署	2-3分钟	SCP/SFTP工具
5	服务启动验证	1-2分钟	systemd/nohup

详细操作流程

步骤一：VPS环境准备

操作说明： 首先需要购买并配置VPS服务器，设置安全组规则确保必要端口的访问权限。 使用工具提示：

• 阿里云、腾讯云等云服务商控制台
• 安全组配置界面

# 安全组需要开放的端口
80 (HTTP)
443 (HTTPS)
8080 (应用端口)
22 (SSH)

步骤二：JDK安装配置

操作说明： 在Linux服务器上安装JDK 1.8或更高版本，这是运行SpringBoot应用的基础环境。 使用工具提示：

• yum (CentOS/RHEL)
• apt (Ubuntu/Debian)

# CentOS 7 安装JDK 1.8
yum update
yum search jdk
yum install java-1.8.0-openjdk-devel
验证安装
java -version

步骤三：项目打包构建

操作说明： 在本地开发环境中使用Maven或Gradle将SpringBoot项目打包成可执行Jar文件。 使用工具提示：

• Maven: mvn clean package
• Gradle: gradle build

# Maven打包命令
mvn clean package -DskipTests
生成文件位置
target/your-project-name.jar

步骤四：文件传输部署

操作说明： 将本地打包好的Jar文件上传到VPS服务器，通常放置在/opt或/home目录下。 使用工具提示：

• SCP命令
• WinSCP图形化工具
• FileZilla

# 使用SCP传输文件
scp target/your-project-name.jar root@your-server-ip:/opt/app/
服务器端创建应用目录
mkdir -p /opt/app/logs

步骤五：服务启动验证

操作说明： 在VPS上启动SpringBoot应用，并验证服务是否正常运行。 使用工具提示：

• systemd (推荐)
• nohup (临时测试)

# 使用nohup后台运行
nohup java -jar /opt/app/your-project-name.jar > /opt/app/logs/app.log 2>&1 &
验证服务状态
curl http://localhost:8080/health

常见问题及解决方案

问题	原因	解决方案
内网域名解析失败	VPS在云端集群内网无法解析外部域名	配置/etc/hosts文件或使用IP地址直接访问
Actuator端点信息泄露	安全配置不当，监控端点暴露在公网	限制Actuator端点访问权限，配置认证机制
前端跨域访问问题	浏览器同源策略限制	添加CORS配置类，允许特定域名访问
数据库连接异常	数据库服务未启动或连接配置错误	检查MySQL服务状态，验证连接字符串和权限
端口被占用	其他进程占用了应用端口	更改应用端口或停止占用进程

安全配置建议

在部署过程中，特别需要注意SpringBoot Actuator模块的安全配置。Actuator提供了众多HTTP接口端点来监控应用运行状态，但如果配置不当可能造成敏感信息泄露。建议在生产环境中禁用不必要的端点，或配置IP白名单限制访问。 对于数据库安装，MySQL的配置相对复杂，需要特别注意服务启动和权限设置。建议按照官方文档逐步操作，确保数据库服务正常运行。 通过以上步骤和问题解决方案，您可以顺利完成SpringBoot项目在VPS上的部署工作，并建立起稳定的生产环境。