
本文详解如何在单台 Nginx 服务器上正确配置两个独立 Web 应用,分别映射到根路径 /(前端)和子路径 /api(后端),避免 root 冲突、静态资源错位及 PHP 路由解析异常。
本文详解如何在单台 nginx 服务器上正确配置两个独立 web 应用,分别映射到根路径 `/`(前端)和子路径 `/api`(后端),避免 root 冲突、静态资源错位及 php 路由解析异常。
在单服务器部署多个 Web 应用时,常见误区是直接在 location 块中使用 root 指令——这会导致路径拼接错误(例如 location /api + root /app/api 实际查找 /app/api/api/xxx)。正确做法是:统一设置主 root 为前端应用目录,并通过 alias 或 rewrite + root 组合精准控制子路径的文件系统映射与 URI 重写。
以下是针对您场景(10.X.X.XX → /app/web,10.X.X.XX/api → /app/api)的生产就绪型 Nginx 配置:
server {
listen 80;
listen [::]:80;
# 推荐显式指定 server_name(如内网 IP 或域名),避免 default_server 冲突
server_name 10.X.X.XX;
# 主应用根目录(/app/web)
root /app/web;
index index.php index.html;
# 【关键】处理根路径请求:优先尝试静态文件,否则交由前端入口(如 Vue Router history 模式)或 index.php
location / {
try_files $uri $uri/ /index.php?$args;
}
# 【关键】处理 /api 子路径:使用 alias(非 root!)精准映射到 /app/api 目录
# 注意:alias 后必须以 / 结尾,且 location 路径(/api)会被完全替换
location /api/ {
alias /app/api/;
# 确保 index 文件在 /app/api/ 下生效
index index.php;
try_files $uri $uri/ /api/index.php?$args;
}
# 【关键】PHP 处理:需区分不同路径的 SCRIPT_FILENAME 和 REQUEST_URI
location ~ \.php$ {
# 根据请求 URI 动态设置 document_root 和 REQUEST_URI
set $fastcgi_root "/app/web";
set $fastcgi_uri $uri;
if ($request_uri ~ ^/api/(.*)$) {
set $fastcgi_root "/app/api";
set $fastcgi_uri /$1;
}
fastcgi_pass php:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $fastcgi_root$fastcgi_script_name;
fastcgi_param REQUEST_URI $fastcgi_uri;
fastcgi_param PATH_INFO $fastcgi_uri;
}
# 安全防护:禁止访问敏感文件
location ~ /\.(ht|env|git|svn) {
deny all;
}
client_max_body_size 10M;
error_log /dev/stderr warn;
access_log /dev/stdout main;
}
✅ 核心要点说明:
-
alias替代root用于子路径:location /api/ { alias /app/api/; }表示所有/api/xxx请求实际从/app/api/xxx读取文件,避免了root的路径叠加问题; -
动态
SCRIPT_FILENAME与REQUEST_URI:通过if判断请求路径,确保 PHP 脚本在/app/api/下正确执行,且框架(如 Laravel、Lumen)能解析原始路径/api/xxx为内部路由/xxx; -
try_files分层兜底:对/api/路径,try_files $uri $uri/ /api/index.php?$args确保静态资源直出,PHP 请求统一交由/app/api/index.php处理; -
安全加固:显式拒绝
.htaccess、.env等敏感文件访问。
⚠️ 注意事项:
- 若后端 API 是纯静态服务(无 PHP),可移除 PHP
location块,仅保留alias配置; - 使用
if指令需谨慎(Nginx 官方不推荐在location外使用),但此处用于fastcgi_param动态赋值属安全场景; - 生产环境建议启用 HTTPS,并添加
add_header X-Content-Type-Options nosniff;等安全头; - 修改后务必执行
nginx -t && nginx -s reload验证并重载配置。
该方案已在多种 PHP 框架(Laravel、Symfony、CodeIgniter)及静态 SPA(React/Vue)+ API 组合中稳定运行,兼顾简洁性与健壮性。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











