奋斗
努力

SpringBoot项目在阿里云服务器上如何通过Nginx实现多项目部署?

云计算

核心思路:
Nginx 监听 80/443,作为统一入口;每个 SpringBoot 项目跑在不同的本机端口上,例如 8081、8082、8083;Nginx 根据域名、路径或端口把请求转发到对应服务。

生产里更推荐:

用户
  ↓
阿里云 ECS 公网 IP:80/443
  ↓
Nginx
  ↓
127.0.0.1:8081  项目A
127.0.0.1:8082  项目B
127.0.0.1:8083  项目C

不要直接把 SpringBoot 的 8081、8082 暴露到公网,安全组只放行 80/443 更稳。


一、整体部署方式选择

多项目部署常见有三种方式:

方式 示例 推荐程度
子域名区分 a.example.com、b.example.com 最推荐
路径区分 example.com/app-a/、example.com/app-b/ 可以用,但前端路径容易踩坑
不同端口区分 ip:8081、ip:8082 测试可用,生产不推荐

如果是正式项目,我一般建议用子域名方式,配置清晰,前端静态资源、Cookie、WebSocket、Redirect 都少很多麻烦。


二、服务器准备

假设阿里云 ECS 上已经安装了:

  • JDK,版本按你的项目来,Java 8 / 11 / 17 都可以
  • Nginx
  • Maven 或者本地打包好的 jar

本地打包:

mvn clean package -DskipTests

上传 jar:

scp target/project-a.jar root@服务器IP:/opt/apps/project-a/app.jar
scp target/project-b.jar root@服务器IP:/opt/apps/project-b/app.jar

服务器创建目录:

mkdir -p /opt/apps/project-a
mkdir -p /opt/apps/project-b
mkdir -p /data/logs/project-a
mkdir -p /data/logs/project-b

三、给每个 SpringBoot 项目配置不同端口

项目 A:

server:
  address: 127.0.0.1
  port: 8081

项目 B:

server:
  address: 127.0.0.1
  port: 8082

server.address: 127.0.0.1 的意思是:只允许本机访问。

也就是说:

curl http://127.0.0.1:8081

可以访问,但外部机器不能直接访问 8081。

这比较适合 Nginx 和 SpringBoot 部署在同一台 ECS 上的情况。

如果你的 Nginx 在 Docker 里,或者 Nginx 和 SpringBoot 不在同一台机器,那就不能用 127.0.0.1,要改成 0.0.0.0,再通过防火墙或安全组限制来源。


四、用 systemd 托管 SpringBoot 服务

不要长期用 nohup java -jar 跑生产服务,进程挂了、机器重启、日志管理都不方便。推荐用 systemd。

项目 A service

创建:

vim /etc/systemd/system/project-a.service

内容:

[Unit]
Description=Project A SpringBoot Application
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/apps/project-a
ExecStart=/bin/bash -lc 'exec /usr/bin/java -Xms256m -Xmx512m -Dspring.profiles.active=prod -jar /opt/apps/project-a/app.jar'
Restart=always
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

项目 B 同理,端口在各自的 application-prod.yml 里配置即可。

启动:

systemctl daemon-reload
systemctl enable --now project-a
systemctl enable --now project-b

查看状态:

systemctl status project-a
systemctl status project-b

看日志:

journalctl -u project-a -f
journalctl -u project-b -f

检查端口是否起来:

ss -lntp | grep -E '8081|8082'

五、阿里云 ECS 安全组和域名解析

在阿里云 ECS 安全组入方向放行:

TCP 80
TCP 443

不建议放行 8081、8082。

如果服务器内部开启了防火墙,也需要放行:

CentOS / Alibaba Cloud Linux:

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

Ubuntu:

ufw allow 80/tcp
ufw allow 443/tcp

域名解析:

app-a.example.com   A记录   ECS公网IP
app-b.example.com   A记录   ECS公网IP

如果域名解析到内地 ECS 对外提供 Web 服务,按X_X要求需要完成备案。


六、Nginx 配置:子域名方式,最推荐

先准备一个通用反向X_X参数文件:

mkdir -p /etc/nginx/snippets
vim /etc/nginx/snippets/proxy_params.conf

内容:

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;
proxy_set_header X-Forwarded-Port $server_port;

proxy_http_version 1.1;
proxy_set_header Connection "";

然后配置 Nginx:

vim /etc/nginx/conf.d/projects.conf

内容:

upstream project_a {
    server 127.0.0.1:8081;
    keepalive 32;
}

upstream project_b {
    server 127.0.0.1:8082;
    keepalive 32;
}

server {
    listen 80;
    server_name app-a.example.com;

    location / {
        proxy_pass http://project_a;
        include /etc/nginx/snippets/proxy_params.conf;
    }
}

server {
    listen 80;
    server_name app-b.example.com;

    location / {
        proxy_pass http://project_b;
        include /etc/nginx/snippets/proxy_params.conf;
    }
}

检查配置并重载:

nginx -t
systemctl reload nginx

访问:

http://app-a.example.com  -> 127.0.0.1:8081
http://app-b.example.com  -> 127.0.0.1:8082

这种方式最干净,项目之间互不干扰。


七、Nginx 配置:同域名不同路径方式

如果没有多个域名,只能这样访问:

http://example.com/app-a/
http://example.com/app-b/

配置示例:

upstream project_a {
    server 127.0.0.1:8081;
}

upstream project_b {
    server 127.0.0.1:8082;
}

server {
    listen 80;
    server_name example.com;

    location = /app-a {
        return 301 /app-a/;
    }

    location /app-a/ {
        proxy_pass http://project_a/;
        include /etc/nginx/snippets/proxy_params.conf;
    }

    location = /app-b {
        return 301 /app-b/;
    }

    location /app-b/ {
        proxy_pass http://project_b/;
        include /etc/nginx/snippets/proxy_params.conf;
    }
}

这里有个非常关键的点:proxy_pass 后面有没有 / 完全不一样。

情况 1:带斜杠

location /app-a/ {
    proxy_pass http://127.0.0.1:8081/;
}

访问:

/app-a/user/list

后端收到:

/user/list

也就是 Nginx 把 /app-a/ 这个前缀去掉了。

情况 2:不带斜杠

location /app-a/ {
    proxy_pass http://127.0.0.1:8081;
}

访问:

/app-a/user/list

后端收到:

/app-a/user/list

也就是原始路径原样转发。

这两种模式要和 SpringBoot 的配置对应起来,不能混乱。

推荐做法是:

  • SpringBoot 不配 context-path
  • Nginx 用带 / 的 proxy_pass
  • 后端接口保持 /user/list
  • 外部访问通过 /app-a/user/list

如果你的 SpringBoot 已经配置了:

server:
  servlet:
    context-path: /app-a

那 Nginx 就不要去掉前缀,应该这样写:

location /app-a/ {
    proxy_pass http://127.0.0.1:8081;
}

路径部署最容易出问题的不是后端,而是前端静态资源、接口 baseURL、重定向地址、Cookie path、Swagger 地址。能用子域名就尽量用子域名。


八、如果每个项目还有 Vue / React 前端

这种场景也很常见:Nginx 托管前端静态页面,并把 /api/ 转发给 SpringBoot。

例如:

server {
    listen 80;
    server_name admin.example.com;

    root /var/www/admin-front;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://127.0.0.1:8081/;
        include /etc/nginx/snippets/proxy_params.conf;
    }
}

注意这里:

proxy_pass http://127.0.0.1:8081/;

访问:

/api/user/list

后端收到:

/user/list

这样前端请求统一走 /api/,后端接口不需要加 /api 前缀。

如果前端是 history 路由,try_files $uri $uri/ /index.html; 是必须的,否则刷新页面会 404。


九、HTTPS 配置

如果证书放在 /etc/nginx/cert/,例如:

/etc/nginx/cert/app-a.example.com.pem
/etc/nginx/cert/app-a.example.com.key

配置:

server {
    listen 80;
    server_name app-a.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name app-a.example.com;

    ssl_certificate /etc/nginx/cert/app-a.example.com.pem;
    ssl_certificate_key /etc/nginx/cert/app-a.example.com.key;

    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    location / {
        proxy_pass http://project_a;
        include /etc/nginx/snippets/proxy_params.conf;
    }
}

项目 B 再写一个 server 块,换个 server_name 和证书即可。

如果用的是阿里云 SSL 证书,下载时选择 Nginx 格式证书,然后上传到服务器对应目录。


十、WebSocket 项目需要额外配置

如果 SpringBoot 里有 WebSocket,普通反向X_X配置可能不够,要在对应 location 里加:

location /ws/ {
    proxy_pass http://project_a;
    include /etc/nginx/snippets/proxy_params.conf;

    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 300s;
    proxy_send_timeout 300s;
}

注意如果公共 snippet 里有:

proxy_set_header Connection "";

这里后面的:

proxy_set_header Connection "upgrade";

会覆盖它。

WebSocket 地址要按你的实际项目改,比如 /ws/、/websocket/。


十一、SpringBoot 获取真实客户端 IP

经过 Nginx 之后,SpringBoot 直接拿到的远程 IP 通常是 127.0.0.1,不是用户真实 IP。

所以如果项目里要记录客户端 IP,需要读这些头:

X-Real-IP
X-Forwarded-For
X-Forwarded-Proto

Spring Boot 2.x 可以配置:

server:
  forward-headers-strategy: native

或者部分场景使用:

server:
  forward-headers-strategy: framework

一般 native 更常用。


十二、常见坑

1. 访问 502 Bad Gateway

先查后端服务有没有起来:

systemctl status project-a
curl http://127.0.0.1:8081
ss -lntp | grep 8081

再看 Nginx 错误日志:

tail -f /var/log/nginx/error.log

常见原因:

  • jar 没启动
  • 端口写错
  • SpringBoot 实际端口不是 8081
  • SpringBoot 绑定到了 IPv6
  • systemd 里的 jar 路径错了

2. 访问到 Nginx 欢迎页

多半是默认站点没处理,尤其是 Ubuntu 下:

/etc/nginx/sites-enabled/default

可以禁用默认站点:

rm -f /etc/nginx/sites-enabled/default
nginx -t
systemctl reload nginx

3. 页面能开,接口 404

重点看 proxy_pass 后面有没有 /。

这个是最常见的坑:

proxy_pass http://127.0.0.1:8081/;

和:

proxy_pass http://127.0.0.1:8081;

语义完全不同。


4. 静态资源 CSS / JS 404

路径部署时经常遇到。

如果访问:

/app-a/

页面里引用资源还是:

/assets/app.js

浏览器会去请求:

/assets/app.js

而不是:

/app-a/assets/app.js

前端打包时要配置 publicPath 或 base,例如 Vue CLI:

publicPath: '/app-a/'

Vite:

base: '/app-a/'

所以路径部署不光是 Nginx 的事,前端也要配合。


5. 上传文件报 413

Nginx 默认上传大小有限制,可以配置:

client_max_body_size 100m;

放在 http、server 或 location 里都可以,按你的控制粒度来。


十三、最终推荐方案

如果是我来做,一般这样落:

app-a.example.com  -> Nginx -> 127.0.0.1:8081
app-b.example.com  -> Nginx -> 127.0.0.1:8082
admin.example.com  -> Nginx 静态页面 + /api/ -> 127.0.0.1:8083

安全组只开 80/443,SpringBoot 服务绑定 127.0.0.1,systemd 托管,Nginx 做统一反向X_X,HTTPS 在 Nginx 层终结。

这套结构在单机多项目部署里够稳,后续要拆机器、加负载均衡,也只需要改 Nginx 的 upstream。

未经允许不得转载:云服务器 » SpringBoot项目在阿里云服务器上如何通过Nginx实现多项目部署?