在同一个服务器(无论是物理机、虚拟机还是云服务器 ECS/CVM)上部署多个 Spring Boot 项目,是中小团队或初创公司节省成本的常见做法。核心思路其实就两点:端口隔离 + 资源隔离。
下面我从最基础到生产环境推荐的做法,分层次给你梳理一下。别整那些虚的,直接上干货。
一、 最基础方案:修改端口号 + Nginx 反向XX
这是最简单、成本最低的方案,适合个人开发者或小规模内部系统。
1. 修改 Spring Boot 端口
Spring Boot 默认占用 8080 端口。如果你要在同一台机器跑两个项目,必须改端口。
- 方法 A:配置文件
在application.yml或application.properties中指定不同端口:server: port: 8081 # 项目A --- server: port: 8082 # 项目B - 方法 B:启动参数(推荐)
打包成 jar 后,启动时通过命令行覆盖:java -jar projectA.jar --server.port=8081 java -jar projectB.jar --server.port=8082
2. 安装 Nginx 做反向XX
用户访问域名时,不能让用户去记 http://ip:8081 和 http://ip:8082。你需要一个网关入口。
假设你有两个域名:api.a.com 和 api.b.com,或者你想用路径区分 /a 和 /b。
以子域名为例,Nginx 配置大致如下:
# 项目A
server {
listen 80;
server_name api.a.com;
location / {
proxy_pass http://127.0.0.1:8081;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
# 项目B
server {
listen 80;
server_name api.b.com;
location / {
proxy_pass http://127.0.0.1:8082;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
优点:简单,无需额外组件,调试方便。
缺点:没有进程守护,服务挂了不会自动重启;日志分散;无法优雅停机;如果某个项目内存泄漏,容易拖垮整个服务器。
二、 进阶方案:Systemd 进程守护 + 日志管理
生产环境绝对不能只靠 nohup java & 或者手动敲命令启动。你需要让操作系统来管理这些 Java 进程。
1. 创建 Systemd Service 文件
为每个项目创建一个 .service 文件,放在 /etc/systemd/system/ 下。
例如 project-a.service:
[Unit]
Description=Spring Boot Project A
After=syslog.target network.target
[Service]
User=root
Group=root
ExecStart=/usr/bin/java -Xms512m -Xmx1g -jar /opt/apps/projectA.jar
SuccessExitStatus=143
TimeoutStopSec=10
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
-Xms和-Xmx一定要根据服务器内存合理设置,防止 OOM(内存溢出)。Restart=on-failure保证服务崩溃后能自动拉起。
然后执行:
systemctl daemon-reload
systemctl enable project-a
systemctl start project-a
2. 日志收集
Systemd 会自动将 stdout/stderr 写入 journal。你可以用 journalctl -u project-a -f 查看实时日志。
但为了方便排查,建议结合 Logback 或 Log4j2 将日志输出到独立文件,并配合 logrotate 进行日志切割,避免磁盘写满。
优点:稳定,具备自愈能力,符合 Linux 运维规范。
缺点:多实例监控稍显麻烦;资源竞争问题依然存在。
三、 高级方案:Docker 容器化部署(强烈推荐)
现在国内主流的云厂商(阿里云、腾讯云、华为云等)都重度推崇容器化。即使你不用 Kubernetes (K8s),单台服务器上用 Docker Compose 也是最佳实践。
为什么选 Docker?
- 环境隔离:每个项目有独立的 JDK、依赖库,互不干扰。
- 资源限制:可以精确控制每个容器占用的 CPU 和内存。
- 快速迁移:换一台服务器,只需拷贝镜像或代码重新 build,完全一致。
使用 Docker Compose 编排
在项目根目录创建 docker-compose.yml:
version: '3'
services:
project-a:
image: openjdk:17-jdk-slim
container_name: spring-boot-a
ports:
- "8081:8081"
volumes:
- ./logs-a:/app/logs
command: java -Xms256m -Xmx512m -jar /app/projectA.jar
restart: always
networks:
- backend
project-b:
image: openjdk:17-jdk-slim
container_name: spring-boot-b
ports:
- "8082:8082"
volumes:
- ./logs-b:/app/logs
command: java -Xms256m -Xmx512m -jar /app/projectB.jar
restart: always
networks:
- backend
networks:
backend:
driver: bridge
启动命令:
docker-compose up -d
优点:隔离性最好,资源可控,部署标准化。
缺点:需要学习 Docker 基本操作;对新手有一定门槛。
四、 避坑指南 & 关键注意事项
不管你用哪种方案,在同一台服务器上部署多个项目,必须注意以下几点:
1. 内存管理(OOM Killer)
Java 应用是内存大户。如果你的服务器只有 4G 内存,不要指望能同时跑三个重型 Spring Boot 应用。
- 计算方式:总内存 = JVM堆内存 + 非堆内存(Metaspace等) + 操作系统开销。
- 建议:每个项目的
-Xmx总和不能超过服务器物理内存的 70%-80%。否则 Linux 内核会触发 OOM Killer,随机杀掉进程,导致服务不可用。
2. 端口冲突
确保所有项目的 server.port 不重复,且不与 Nginx(通常 80)、MySQL(通常 3306)、Redis(通常 6379)等其他服务端口冲突。
3. 静态资源与跨域
- 如果使用 Nginx 反向XX,记得处理前端跨域问题(CORS)。
- 如果项目本身提供静态页面,注意 Nginx 的
location配置优先级,避免静态资源请求被错误转发给后端。
4. 安全组与防火墙
- 云服务器特有:在阿里云/腾讯云控制台,务必检查“安全组”规则。
- 内网端口(如 8081, 8082)不需要在安全组开放,因为 Nginx 和内网数据库可以通过
localhost或内网 IP 通信。 - 网络端口(如 80, 443)必须开放,否则外部用户无法访问。
- 切记:不要把 8081 直接暴露在公网!这极其危险,容易被扫描攻击。
5. 数据库连接池
多个项目共用一个 MySQL 实例时,注意连接池大小。如果每个项目都配了最大 50 个连接,总共就是 150 个连接。虽然 MySQL 默认支持几千连接,但高频上下文切换会影响性能。适当调小每个项目的 spring.datasource.hikari.maximum-pool-size。
总结建议
- 个人练习/小 Demo:直接用 方案一(改端口+Nginx),最快最省事。
- 正式生产环境(单机版):无脑选择 方案三(Docker Compose)。它提供了最好的隔离性和可维护性,未来如果想扩容,从单机迁移到 K8s 或 ECS 集群也平滑得多。
- 如果项目数量超过 5-10 个:考虑拆分服务器,或者引入轻量级微服务治理工具,单机硬扛会越来越痛苦。
希望这些内容能帮到你。如果有具体的报错或配置问题,可以再追问。
云技术博客