homebrew 是 macos 安装 nginx 最稳妥方式，5 分钟内可完成安装与启动；默认监听 8080 端口，配置文件和根目录路径因芯片架构（apple silicon/intel）而异，修改后需先 nginx -t 检查语法再重载。

直接用 homebrew 安装 nginx 是 macos 上最稳妥、维护及时的方式，整个过程不依赖 sudo（除首次环境准备外），5 分钟内就能跑起服务。

确认并安装 Homebrew

Homebrew 是 macOS 的核心包管理工具，Nginx 及其依赖（如 OpenSSL、PCRE）都靠它自动处理。

• 终端执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 安装完成后，M 系列芯片 Mac 运行：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc
• 验证：输入 brew --version，有版本号即成功；再运行 brew doctor 检查环境，若提示缺少 Xcode 命令行工具，按提示执行 xcode-select --install

安装并启动 Nginx

Homebrew 安装的 Nginx 默认以普通用户权限运行，监听 8080 端口（避开需要 root 权限的 80 端口，适合日常开发）。

macos-suite-readonly

macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

下载

• 执行：brew install nginx
• 启动服务（后台常驻 + 开机自启）：brew services start nginx
• 验证是否运行：brew services list | grep nginx，状态显示 started 即正常

快速验证与默认路径

安装后无需额外配置即可访问欢迎页，关键路径因芯片架构而异：

• Apple Silicon（M1/M2/M3）：
  配置文件：/opt/homebrew/etc/nginx/nginx.conf
  默认网页根目录：/opt/homebrew/var/www/html
• Intel Mac：
  配置文件：/usr/local/etc/nginx/nginx.conf
  默认网页根目录：/usr/local/var/www/html
• 浏览器打开：http://localhost:8080，看到 “Welcome to nginx!” 即成功

修改配置与重载

改完配置后不能直接重启，必须先检查语法再生效：

• 编辑配置：nano /opt/homebrew/etc/nginx/nginx.conf（或对应路径）
• 修改后先测试语法：nginx -t，输出 “syntax is ok” 和 “test is successful” 才安全
• 重载配置（不停服务）：brew services restart nginx 或 nginx -s reload
• 如需监听 80 端口，必须加 sudo 启动（sudo nginx），但开发阶段不建议