源码安装Nginx后需手动创建符号链接才能全局调用,推荐执行sudo ln -sf /usr/local/nginx/sbin/nginx /usr/local/bin/nginx,再运行nginx -v和nginx -t验证生效。

源码安装 Nginx 后,默认不会自动创建全局可调用的 nginx 命令,所以执行 nginx -v 或 nginx -t 会提示 command not found。解决方法是手动建立符号链接,让系统能在任意路径下识别并运行 nginx。
确认安装路径与二进制文件位置
源码安装通常指定 --prefix=/usr/local/nginx,因此主程序位于:
-
/usr/local/nginx/sbin/nginx(标准路径) - 少数情况下可能是
/usr/local/nginx/nginx(取决于 configure 时是否用--sbin-path显式指定)
先验证是否存在:
ls -l /usr/local/nginx/sbin/nginx
若输出显示该文件存在且有执行权限,说明编译安装成功。
选择合适的 bin 目录做软链
Linux/macOS 系统默认在以下路径搜索命令:
-
/usr/local/bin(推荐,无需 root 权限即可写入,且对所有用户生效) -
/usr/bin(需 root 权限,部分发行版限制写入) -
/opt/homebrew/bin(仅 macOS Apple Silicon,Homebrew 默认路径)
建议优先使用 /usr/local/bin:
sudo ln -sf /usr/local/nginx/sbin/nginx /usr/local/bin/nginx
验证链接是否生效
执行后立即测试:
nginx -v<br>nginx -t
若显示版本号和配置语法检查通过,说明符号链接已生效。也可用以下命令确认链接指向正确:
which nginx<br>ls -l $(which nginx)
补充:避免冲突与权限问题
如果之前用 Homebrew 安装过 Nginx,可能已有同名链接。可先清理旧链接:
- 查旧链接:
ls -l /usr/local/bin/nginx或ls -l /opt/homebrew/bin/nginx - 删除旧链:
sudo rm /usr/local/bin/nginx - 确保
/usr/local/bin在你的$PATH中(一般默认包含);如无,可加到~/.zshrc或~/.bashrc:
export PATH="/usr/local/bin:$PATH"
然后执行 source ~/.zshrc 生效。


















