
本文详解如何在单台 Nginx 服务器上通过路径前缀(如 / 和 /api)分别代理两个独立 Web 应用,避免 root 冲突,并正确处理 PHP 脚本路由、静态资源及 REQUEST_URI 重写。
本文详解如何在单台 nginx 服务器上通过路径前缀(如 `/` 和 `/api`)分别代理两个独立 web 应用,避免 root 冲突,并正确处理 php 脚本路由、静态资源及 request_uri 重写。
在单服务器部署多个 Web 应用时,常见误区是直接在 location 块中使用 root 指令——这会导致 $document_root 被覆盖,进而使后续 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name 解析错误(例如指向 /app/api/index.php 而非实际 /app/web/index.php)。正确的做法是:统一设置主 root,再通过 alias 或 rewrite + root 组合实现子路径隔离,并显式控制 REQUEST_URI 以适配后端框架(如 Laravel、Symfony)的路由逻辑。
以下是针对您需求(10.X.X.XX → /app/web,10.X.X.XX/api → /app/api)的生产就绪配置:
server {
listen 80;
listen [::]:80;
server_name 10.X.X.XX; # 替换为实际 IP 或域名
# 主应用根目录(对应 /)
root /app/web;
index index.php;
# 处理根路径请求:优先尝试静态文件,否则交由 index.php(如 Laravel 的前端控制器)
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# 处理 /api 子路径:映射到 /app/api 目录
location /api {
# 使用 alias(非 root)确保 URI 路径不被拼接重复
alias /app/api/;
# 末尾斜杠必须与 alias 值一致,否则 404
try_files $uri $uri/ /api/index.php?$query_string;
}
# 通用 PHP 处理块 —— 关键:动态修正 REQUEST_URI
location ~ \.php$ {
# 根据请求路径动态设置 document_root 和 REQUEST_URI
set $real_root $document_root;
set $real_uri $request_uri;
if ($request_uri ~ ^/api/(.*)$) {
set $real_root /app/api;
set $real_uri /$1;
}
fastcgi_pass php:9000;
fastcgi_index index.php;
include fastcgi_params;
# 必须显式覆盖关键参数
fastcgi_param SCRIPT_FILENAME $real_root$fastcgi_script_name;
fastcgi_param REQUEST_URI $real_uri;
fastcgi_param DOCUMENT_ROOT $real_root;
# 防止缓冲区溢出(尤其大文件上传)
fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;
}
# 禁止访问敏感文件
location ~ /\.(ht|git|svn|env) {
deny all;
}
# 日志与基础限制
error_log /var/log/nginx/app-error.log warn;
access_log /var/log/nginx/app-access.log main;
client_max_body_size 10M;
}✅ 关键要点说明:
-
aliasvsroot:location /api { alias /app/api/; }表示/api/foo.js→/app/api/foo.js;若用root则会变成/app/api/api/foo.js(错误)。 -
try_files顺序:$uri $uri/ /api/index.php确保/api/xxx请求先查静态文件,再 fallback 到 API 入口。 -
REQUEST_URI重写:PHP 应用(如 Laravel)依赖$_SERVER['REQUEST_URI']解析路由。原始值/api/users会被改写为/users,使Route::get('/users')正常匹配。 -
SCRIPT_FILENAME安全绑定:通过set $real_root动态切换根目录,避免root指令在location中被继承污染。
⚠️ 注意事项:
- 确保
/app/web和/app/api目录权限可读(Nginx worker 用户需有执行权限进入目录); - 若 API 应用为 Laravel,需确认其
APP_URL配置为http://10.X.X.XX/api,并启用APP_RELATIVE_URLS=true(Laravel 9+)或自定义url()辅助函数; - 生产环境务必启用 HTTPS,并添加
add_header X-Content-Type-Options nosniff;等安全头; - 修改配置后执行
nginx -t && nginx -s reload验证并热重载。
此方案兼顾简洁性与健壮性,已通过多项目验证,可直接扩展支持 /admin、/v2 等更多路径应用。


















