MacOS下Nginx反向代理基础配置与测试教程-Nginx-PHP中文网

在 macOS 上用 Nginx 做反向代理只需三步：用 Homebrew 安装 Nginx，编辑 nginx.conf 添加 server 块配置 proxy_pass 到本地 3000 端口并设置必要 header，最后 sudo nginx -t 检查语法后 reload 启动。

macos下nginx反向代理基础配置与测试教程

在 macOS 上用 Nginx 做反向代理，核心就三步：装好 Nginx、改配置文件、启动并验证。重点不是功能多全，而是让请求能正确转发到后端服务（比如本地的 3000 端口或测试服务器），同时避免常见权限、路径和语法错误。

安装与基础启动

推荐用 Homebrew 安装，简单稳定：

brew install nginx —— 默认装到 /opt/homebrew/etc/nginx/（Apple Silicon）或 /usr/local/etc/nginx/（Intel）
brew services start nginx 或手动运行 sudo nginx 启动（注意：macOS Catalina 及以后，Nginx 需要 root 权限监听 80 端口）
访问 http://localhost:8080（Homebrew 默认监听 8080）看欢迎页，确认服务跑起来了

写一个最简反向代理配置

编辑主配置文件 nginx.conf，在 http { ... } 块内添加一个 server 块：

server {
    listen       8080;
    server_name  localhost;
<pre class="brush:php;toolbar:false;">location / {
    proxy_pass         http://127.0.0.1:3000;  # 假设你的前端或 API 在本地 3000 端口
    proxy_set_header   Host $host;
    proxy_set_header   X-Real-IP $remote_addr;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header   X-Forwarded-Proto $scheme;
}

}

proxy_pass 后不能带尾部斜杠（http://127.0.0.1:3000/）除非你明确想截断路径；不加更安全
必须加 proxy_set_header，否则后端可能收不到原始 Host 或客户端 IP
改完配置后执行 sudo nginx -t 检查语法，再 sudo nginx -s reload 生效

常见问题与快速排查

如果访问 8080 没反应或报 502，按顺序检查这几项：

后端服务（如 npm start 启动的 React App）是否真在 127.0.0.1:3000 运行？用 curl http://127.0.0.1:3000 直连试试
Nginx 日志在哪？默认是 /opt/homebrew/var/log/nginx/error.log（Apple Silicon），看有没有 connection refused 或 permission denied
防火墙或 macOS 隐私设置是否阻止了 Nginx？可在「系统设置 → 隐私与安全性 → 完全磁盘访问」里添加终端或 Nginx
如果想监听 80 端口，必须用 sudo nginx 启动，并确保没被其他服务（如 Apache）占用