阿里云服务器部署Spring Boot项目需要哪些配置?

在阿里云 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

2. 数据库与中间件(可选但常见)

绝大多数 Spring Boot 项目离不开数据库或缓存。

  • MySQL:
    • 方案 A:在 ECS 上自建 MySQL。需要安装 MySQL Server,创建用户并授权远程访问(注意修改 bind-address 或用户权限中的 Host 为 %)。
    • 方案 B:强烈推荐使用阿里云 RDS MySQL。RDS 是托管服务,自带高可用、备份、监控,安全性远高于自建,且通过内网连接几乎零延迟,免去了维护数据库服务器的麻烦。只需在 Spring Boot 配置文件中指向 RDS 的内网地址即可。
  • 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;
        }
    }
  • 好处:

    1. 对外只开放 80 (HTTP) 或 443 (HTTPS),隐藏内部 8080 端口。
    2. 可以结合 SSL 证书实现 HTTPS。
    3. 支持静态资源缓存,减轻后端压力。
    4. 后续如果需要集群,可以轻松改为负载均衡多个后端节点。

6. 域名与备案(国内合规要求)

如果你在国内阿里云 ECS 上使用自定义域名访问:

  • ICP 备案:根据中国法律法规,未备案域名解析到大陆境内服务器会被阻断。务必先在阿里云控制台提交 ICP 备案申请,审核通过后才能绑定域名。
  • DNS 解析:在阿里云 DNS 或其他域名服务商处,将域名 A 记录指向你的 ECS 公网 IP。

总结 checklist

  1. [ ] ECS 安全组已放行 8080(或 80/443)端口。
  2. [ ] Linux 系统防火墙已放行对应端口。
  3. [ ] JDK 已安装并配置环境变量。
  4. [ ] 数据库/Redis 连接配置正确(推荐使用阿里云 RDS/Redis 内网连接)。
  5. [ ] Spring Boot jar 包已上传至服务器。
  6. [ ] 应用已通过 systemd 或 Docker 稳定运行。
  7. [ ] (可选)Nginx 已配置反向X_X。
  8. [ ] (可选)域名已完成 ICP 备案并解析。

按照这个流程走,基本不会出大问题。如果遇到具体报错,先看日志(/var/log/messages 或 journalctl 或应用自身的 logback/spring.log 日志),90% 的问题都能从日志中找到线索。

未经允许不得转载:CLOUD云枢 » 阿里云服务器部署Spring Boot项目需要哪些配置?