讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

Nginx 配置单服务器托管两个 Web 应用(/ 和 /api 路径分离)

小萱同学_9376

小萱同学_9376

发布时间:2026-11-22 13:51:13

|

816人浏览过

|

来源于php中文网

原创

Nginx 配置单服务器托管两个 Web 应用(/ 和 /api 路径分离)

本文详解如何在单台 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;
}

✅ 核心要点说明:

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载
  • 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 组合中稳定运行,兼顾简洁性与健壮性。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

相关专题

更多
开发工具有哪些
开发工具有哪些

开发工具有:1、集成开发环境IDE;2、版本控制系统VCS;3、自动化构建工具;4、测试工具;5、代码分析工具。本专题为大家提供开发工具有哪些的相关的文章、下载、课程内容,供大家免费下载体验。

3446

2023.08.02

服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

477

2023.08.15

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

1020

2023.09.08

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

3792

2023.09.19

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

1236

2023.10.09

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

1109

2023.10.17

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

574

2023.10.17

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

3516

2023.10.18

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

0

2026.11.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn