Mac通过homebrew安装nginx并进行相应配置修改

Mac可以像windows那样下载nginx压缩包解压启动，但是需要进行一些配置，本文介绍通过homebrew安装以及配置：

一.安装 Nginx

brew install nginx

安装完成验证版本：

nginx -v

路径区分（重点）--本文展示M芯片路径

  • M1/M2/M3(Apple Silicon)
    主配置：/opt/homebrew/etc/nginx/nginx.conf
    静态资源目录：/opt/homebrew/var/www
  • Intel 老 Mac
    主配置：/usr/local/etc/nginx/nginx.conf
    静态资源目录：/usr/local/var/www

 

二.启停常用命令（两套用法）

1、brew 托管（开机自启，推荐） 

brew services start nginx    # 启动(后台常驻)
brew services stop nginx     # 停止
brew services restart nginx # 重启
2、nginx 原生命令（临时运行）
nginx                  # 启动
nginx -s stop          # 立刻停止
nginx -s quit          # 优雅停机(处理完现有请求)
nginx -s reload        # 修改配置后重载(不用重启)
nginx -t               # 校验配置文件语法（改完配置必测）

三.验证安装成功

启动后浏览器打开：
http://localhost:8080
出现 Welcome to nginx! 页面 = 安装成功（brew 默认端口 8080，非 80）
 

image

 

四.卸载 nginx

brew uninstall nginx
# 删除配置文件夹（nginx.conf所在） 
sudo rm -rf /opt/homebrew/etc/nginx 
# 删除日志 
sudo rm -rf /opt/homebrew/var/log/nginx 
# 删除默认网站目录 
sudo rm -rf /opt/homebrew/var/www 
# 删除启动plist文件 
rm -f ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist 
sudo rm -f /Library/LaunchDaemons/homebrew.mxcl.nginx.plist

清理 brew 缓存

brew cleanup nginx
 

*****端口说明******

看真实端口是多少 cat /opt/homebrew/etc/nginx/nginx.conf | grep listen

image

 

  1. 源码手动编译安装 Nginx（Linux / 通用默认）：80 端口（需要 sudo 管理员权限才能占用 80）
  2. Mac Homebrew 安装 Nginx 默认端口：8080（brew 特意改成 8080，不用 sudo 就能直接启动）
访问地址：http://localhost:8080
修改端口位置：
  • M 芯片：/opt/homebrew/etc/nginx/nginx.conf
  • Intel：/usr/local/etc/nginx/nginx.conf 
    修改listen 8080;改成listen 80;，改完执行nginx -t校验、nginx -s reload生效
检查nginx是否启动：
ps -aef | grep nginx

看结果：

  • 如果出现 2 行以上（包含 master、worker）
    ✅ 说明 Nginx 已经启动
  • 只有一行 grep 内容
    ❌ 没启动

image

 

一键查 nginx 所有监听端口（最推荐）

sudo lsof -P -n -i | grep nginx

image

 

  • -P：端口显示数字不转 http
  • -n：不解析域名，速度快
  • 输出里 *:8080(LISTEN) = 监听 8080 端口
 

2、已知 PID 查端口（ps 拿到 master 进程号后用）

sudo lsof -p 进程PID

3、全系统列出所有监听端口，筛选 nginx

sudo lsof -iTCP -sTCP:LISTEN | grep nginx

======================================================================

Brew 版 Nginx 修改配置全流程（M 芯片 Mac）

 

1、配置路径（M1/M2/M3 固定）

 
主配置：/opt/homebrew/etc/nginx/nginx.conf
 
站点分片配置：/opt/homebrew/etc/nginx/servers/（推荐新建 conf 放这里，不改动主配置）
 
默认网站目录：/opt/homebrew/var/www
 

image

 

 

快捷直接用访达打开文件夹

open /opt/homebrew/etc/nginx/

image

 

 

2、修改配置 3 步规范（必按顺序）

①先备份原配置（改错可还原）

cd /opt/homebrew/etc/nginx
cp nginx.conf nginx.conf.bak 

②编辑文件

# nano简易编辑
nano /opt/homebrew/etc/nginx/nginx.conf
# 或者vim
vim /opt/homebrew/etc/nginx/nginx.conf

小提示 

以后新增多个网站，不要改 nginx.conf，在servers/新建xxx.conf，nginx 会自动引入，方便管理。
 

前端 dist 存放目录（对应你刚才的 nginx 配置）

 
M 芯片 Mac (你现在 brew)：/opt/homebrew/var/www/web
配置里写死：root /opt/homebrew/var/www/web;，所有前端资源丢这里

单独建项目文件夹（多项目时用）

  1. 在 www 新建文件夹，例如 web
mkdir /opt/homebrew/var/www/web
  1. dist 全部丢进 web，需要改配置 root 路径：root /opt/homebrew/var/www/web;

  2. image

     

50x.html 也在同目录

你配置里location = /50x.html {root /opt/homebrew/var/www;}，50x 页面也放这个 www 文件夹即可。

部署完校验

# 校验配置语法
nginx -t
# 重载nginx生效
brew services restart nginx
浏览器访问：http://localhost:9090，前端正常打开；http://localhost:9090/api/xxx自动代理到 8080 后端。
 

image

 

Nginx 多端口写法

不同端口→不同前端 / 不同后端（最常用，新项目推荐放 servers 目录）

你配置末尾自带 include servers/*;，推荐新项目单独拆分配置，不要堆在 nginx.conf 里
新加一个.conf配置，只写server中的内容，不能写完整的 nginx.conf   例如：

image

  1. 创建前端目录，丢第二个项目 dist
mkdir /opt/homebrew/var/www/web2
open /opt/homebrew/var/www/web2 
 
把第二个项目打包后的 dist 全部丢入web2。
 
  1. 第三个端口继续新建site3.conf，listen 9094，root 换 web3 即可。

校验 + 重载命令 

nginx -t                  # 校验配置无误
brew services restart nginx
 目录总结
/opt/homebrew/var/www/
├─ web   → 9090/9091/9092
├─ web2  → 9093
├─ web3  → 9094

Nginx 会把主配置 + servers 里所有配置合并在一起，所有端口同时监听！ 

  • 主配置：9090
  • servers：9091
  • 两个都能访问！

image

 

image

 

posted @ 2026-06-02 09:49  1998青年  阅读(52)  评论(0)    收藏  举报