Nginx 是 macOS 上轻量高性能的 Web 服务器，推荐通过 Homebrew 安装：先装 Homebrew，再执行 brew install nginx；配置文件位于 /opt/homebrew/etc/nginx/nginx.conf（Apple Silicon）或 /usr/local/etc/nginx/nginx.conf（Intel）；默认监听 8080 端口，根目录为 /opt/homebrew/var/www 或 /usr/local/var/www；启动用 brew services start nginx，访问 http://localhost:8080 验证；修改配置后需 nginx -t 测试并 nginx -s reload 生效；前端资源复制至根目录即可部署；停止用 brew services stop nginx，卸载用 brew uninstall nginx。
如果您在 macOS 系统上需要部署一个轻量、高性能的 Web 服务器用于本地开发或静态资源托管，则 Nginx 是一个常用选择。以下是适用于 macOS 的 Nginx 安装与基础配置操作步骤：
一、安装 Homebrew（包管理工具）
Homebrew 是 macOS 上最主流的命令行软件包管理器，Nginx 依赖它进行便捷安装。若系统尚未安装 Homebrew，需先完成此步骤。
1、打开终端（Terminal）应用。
2、执行以下命令下载并安装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3、安装完成后，运行 brew --version 验证是否成功输出版本号。
二、通过 Homebrew 安装 Nginx
使用 Homebrew 可自动处理依赖、路径及权限问题，避免手动编译的复杂性，并适配 Apple Silicon（M1/M2/M3）与 Intel 架构。
1、在终端中执行安装命令：
brew install nginx
2、安装成功后，确认版本信息：
nginx -v
3、查看安装详情以获知关键路径：
brew info nginx
默认配置文件路径为：/opt/homebrew/etc/nginx/nginx.conf（Apple Silicon）或 /usr/local/etc/nginx/nginx.conf（Intel）；网页根目录为：/opt/homebrew/var/www 或 /usr/local/var/www。
三、启动并验证 Nginx 服务
启动 Nginx 后，可通过本地浏览器访问默认欢迎页，确认服务已正常响应请求。
1、使用 Homebrew 服务方式启动（推荐，支持后台常驻与开机自启）：
brew services start nginx
2、或使用原生命令手动启动（无需 sudo，因默认监听端口为 8080）：
nginx
3、打开浏览器，访问：http://localhost:8080。
4、若页面显示 “Welcome to nginx!”，则表明安装与启动成功。
四、修改默认配置文件
编辑主配置文件可调整监听端口、网站根目录、虚拟主机等核心行为，是实现定制化服务的前提。
1、用文本编辑器打开配置文件（以 Apple Silicon 为例）：
nano /opt/homebrew/etc/nginx/nginx.conf
2、定位到 server 块，修改 listen 和 root 指令，例如：
listen 8080;
root /opt/homebrew/var/www;
3、保存退出（nano 中按 Ctrl+O → Enter → Ctrl+X）。
4、测试配置语法是否正确：
nginx -t
5、重载配置使变更生效：
nginx -s reload
五、部署前端静态资源
将构建后的前端项目（如 Vue/React 的 dist 目录）放入 Nginx 根目录，即可通过 HTTP 访问。
1、进入构建产物目录（假设为当前目录下的 dist）：
cd dist
2、将所有文件（非文件夹本身）复制到 Nginx 默认网页根目录：
cp -r * /opt/homebrew/var/www/
3、确保 index.html 存在于该目录下，且配置中已设置 index index.html;。
六、停止与卸载 Nginx
当不再需要 Nginx 服务时，可安全终止进程或彻底移除软件及其配置。
1、停止服务（Homebrew 方式）：
brew services stop nginx
2、或强制终止所有 Nginx 进程：
pkill nginx
3、卸载 Nginx 软件包：
brew uninstall nginx
4、如需清除残留配置与网页文件，手动删除对应路径：
rm -rf /opt/homebrew/etc/nginx /opt/homebrew/var/www
