在 macOS 上彻底卸载 Nginx 需三步:先停止服务(sudo nginx -s stop 或 pkill),再按安装方式卸载主程序(Homebrew 用 brew uninstall,源码删目录,pkg 拖废纸篓),最后清除配置、日志及 launchd 启动项。

在 macOS 上彻底卸载 Nginx 并清除所有配置文件,需分三步操作:停止服务、卸载主程序、删除残留配置与数据。具体取决于你当初是通过 Homebrew、源码编译还是官方 pkg 安装的。以下以最常见方式(Homebrew)为主,同时涵盖其他情况的处理要点。
确认安装方式并停止 Nginx 服务
先判断 Nginx 是如何安装的,再安全终止运行:
- 运行 brew list nginx,若显示 nginx,说明是 Homebrew 安装;
- 若提示“Error: No such keg”,可能是源码安装(如
/usr/local/nginx)或 pkg 安装(默认路径为/opt/homebrew/或/usr/local/); - 无论哪种方式,先执行 sudo nginx -s stop 或 sudo pkill nginx 停止进程;
- 检查是否还有残留:ps aux | grep nginx,若有,用 sudo kill -9 [PID] 强制结束。
卸载 Nginx 主程序
根据安装来源选择对应命令:
- Homebrew 安装:运行 brew uninstall nginx;
-
源码编译安装:若记得编译路径(如
/usr/local/nginx),直接删目录:sudo rm -rf /usr/local/nginx; - pkg 官方安装包:打开「访达」→「应用程序」→ 找到「Nginx」图标 → 右键「移到废纸篓」;也可用终端执行:sudo /usr/local/nginx/uninstall(如有提供卸载脚本)。
清除所有配置、日志与缓存文件
Nginx 配置和日志通常分散在多个位置,需手动清理:
- 主配置目录(常见):sudo rm -rf /usr/local/etc/nginx(Homebrew 默认)、/opt/homebrew/etc/nginx(Apple Silicon M 系列芯片);
- 日志文件:sudo rm -f /usr/local/var/log/nginx/* 或 /opt/homebrew/var/log/nginx/*;
- 临时文件与缓存:sudo rm -rf /usr/local/var/run/nginx*;
- 检查用户级配置:~/nginx.conf 或 ~/.nginx/(极少见,但可快速搜:find ~ -name "*nginx*" -type d 2>/dev/null);
- 若曾用 launchd 自启(如
homebrew.mxcl.nginx.plist),删掉:launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist,再删该文件。
验证是否卸载干净
执行以下命令确认无残留:
-
nginx -v → 应提示
command not found; - brew services list | grep nginx → 无输出;
- ls /usr/local/etc/ | grep nginx 和 ls /opt/homebrew/etc/ | grep nginx → 均无结果;
- sudo lsof -i :80 或 :443 → 不再显示 nginx 进程。
不复杂但容易忽略的是配置目录和 launchd 启动项。只要按路径逐项清理,就能确保 macOS 上 Nginx 彻底退出系统。










