核心思路:
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。
云服务器