在阿里云 ECS(云服务器)上部署 Spring Boot 项目,本质上是一个“环境准备 -> 依赖安装 -> 应用部署 -> 网络放行”的过程。很多新手容易只关注代码本身,忽略了服务器层面的配置,导致项目跑不起来或者无法访问。
下面我把整个流程拆解为几个核心步骤,尽量贴合实际生产环境的最佳实践。
1. 基础环境准备(操作系统层面)
Spring Boot 是基于 Java 的,所以第一步永远是搞定运行环境。
-
JDK 安装:
- 推荐版本:JDK 8 或 JDK 17(取决于你的 Spring Boot 版本)。目前主流是 JDK 8 和 JDK 11/17。
- 安装方式:直接在 Linux 终端通过包管理器安装(如 CentOS 用
yum install java-1.8.0-openjdk-devel,Ubuntu 用apt install openjdk-17-jdk),或者下载二进制包手动解压配置JAVA_HOME。不要依赖系统自带的默认版本,版本不可控是大忌。 - 验证:
java -version和javac -version必须能输出对应版本号。
-
防火墙与安全组(这是最容易踩坑的地方):
- 阿里云控制台侧:登录阿里云 ECS 控制台,找到实例 -> 安全组 -> 配置规则。你需要添加一条入方向规则,协议选择 TCP,端口范围填你应用启动的端口(比如 8080),授权对象设为
0.0.0.0/0(表示允许所有 IP 访问,生产环境建议限制为特定 IP 段以保安全)。 - Linux 系统侧:如果系统开启了 firewalld 或 iptables,也需要放行对应端口。例如 CentOS 7+:
firewall-cmd --zone=public --add-port=8080/tcp --permanent firewall-cmd --reload
- 阿里云控制台侧:登录阿里云 ECS 控制台,找到实例 -> 安全组 -> 配置规则。你需要添加一条入方向规则,协议选择 TCP,端口范围填你应用启动的端口(比如 8080),授权对象设为
2. 数据库与中间件(可选但常见)
绝大多数 Spring Boot 项目离不开数据库或缓存。
- MySQL:
- 方案 A:在 ECS 上自建 MySQL。需要安装 MySQL Server,创建用户并授权远程访问(注意修改
bind-address或用户权限中的 Host 为%)。 - 方案 B:强烈推荐使用阿里云 RDS MySQL。RDS 是托管服务,自带高可用、备份、监控,安全性远高于自建,且通过内网连接几乎零延迟,免去了维护数据库服务器的麻烦。只需在 Spring Boot 配置文件中指向 RDS 的内网地址即可。
- 方案 A:在 ECS 上自建 MySQL。需要安装 MySQL Server,创建用户并授权远程访问(注意修改
- Redis:
- 同样建议优先使用阿里云 Redis 实例。如果为了省钱自建,记得设置强密码,并关闭保护模式(protected-mode no),同时绑定允许的 IP。
3. 项目打包与上传
- 打包:在本地 IDEA 中执行
mvn clean package或gradle build,生成.jar文件。确保pom.xml中打包插件配置正确(如spring-boot-maven-plugin)。 - 上传:使用
scp命令或 SFTP 工具(如 WinSCP, FileZilla)将 jar 包上传到 ECS 的某个目录,例如/opt/app/myapp.jar。 - 权限:确保该用户对 jar 包有读取和执行权限。
4. 启动方式(关键配置)
不要直接用 java -jar app.jar 在前台运行,一旦终端关闭,进程就没了。以下是几种常用方式:
-
方式一:后台运行(简单粗暴)
nohup java -jar /opt/app/myapp.jar > /var/log/app.log 2>&1 &nohup:忽略挂起信号。>:重定向标准输出。&:放入后台执行。- 缺点:没有进程管理,重启麻烦,日志轮转需手动处理。
-
方式二:Systemd 服务(生产环境推荐)
创建/etc/systemd/system/myapp.service文件:[Unit] Description=My Spring Boot App After=syslog.target [Service] User=root ExecStart=/usr/bin/java -jar /opt/app/myapp.jar SuccessExitStatus=143 Restart=on-failure RestartSec=10 [Install] WantedBy=multi-user.target然后执行:
systemctl daemon-reload systemctl enable myapp.service systemctl start myapp.service- 优点:开机自启、崩溃自动重启、方便查看日志 (
journalctl -u myapp.service)。
- 优点:开机自启、崩溃自动重启、方便查看日志 (
-
方式三:Docker 容器化(现代 DevOps 标准)
编写Dockerfile,构建镜像,然后在 ECS 上运行容器。这能彻底隔离环境依赖,便于迁移和扩展。FROM openjdk:17-slim COPY myapp.jar /app.jar ENTRYPOINT ["java", "-jar", "/app.jar"]然后
docker run -d -p 8080:8080 myapp-image。
5. Nginx 反向X_X(进阶优化)
如果直接暴露 8080 端口给公网,既不安全也不优雅。通常会在 ECS 上安装 Nginx,做反向X_X。
-
Nginx 安装:
yum install nginx或apt install nginx。 -
配置示例 (
/etc/nginx/conf.d/default.conf):server { listen 80; server_name your-domain.com; # 替换为你的域名 location / { 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; } } -
好处:
- 对外只开放 80 (HTTP) 或 443 (HTTPS),隐藏内部 8080 端口。
- 可以结合 SSL 证书实现 HTTPS。
- 支持静态资源缓存,减轻后端压力。
- 后续如果需要集群,可以轻松改为负载均衡多个后端节点。
6. 域名与备案(国内合规要求)
如果你在国内阿里云 ECS 上使用自定义域名访问:
- ICP 备案:根据中国法律法规,未备案域名解析到大陆境内服务器会被阻断。务必先在阿里云控制台提交 ICP 备案申请,审核通过后才能绑定域名。
- DNS 解析:在阿里云 DNS 或其他域名服务商处,将域名 A 记录指向你的 ECS 公网 IP。
总结 checklist
- [ ] ECS 安全组已放行 8080(或 80/443)端口。
- [ ] Linux 系统防火墙已放行对应端口。
- [ ] JDK 已安装并配置环境变量。
- [ ] 数据库/Redis 连接配置正确(推荐使用阿里云 RDS/Redis 内网连接)。
- [ ] Spring Boot jar 包已上传至服务器。
- [ ] 应用已通过 systemd 或 Docker 稳定运行。
- [ ] (可选)Nginx 已配置反向X_X。
- [ ] (可选)域名已完成 ICP 备案并解析。
按照这个流程走,基本不会出大问题。如果遇到具体报错,先看日志(/var/log/messages 或 journalctl 或应用自身的 logback/spring.log 日志),90% 的问题都能从日志中找到线索。
CLOUD云枢