1. 同域名多路径部署的核心挑战

在现代Web应用部署中，我们经常遇到这样的需求：同一个域名下需要部署多个独立的前后端应用，这些应用可能分属不同团队开发、采用不同技术栈，但需要共享同一个域名。比如公司官网（www.example.com）可能需要同时承载主站（/）、管理后台（/admin）、客户门户（/portal）等多个子系统。

这种部署方式面临几个关键问题：

1. 路径冲突风险：不同应用可能使用相同的URL路径（如都定义了/login路由）
2. 静态资源管理：各应用的JS/CSS等资源文件需要隔离避免命名冲突
3. 路由模式适配：特别是前端SPA应用，需要正确处理HTML5 History模式
4. 会话隔离需求：不同子系统可能需要独立的会话管理

2. Nginx基础配置策略

2.1 静态资源服务配置

对于前后端分离的典型架构，Nginx需要同时处理：

• 前端静态文件（HTML/JS/CSS）
• 后端API请求转发
• Websocket等特殊协议

基础配置模板如下：

server { listen 80; server_name example.com; # 前端静态资源 location / { root /var/www/frontend; try_files $uri $uri/ /index.html; } # 后台管理界面 location /admin { alias /var/www/admin; try_files $uri $uri/ /admin/index.html; } # 后端API转发 location /api { proxy_pass http://backend_server; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

关键配置说明：

• try_files指令确保前端路由能正确回退到index.html
• alias与root的区别：alias会完全替换匹配路径，root会追加匹配路径
• 对于Vue/React等SPA应用，必须配置HTML5 History模式支持

2.2 路径匹配优先级规则

Nginx的location匹配遵循以下优先级顺序：

1. 精确匹配（location = /path）
2. 前缀匹配（location ^~ /prefix）
3. 正则匹配（location ~ /regex）
4. 普通前缀匹配（location /path）

实际配置示例：

location = /login { # 精确匹配/login路径 proxy_pass http://auth_service; } location ^~ /static { # 优先匹配/static前缀 root /var/www/shared_static; } location ~ /api/v[1-9] { # 正则匹配API版本路径 proxy_pass http://api_gateway; }

3. 高级路由配置技巧

3.1 动态路径映射

对于需要动态部署多套环境的场景（如测试环境、预发环境），可以使用正则捕获：

location ~ ^/env/(?<env_name>[^/]+)/admin { alias /var/www/$env_name/admin; try_files $uri $uri/ /$env_name/admin/index.html; # 环境特定配置 if ($env_name = "staging") { add_header X-Environment "STAGING"; } }

这种配置允许通过URL路径动态切换部署环境：

• /env/prod/admin -> 生产环境后台
• /env/staging/admin -> 预发环境后台

3.2 微前端架构支持

现代微前端架构下，可能需要更复杂的路径处理：

location ~ ^/app/([^/]+) { # 提取子应用名称 set $subapp $1; # 检查子应用目录是否存在 if (!-d "/var/www/subapps/$subapp") { return 404; } # 动态设置root路径 root /var/www/subapps/$subapp/dist; # 特殊处理主入口文件 location ~ ^/app/$subapp/(.*)$ { try_files $1 $1/ /index.html; } # 静态资源缓存配置 location ~* \.(js|css|png)$ { expires 1y; add_header Cache-Control "public"; } }

4. 安全与性能优化

4.1 安全防护配置

# 禁止访问隐藏文件 location ~ /\. { deny all; } # API路径防爬虫 location /api { # 限制请求方法 limit_except GET POST PUT DELETE { deny all; } # 速率限制 limit_req zone=api burst=10 nodelay; # CORS配置 add_header 'Access-Control-Allow-Origin' '$http_origin'; add_header 'Access-Control-Allow-Credentials' 'true'; proxy_pass http://api_server; }

4.2 缓存策略优化

针对不同资源类型设置差异化缓存：

# 永久缓存带hash的资源 location ~* \.[a-f0-9]{8}\.(js|css|png|jpg)$ { expires max; add_header Cache-Control "public, immutable"; } # 不缓存HTML文件 location ~* \.html$ { expires -1; add_header Cache-Control "no-store"; } # 接口数据缓存 location ~ /api/cacheable { proxy_cache api_cache; proxy_cache_valid 200 5m; proxy_cache_key "$scheme$request_method$host$request_uri"; }

5. 实战问题排查指南

5.1 常见问题与解决方案

5.2 调试技巧

1. 日志分析：

   log_format debug '$remote_addr - $request [$status] ' '"$http_referer" "$http_user_agent" ' 'PATH: $request_uri ALIAS: $alias'; location / { access_log /var/log/nginx/debug.log debug; # ... }

2. 变量检查：

   location /test { return 200 "URI: $uri\nDOC_ROOT: $document_root\nREQ_PATH: $request_filename"; }

3. 重写规则测试：

   location /rewrite-test { rewrite ^/rewrite-test/(.*)$ /newpath/$1 break; proxy_pass http://backend; }

6. 现代部署方案演进

6.1 Docker化部署

使用Docker Compose管理多套环境：

version: '3' services: nginx: image: nginx:alpine volumes: - ./nginx.conf:/etc/nginx/nginx.conf - ./frontend:/var/www/frontend - ./admin:/var/www/admin ports: - "80:80" networks: - app_net backend: image: backend:latest networks: - app_net networks: app_net: driver: bridge

对应的Nginx配置需要适配容器网络：

upstream backend { server backend:3000; } server { location /api { proxy_pass http://backend; } }

6.2 自动化部署脚本

结合CI/CD的部署脚本示例：

#!/bin/bash # 同步前端构建产物 rsync -avz --delete ./dist/ user@server:/var/www/${APP_ENV}/frontend/ # 动态生成Nginx配置 envsubst < nginx.template > /etc/nginx/conf.d/${APP_ENV}.conf # 优雅重载配置 nginx -t && nginx -s reload || echo "Reload failed"

对应的模板文件nginx.template：

server { listen 80; server_name ${DOMAIN}; location / { root /var/www/${APP_ENV}/frontend; try_files $uri $uri/ /index.html; } }