XAMPP 默认不带 Nginx，仅含 Apache；若强行在 XAMPP 目录部署 Nginx，需避开 80/443 端口，独立配置 upstream 与 server 块，并通过 hosts 绑定域名，配合 proxy_pass 实现反向代理。
XAMPP 默认不带 Nginx，直接在 XAMPP 里配 Nginx 反向代理是行不通的。 它自带的是 Apache，不是 Nginx。想用 Nginx 做反向代理，得手动引入独立 Nginx 实例，且必须避开 Apache 占用的 80/443 端口，否则启动就失败。
为什么不能直接改 XAMPP 自带的 nginx.conf
XAMPP for Windows 安装包（截至 2026 年）官方版本中不含 Nginx 组件。你看到的 nginx.conf 文件，大概率是你自己下载、解压并放进 XAMPP 目录的独立 Nginx，或者从其他渠道混入的配置残留。XAMPP 控制面板也完全不会识别或管理它。
- Apache 默认监听
80和443端口，Nginx 若也设为listen 80，启动时会报错：bind() to 0.0.0.0:80 failed (10013: An attempt was made to access a socket in a way forbidden by its access permissions) - XAMPP 的服务注册、环境变量、日志路径、SSL 证书位置（如
\xampp\apache\conf\ssl.crt）全部面向 Apache，Nginx 无法自动复用 - 没有
httpd-xampp.conf对应的nginx-xampp.conf，所有配置需手工维护
正确做法：独立部署 Nginx 并代理本地多端口服务
假设你已在本机运行了多个开发服务（比如前端 localhost:3000、后端 API localhost:8080、管理后台 localhost:9001），目标是用一个域名（如 dev.local）通过不同路径访问它们——这才是典型的 Nginx 反向代理场景。
- 下载官方 Nginx Windows 版（
nginx-1.24.0.zip或更新版），解压到非 XAMPP 目录，例如C:\nginx - 修改
C:\nginx\conf\nginx.conf，删掉默认server块，替换为：
upstream frontend {
server localhost:3000;
}
upstream api {
server localhost:8080;
}
upstream admin {
server localhost:9001;
}
<p>server {
listen 8081; # 避开 Apache 的 80
server_name dev.local;</p><pre class='brush:php;toolbar:false;'>location / {
proxy_pass http://frontend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /api/ {
proxy_pass http://api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /admin/ {
proxy_pass http://admin/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}}
- 确保
dev.local已写入C:\Windows\System32\drivers\etc\hosts：127.0.0.1 dev.local - 命令行进入
C:\nginx，执行：start nginx（首次用nginx -t测试语法） - 浏览器访问
http://dev.local:8081、http://dev.local:8081/api/users、http://dev.local:8081/admin，验证是否分别命中对应端口
和 Apache 共存时最关键的三个避坑点
你在 XAMPP 里开着 Apache，又想跑 Nginx，以下三点不处理，必出问题：
-
端口冲突必须显式规避：Nginx 的
listen不能写80或443，推荐用8081、8082或9000等高位端口；如果硬要占 80，必须先停掉 Apache（xampp-control.exe → Apache → Stop） -
proxy_pass 尾部斜杠决定路径重写行为：写成
proxy_pass http://localhost:3000/;（结尾有/），则location /api/会把/api/剪掉再转发；写成proxy_pass http://localhost:3000;（无/），则整个路径原样透传，后端需自行处理/api/xxx -
Windows 下路径分隔符和权限容易被忽略：Nginx 日志路径如
logs/error.log在 Windows 上实际生成在C:\nginx\logs\，若目录不存在或权限受限，nginx -t可能通过但start nginx启动失败，且无明确错误提示
真正麻烦的从来不是写几行 proxy_pass，而是搞清哪个进程占着端口、哪条路径被 Windows 权限拦住、以及斜杠加不加到底影响什么。这些细节不验一遍，配置永远在“看起来对”和“实际不通”之间反复横跳。
