努力
加油

如何在同一个服务器上部署多个Spring Boot项目?

在同一个服务器(无论是物理机、虚拟机还是云服务器 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?

  1. 环境隔离:每个项目有独立的 JDK、依赖库,互不干扰。
  2. 资源限制:可以精确控制每个容器占用的 CPU 和内存。
  3. 快速迁移:换一台服务器,只需拷贝镜像或代码重新 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 个:考虑拆分服务器,或者引入轻量级微服务治理工具,单机硬扛会越来越痛苦。

希望这些内容能帮到你。如果有具体的报错或配置问题,可以再追问。