Nginx + Spring Boot 反向代理 Demo

这是一个使用 Nginx 作为反向代理服务器的 Spring Boot 应用示例。

项目结构

.
├── backend/           # Spring Boot 后端服务
├── frontend/          # 前端静态文件
├── nginx/            # Nginx 配置文件
│   └── default.conf  # Nginx 主配置文件
└── docker-compose.yml # Docker 编排配置

快速开始

1. 单独运行后端服务

# 进入后端目录
cd backend

# 运行 Spring Boot 应用
./gradlew bootRun

2. 单独运行 Nginx

# 停止并删除现有容器（如果有）
docker stop $(docker ps -q --filter ancestor=nginx:alpine)
docker rm $(docker ps -a -q --filter ancestor=nginx:alpine)

# 运行 Nginx 容器
docker run -d \
  -p 80:80 \
  -v $(pwd)/nginx/default.conf:/etc/nginx/conf.d/default.conf \
  -v $(pwd)/frontend:/var/www/frontend \
  --add-host=host.docker.internal:host-gateway \
  nginx:alpine

3. 使用 Docker Compose 运行（推荐）

# 启动所有服务
docker-compose up --build

# 停止服务
docker-compose down

测试步骤

1. 测试后端服务

# 直接访问后端服务
curl http://localhost:8080/api/hello
# 预期输出: "Hello from Spring Boot!"

2. 测试 Nginx 代理

# 测试前端页面
curl http://localhost
# 应该返回 index.html 的内容

# 测试 API 代理
curl http://localhost/api/hello
# 预期输出: "Hello from Spring Boot!"

3. 浏览器测试

1. 打开浏览器访问 http://localhost
2. 点击"请求后端"按钮
3. 应该看到后端返回的消息

4. 查看日志

# 查看 Nginx 容器日志
docker logs $(docker ps -q --filter ancestor=nginx:alpine)

# 查看后端服务日志
# 在运行后端服务的终端中查看

# 查看 Nginx 访问日志
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) tail -f /var/log/nginx/access.log

# 查看 Nginx 错误日志
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) tail -f /var/log/nginx/error.log

常见问题排查

1. 404 错误

# 检查后端服务是否运行
curl http://localhost:8080/api/hello

# 检查 Nginx 配置
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) nginx -t

# 检查前端文件是否存在
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) ls -l /var/www/frontend

2. CORS 错误

# 检查 Nginx CORS 配置
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) cat /etc/nginx/conf.d/default.conf | grep CORS

# 检查响应头
curl -I http://localhost/api/hello

3. 中文乱码

# 检查字符编码设置
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) cat /etc/nginx/conf.d/default.conf | grep charset

# 检查响应头
curl -I http://localhost

4. 连接超时

# 检查后端服务是否可访问
curl -v http://localhost:8080/api/hello

# 检查网络连接
docker exec -it $(docker ps -q --filter ancestor=nginx:alpine) ping host.docker.internal

配置说明

Nginx 配置

• 监听端口：80
• 前端静态文件目录：/var/www/frontend
• API 代理路径：/api/
• 后端服务地址：http://host.docker.internal:8080
• 字符编码：UTF-8
• CORS 配置：允许所有来源
• 静态资源缓存：30天
• 超时设置：60秒

后端配置

• 服务端口：8080
• API 基础路径：/api
• 示例接口：/api/hello

性能优化

1. Nginx 优化

   • 已配置 gzip 压缩
   • 静态资源缓存
   • 连接超时设置

2. Docker 优化

   • 使用 Alpine 基础镜像
   • 配置数据卷持久化
   • 服务自动重启

开发建议

1. 本地开发

   • 建议先单独运行后端服务进行调试
   • 使用 Docker 运行 Nginx 进行代理测试
   • 确认功能正常后再使用 docker-compose

2. 生产部署

   • 配置 HTTPS
   • 设置适当的日志级别
   • 配置监控和告警
   • 考虑使用 CI/CD 流程

扩展功能

1. 安全增强

   • 配置 SSL 证书
   • 添加请求限流
   • 配置 CORS 策略

2. 监控和日志

   • 配置日志收集
   • 添加性能监控
   • 设置健康检查

3. 高可用

   • 配置负载均衡
   • 设置服务自动扩缩容
   • 实现故障转移

参考文档

• Nginx 官方文档
• Spring Boot 文档
• Docker 文档
• Docker Compose 文档

docker

1. 启动项目：

   在项目根目录运行：

   docker-compose up --build

2. 访问服务：

   • 前端：http://localhost
   • 后端 API：http://localhost/api/

3. 注意事项：

   • 确保后端应用的 application.properties/application.yml 中配置了正确的端口（8080）
   • 前端项目中的 API 请求地址应该使用相对路径（以 /api 开头）
   • 如果需要 HTTPS，需要额外配置 SSL 证书和 Nginx SSL 设置

4. 可选优化：

   • 可以添加 Docker 健康检查
   • 可以添加数据持久化配置
   • 可以配置日志收集
   • 可以添加监控配置