在 macOS 上用 Nginx 做反向代理只需三步：用 Homebrew 安装 Nginx，编辑 nginx.conf 添加 server 块配置 proxy_pass 到本地 3000 端口并设置必要 header，最后 sudo nginx -t 检查语法后 reload 启动。
在 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）占用
进阶小提示：支持 HTTPS 和多个服务
开发阶段不需要证书，但若想模拟生产环境，可用 mkcert 快速生成本地可信证书：
- brew install mkcert nss → mkcert -install → mkcert localhost
- 在 server 块中加入 listen 443 ssl;，并指定 ssl_certificate 和 ssl_certificate_key
- 多个服务？比如把 /api/ 转给后端，/admin/ 转给另一个地址，就用不同 location 块区分，注意路径匹配优先级
不复杂但容易忽略细节。配好后 curl 一下、浏览器打开看看、再翻翻 error.log，基本就能稳住反向代理这一步了。
