腾讯云ECS云服务器部署SpringBoot项目从零到上线全攻略

apphuang2026年07月01日 10:46:185

一、写在前面：为什么选择腾讯云ECS部署SpringBoot

将SpringBoot项目部署到云服务器，是每个Java开发者从本地开发走向线上服务的必经之路。腾讯云ECS（云服务器）凭借稳定的性能、灵活的配置选项以及完善的生态体系，成为众多开发者部署Java应用的首选平台。无论是个人博客、企业后台管理系统，还是微服务架构中的核心业务模块，腾讯云ECS都能提供可靠的计算资源支撑。

本文将从零开始，手把手带你完成SpringBoot项目在腾讯云ECS上的完整部署流程。内容涵盖服务器选购、环境搭建、项目部署、域名绑定、监控告警以及成本优化等全链路环节。

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

二、服务器选购：选对配置少走弯路

2.1 实例规格选择

很多新手一上来就选最低配，结果部署中途频繁卡顿甚至SSH断连。SpringBoot项目虽然轻量，但编译、运行、调试时的内存压力不容忽视。对于大部分中小型项目，建议选择2核4GB内存的配置，这个规格足够支撑后端服务、Nginx、MySQL以及可选的面板工具同时运行，还能留有一定余量避免内存溢出。

如果预算有限且项目非常简单（如纯API接口、访问量极低），1核2GB也可以勉强运行，但不推荐作为生产环境配置。对于高并发场景或微服务架构，建议选择4核8GB甚至更高配置的实例。

2.2 轻量应用服务器与标准型CVM的选择

腾讯云提供轻量应用服务器（Lighthouse）和标准型云服务器（CVM）两种产品。轻量应用服务器面向个人开发者、中小企业及云计算入门者，提供可视化管理页面，可以一键安装环境和网站源码，以套餐形式整体售卖基础云资源。但它面向单机应用，可扩展性较差，性能上略低于标准型CVM，不适合高并发或大数据处理场景。

标准型CVM则面向所有上云用户，支持按量付费，无流量限制，可扩展性好，适合大型企业及对性能有更高要求的场景。如果你搭建的是个人博客、论坛或小型项目，轻量应用服务器完全够用；如果是企业级生产环境或微服务架构，建议选择标准型CVM。

2.3 操作系统镜像选择

操作系统推荐选择CentOS 7.9或Ubuntu 22.04 LTS。CentOS生态稳定、教程最多，对各种中间件的兼容性好，新手容错率高。Ubuntu则拥有更活跃的社区和更频繁的更新，适合喜欢尝鲜的开发者。如果你不想手动搭建环境，腾讯云提供了多种应用镜像，如预装宝塔面板加JDK加Nginx的镜像，开箱即用，能大幅缩短部署时间。

2.4 带宽与存储配置

公网带宽建议3Mbps起步，够日常访问和小流量接口调用。后续可根据业务增长随时升配，不影响已部署服务。系统盘建议50GB以上，如果项目涉及大量文件上传或日志存储，可以考虑挂载额外的数据盘。

2.5 安全组端口开放

服务器购买完成后，第一时间需要配置安全组（防火墙）规则。腾讯云出于安全考虑，默认只开放少数常用端口。我们需要手动放行以下端口：

22端口：SSH远程连接
80端口：HTTP网站访问
443端口：HTTPS加密访问
8080端口：SpringBoot应用默认端口（如不使用Nginx反向代理则需要直接暴露）
8888端口：宝塔面板端口（如使用宝塔）

安全组配置在腾讯云控制台的「安全组」菜单中完成。添加入站规则时建议尽量限制访问来源IP，避免端口暴露带来安全隐患。严格限制入站规则，仅开放必要端口，并对22端口限制访问源IP。

三、环境搭建：让服务器准备好运行Java

3.1 连接服务器

购买完成后，在控制台复制实例的公网IP地址。Windows用户可以使用MobaXterm、Xshell或FinalShell等SSH工具，Mac/Linux用户直接使用终端即可。新建SSH连接，输入IP地址、端口22、用户名root，首次登录需在控制台重置密码。连接成功后，命令行提示符变为[root@xxx]#，说明已经成功登录服务器。

3.2 安装JDK环境

SpringBoot项目依赖Java运行环境。根据SpringBoot版本选择合适的JDK版本——SpringBoot 2.x推荐JDK 11，SpringBoot 3.x必须使用JDK 17或更高版本。

CentOS系统安装JDK 11：

yum install -y java-11-openjdk-devel

验证安装：

java -version

应显示11.0.x版本信息。

Ubuntu系统安装JDK 17：

sudo apt update && sudo apt upgrade -y
sudo apt install -y openjdk-17-jdk
java -version

如果提示找不到命令，可能需要配置环境变量：

echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64' | sudo tee -a ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' | sudo tee -a ~/.bashrc
source ~/.bashrc

3.3 安装Nginx（可选但推荐）

Nginx作为高性能的Web服务器和反向代理服务器，在部署SpringBoot项目时非常实用。它可以处理静态资源、实现负载均衡、配置HTTPS，并将请求转发到后端SpringBoot应用。

CentOS安装Nginx：

yum install -y nginx
systemctl start nginx
systemctl enable nginx

安装完成后，浏览器访问http://你的公网IP，看到"Welcome to nginx!"即表示安装成功。

Ubuntu安装Nginx：

sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx

3.4 安装宝塔面板（可选）

宝塔面板提供了可视化的服务器管理界面，对新手非常友好——比如点两下就能开防火墙、看进程、查日志，省去记命令的负担。一行命令即可安装：

curl -sSO http://download.bt.cn/install/install_6.0.sh && bash install_6.0.sh

安装完会提示面板地址、用户名和密码。这时需要去腾讯云控制台的安全组开放8888端口（宝塔面板）、80端口（网站）、8080端口（后端）。

四、项目打包与上传

4.1 本地打包

在本地开发环境中，使用Maven或Gradle构建SpringBoot项目。执行以下命令生成可执行的JAR文件：

Maven项目：

mvn clean package

Gradle项目：

gradle build

打包完成后，在target目录（Maven）或build/libs目录（Gradle）下会生成一个.jar文件，例如app.jar。

4.2 上传JAR包到服务器

方法一：使用SCP命令（推荐）

在本地终端执行：

scp -P 22 target/your-app.jar root@你的公网IP:/opt/spring-boot-app/

注意：如果使用了非标准SSH端口，请修改-P参数。

方法二：使用SFTP客户端

使用FileZilla、Xftp等工具连接服务器，将JAR包拖入目标目录。

方法三：使用宝塔文件管理器

如果安装了宝塔面板，可以直接在面板的文件管理器中上传文件。

五、运行与进程管理

5.1 直接运行（临时测试）

上传完成后，可以先直接运行测试一下：

java -jar /opt/spring-boot-app/your-app.jar

但这种方式的缺点是：关闭终端后程序就会停止，不适合生产环境。

5.2 使用nohup后台运行

使用nohup命令可以让程序在后台持续运行：

nohup java -jar /opt/spring-boot-app/your-app.jar --server.port=8080 > /opt/spring-boot-app/logs/app.log 2>&1 &

这种方式虽然可以让程序后台运行，但进程管理不够方便，服务器重启后需要手动重新启动。

5.3 使用Systemd管理进程（生产环境推荐）

使用systemd可以让服务随系统启动并方便管理。创建服务配置文件：

sudo nano /etc/systemd/system/my-springboot.service

粘贴以下内容：

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

[Service]
Type=simple
User=root
WorkingDirectory=/opt/spring-boot-app
ExecStart=/usr/bin/java -jar /opt/spring-boot-app/your-app.jar --server.port=8080
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target

保存退出后，执行以下命令：

systemctl daemon-reload
systemctl start my-springboot
systemctl enable my-springboot

常用的管理命令：

查看状态：systemctl status my-springboot
停止服务：systemctl stop my-springboot
重启服务：systemctl restart my-springboot
查看日志：journalctl -u my-springboot -f

5.4 编写启动脚本（备用方案）

如果不想使用systemd，也可以编写Shell脚本来管理进程。创建启动脚本：

sudo nano /opt/spring-boot-app/start.sh

脚本内容示例：

#!/bin/bash
APP_NAME="your-app.jar"
LOG_FILE="/opt/spring-boot-app/logs/app.log"
PID_FILE="/opt/spring-boot-app/logs/app.pid"

if [ -f "$PID_FILE" ]; then
    PID=$(cat $PID_FILE)
    if ps -p $PID > /dev/null; then
        echo "Application is already running with PID: $PID"
        exit 0
    fi
fi

nohup java -jar $APP_NAME --server.port=8080 > $LOG_FILE 2>&1 &
echo $! > $PID_FILE
echo "Application started with PID: $(cat $PID_FILE)"

赋予执行权限：

sudo chmod +x start.sh

六、Nginx反向代理配置

6.1 为什么要使用Nginx反向代理

在生产环境中，通常不建议直接将SpringBoot的8080端口暴露给外网。使用Nginx反向代理有以下几个好处：

统一入口：所有请求通过80/443端口进入，由Nginx分发到后端服务
负载均衡：可以将请求分发到多个后端实例
SSL终止：在Nginx层面配置HTTPS，后端服务无需处理证书
静态资源处理：Nginx处理静态资源效率远高于Java应用

6.2 Nginx配置示例

编辑Nginx配置文件：

sudo nano /etc/nginx/conf.d/springboot.conf

添加以下配置：

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    location / {
        proxy_pass http://localhost: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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

配置完成后测试并重载Nginx：

nginx -t
systemctl reload nginx

七、域名绑定与HTTPS配置

7.1 购买域名

首先需要拥有一个属于自己的域名。可以在腾讯云等域名注册商处购买。购买步骤如下:

登录腾讯云控制台
进入域名管理页面
搜索并选择想要的域名
完成支付并确认购买

7.2 配置DNS解析

购买域名后，需要将其指向你的服务器IP地址。具体步骤：

登录腾讯云控制台，进入域名管理页面
找到购买的域名，点击"解析"按钮
添加一条A记录，将域名指向服务器公网IP
保存设置并等待DNS解析生效（通常需要几分钟到几小时）

7.3 申请SSL证书

为了启用HTTPS，需要为域名申请SSL证书。腾讯云提供了免费的SSL证书服务。具体步骤：

登录腾讯云控制台，进入SSL证书管理页面
选择"免费版"并按照提示填写域名信息
提交域名验证，通常可以通过DNS验证或HTTP验证完成
等待审核通过后，下载证书文件（通常包括.crt和.key文件）

7.4 Nginx配置HTTPS

将下载的SSL证书文件放到服务器上（例如/etc/nginx/ssl目录），然后在Nginx配置文件中配置HTTPS：

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name yourdomain.com www.yourdomain.com;

    ssl_certificate /etc/nginx/ssl/your-certificate.crt;
    ssl_certificate_key /etc/nginx/ssl/your-certificate.key;

    location / {
        proxy_pass http://localhost: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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这段配置将所有HTTP请求重定向到HTTPS，确保用户始终通过安全的连接访问网站。配置完成后测试并重载Nginx：

nginx -t
systemctl reload nginx

八、Docker化部署（进阶方案）

8.1 为什么使用Docker

Docker可以将应用及其依赖打包成一个独立的容器，实现环境的一致性和可移植性。使用Docker部署SpringBoot项目主要包含四个步骤：打包项目、编写Dockerfile、构建镜像、运行容器。

8.2 编写Dockerfile

在项目根目录新建Dockerfile：

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/your-app-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "-Xmx256m", "-Dspring.profiles.active=prod", "app.jar"]

8.3 构建与运行

构建镜像：

docker build -t my-java-app:1.0 .

在服务器上安装Docker：

curl -fsSL https://get.docker.com | bash -s docker
systemctl start docker && systemctl enable docker

运行容器：

docker run -d -p 8080:8080 --name my-app my-java-app:1.0

九、监控告警与日志管理

9.1 应用监控

SpringBoot Actuator提供了丰富的监控端点，可以结合Prometheus和Grafana实现可视化监控。在pom.xml中添加依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

在application.yml中配置：

management:
  endpoints:
    web:
      exposure:
        include: health,info,prometheus
  metrics:
    export:
      prometheus:
        enabled: true

配置完成后，可以通过 http://ip:port/actuator/prometheus 查看监控数据。

9.2 日志管理

建议将应用日志输出到固定目录，并配置日志轮转策略。在application.yml中配置：

logging:
  file:
    path: /var/log/my-app
    name: /var/log/my-app/application.log
  logback:
    rollingpolicy:
      max-file-size: 100MB
      max-history: 30

也可以使用ELK（Elasticsearch+Logstash+Kibana）或腾讯云CLS（日志服务）进行集中式日志管理。

十、常见问题与解决方案

10.1 端口未开放

确保腾讯云安全组已放行应用端口（如8080），同时检查服务器内部防火墙（firewalld或iptables）是否开放了对应端口。

10.2 内存不足

如果服务器内存较小，可以通过调整JVM参数来优化内存使用：

java -jar -Xmx256m -Xms128m your-app.jar

10.3 依赖缺失

确保所有必要的依赖都已正确包含在项目中，并且在构建过程中没有错误。

10.4 数据库连接失败

检查数据库连接配置（URL、用户名、密码），确保数据库服务已启动且允许远程连接。

10.5 跨域问题

如果是前后端分离项目，需要在SpringBoot中配置CORS，或在Nginx中配置跨域头。

十一、成本优化策略

11.1 选择合适的实例规格

不要盲目追求高配置，根据实际业务需求选择合适的实例规格。可以先从低配起步，后续根据监控数据按需升配。

11.2 使用预留实例或包年包月

对于长期运行的生产环境，包年包月比按量付费更划算。腾讯云经常推出新用户优惠和促销活动，可以关注。

11.3 合理配置带宽

带宽费用是云服务器的重要成本组成部分。建议3Mbps起步，根据实际流量情况调整。

11.4 利用内网通信

如果数据库、缓存等服务也部署在腾讯云同地域，使用内网IP通信可以免流量费，同时降低延迟。

十二、总结

将SpringBoot项目部署到腾讯云ECS，是一个涵盖服务器选型、环境搭建、应用部署、网络配置、监控运维的全流程工程。本文从零开始，完整梳理了每一个环节的操作步骤和注意事项。从服务器选购时的配置考量，到安全组的精细配置；从JDK环境的安装，到使用systemd实现进程的持久化运行；从Nginx反向代理的配置，到域名绑定与SSL证书的申请——每一步都是生产环境部署不可或缺的环节。

希望本文能成为你云上部署之路的一份实用参考。无论你是刚接触云部署的新手，还是希望规范部署流程的开发者，都能从中找到可操作的方法和值得借鉴的经验。

常见问题解答

问1：SpringBoot项目部署到腾讯云ECS，最低需要什么配置？

最低配置建议1核2GB内存，但仅适合极低访问量的测试项目。生产环境建议至少2核4GB内存，以确保服务稳定运行。

问2：部署后无法通过浏览器访问，可能是什么原因？

首先检查腾讯云安全组是否放行了对应端口（如8080）；其次检查服务器内部防火墙是否开放；然后确认SpringBoot应用是否正常启动（查看日志）；最后确认应用绑定的IP是否为0.0.0.0而非127.0.0.1。

问3：如何让SpringBoot应用在服务器重启后自动启动？

推荐使用systemd管理服务，通过systemctl enable命令设置开机自启。也可以使用supervisor等进程管理工具。

问4：Nginx反向代理和直接暴露8080端口有什么区别？

直接暴露8080端口虽然简单，但存在安全隐患且无法处理HTTPS。Nginx反向代理可以提供统一的入口、SSL终止、负载均衡、静态资源缓存等功能，是生产环境的标准做法。

问5：如何为SpringBoot项目配置HTTPS？

推荐在Nginx层面配置HTTPS，而非在SpringBoot中配置。在腾讯云申请免费的SSL证书，将证书文件上传到服务器，在Nginx配置中添加443端口的SSL配置即可。

问6：部署时遇到内存溢出（OOM）怎么办？

可以通过JVM参数限制内存使用，如-Xmx256m -Xms128m。如果仍然不足，需要考虑升级服务器配置。