10分钟搞定 Nginx 安装：Linux/Windows 双平台实测（附避坑指南）

一、前言上一篇我们初识了Nginx——知道了它是高性能的HTTP和反向代理服务器懂了它为什么被99%的互联网公司青睐也明确了我们后续的学习路线。本篇文章将手把手教你在Linux和Windows系统上完成Nginx的安装、部署、启动、停止 同时解决安装过程中最常见的报错全程无冗余、无晦涩新手跟着步骤走10分钟就能搞定看完就能独立操作。读完这篇你能掌握Linux系统CentOS/Ubuntu两种安装方式包管理器源码编译按需选择Windows系统本地测试快速安装与部署Nginx启动、停止、重启的3种核心命令牢记安装/启动时最常见的8个报错一键解决不用查百度验证Nginx是否安装成功的2种方法提前说明日常开发/生产环境90%以上用Linux系统部署NginxWindows系统仅用于本地测试大家可根据自己的需求重点学习对应系统的安装步骤。二、前置准备无论哪种系统安装前做好以下准备能减少80%的报错Linux系统确保服务器能正常联网安装需要下载依赖拥有root权限执行安装命令需要Windows系统确保系统是Win10及以上版本解压路径不要有中文、空格比如不要放在“桌面/我的软件”建议放在D盘根目录通用关闭不必要的防火墙Linux或杀毒软件Windows避免拦截安装/启动进程。三、Linux系统安装NginxLinux系统推荐两种安装方式新手优先选包管理器安装简单、快捷、自动配置依赖有自定义需求比如指定安装目录、添加特殊模块再选源码编译安装。方式1包管理器安装CentOS/Ubuntu通用新手首选这种方式无需手动配置依赖一行命令就能完成安装适合新手和快速部署场景。1、CentOS系统yum命令更新系统软件包可选确保依赖最新yum update -y安装Nginx核心命令复制执行即可yum install nginx -y说明-y参数表示自动确认安装无需手动输入y确认。安装完成后查看Nginx版本验证是否安装成功nginx -v输出类似 nginx version: nginx/1.24.0说明安装成功。2、Ubuntu系统apt命令更新软件包列表apt update安装Nginx核心命令apt install nginx -y验证安装nginx -v输出版本号即为安装成功。方式2源码编译安装自定义安装进阶需求如果需要自定义Nginx安装目录、添加第三方模块比如限流、缓存模块可以用这种方式步骤稍多但更灵活。1.安装依赖包必须先装否则编译会报错# CentOS系统 yum install gcc pcre-devel zlib-devel openssl-devel -y # Ubuntu系统 apt install gcc libpcre3 libpcre3-dev zlib1g-dev openssl libssl-dev -y2.下载Nginx源码包推荐稳定版比如1.24.0wget http://nginx.org/download/nginx-1.24.0.tar.gz如果没有wget命令先安装#CentOS yum install wget -y #Ubuntu apt install wget -y3.解压源码包tar -zxvf nginx-1.24.0.tar.gz4.进入解压后的目录cd nginx-1.24.05.配置安装目录自定义路径这里以/usr/local/nginx为例./configure --prefix/usr/local/nginx6.编译并安装make make install这个过程会持续1-2分钟耐心等待无报错即为编译成功。7.验证安装进入安装目录查看版本cd /usr/local/nginx/sbin ./nginx -v输出版本号即为安装成功。新手提醒如果没有特殊需求优先用包管理器安装源码编译安装后续卸载、升级稍麻烦适合有进阶需求的同学。四、Windows系统安装NginxWindows系统安装更简单无需命令解压即可使用适合本地测试静态网站、调试配置。下载Nginx安装包访问Nginx官方网站http://nginx.org/点击右侧“download”选择“Stable version”稳定版下载Windows版本如nginx/Windows-1.24.0.zip。解压安装包将下载的.zip文件解压到纯英文、无空格的路径重点比如D:\nginx-1.24.0。解压后进入目录能看到以下核心文件夹conf存放Nginx配置文件后续重点用到html存放静态页面默认首页在这里sbin存放Nginx启动/停止命令nginx.exe。3.验证安装打开解压后的sbin目录双击nginx.exe会弹出一个黑色命令行窗口瞬间消失——这是正常现象说明Nginx已启动。打开浏览器输入http://localhost能看到Nginx默认首页即为安装成功。注意Windows系统中Nginx启动后黑色窗口会立即消失不要误以为启动失败如果窗口一闪而过且无法访问大概率是80端口被占用后续报错排查会讲。五、Nginx启动、停止、重启安装完成后重点掌握这3个操作后续修改配置、维护Nginx都要用到分Linux和Windows分别说明简单好记。1、Linux系统包管理器安装推荐用systemctl命令操作简单、稳定适合包管理器安装的Nginx# 1. 启动Nginx systemctl start nginx # 2. 停止Nginx systemctl stop nginx # 3. 重启Nginx修改配置后必须执行让配置生效 systemctl restart nginx # 4. 查看Nginx运行状态 systemctl status nginx补充如果是源码编译安装自定义目录用以下命令以/usr/local/nginx为例# 进入Nginx执行目录 cd /usr/local/nginx/sbin # 启动 ./nginx # 停止强制停止不推荐 ./nginx -s stop # 优雅停止推荐等待所有请求处理完成后停止 ./nginx -s quit # 重启修改配置后生效 ./nginx -s reload2、Windows系统两种方式任选一种适合本地测试方式1命令行操作推荐精准控制以管理员身份打开CMD重点否则可能报错进入Nginx解压目录的sbin文件夹比如D:\nginx-1.24.0\sbincd D:\nginx-1.24.0\sbin3.执行对应命令# 启动 nginx.exe # 停止 nginx.exe -s stop # 优雅停止 nginx.exe -s quit # 重启修改配置后生效 nginx.exe -s reload方式2图形化操作简单适合新手打开任务管理器找到“nginx.exe”进程右键选择“结束任务”即可停止Nginx双击sbin目录下的nginx.exe即可启动。重点牢记修改Nginx配置文件后必须执行“重启”命令配置才能生效六、验证Nginx是否正常运行无论哪种系统安装启动后一定要验证是否能正常运行避免后续操作踩坑。方法1浏览器访问最直观本地测试Linux/Windows打开浏览器输入http://localhost能看到Nginx默认首页蓝色页面显示“Welcome to nginx!”即为正常。远程测试Linux服务器打开本地浏览器输入服务器公网IP比如http://123.45.67.89能看到默认首页即为正常需开放80端口后续报错排查会讲。方法2命令行验证更精准# Linux系统 curl http://localhost # Windows系统CMD中执行 curl http://localhost如果输出Nginx默认首页的HTML代码包含“Welcome to nginx!”说明Nginx正常运行。七、安装/启动最常见报错新手安装Nginx最容易遇到以下报错不用慌对照报错信息复制对应的解决命令一键搞定报错1Linux启动Nginx报错Job for nginx.service failed because the control process exited with error code.原因80端口被其他服务比如Apache、Tomcat占用解决关闭占用80端口的服务或修改Nginx监听端口后续配置会详细说。# 查看80端口占用情况 netstat -tulnp | grep 80 # 关闭占用服务以Apache为例 systemctl stop httpd报错2Windows启动Nginx一闪而过浏览器访问不到原因80端口被占用比如IIS、迅雷、微信等软件或解压路径有中文/空格解决查找并关闭占用80端口的软件CMD中执行 netstat -ano | findstr :80 找到PID在任务管理器中结束对应进程将Nginx解压到纯英文、无空格路径比如D:\nginx。报错3Linux执行nginx -v报错nginx: command not found原因源码编译安装未配置环境变量系统找不到nginx命令解决用完整路径执行命令以/usr/local/nginx为例/usr/local/nginx/sbin/nginx -v报错4源码编译安装时报错./configure: error: the HTTP rewrite module requires the PCRE library.原因缺少PCRE依赖包解决安装依赖包对应自己的Linux系统。# CentOS yum install pcre-devel -y # Ubuntu apt install libpcre3 libpcre3-dev -y报错5Linux启动Nginx报错nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use)原因80端口已被占用和报错1类似更直观解决杀死占用80端口的进程kill -9 $(lsof -t -i:80)报错6Windows执行nginx -s reload报错nginx: [error] open() D:\nginx-1.24.0/logs/nginx.pid failed (2: No such file or directory)原因Nginx未正常启动没有生成pid文件解决重新启动Nginx再执行reload命令。报错7Linux包管理器安装Nginx后启动报错No such file or directory原因安装过程中依赖缺失导致安装不完整解决重新安装并安装依赖。# CentOS yum remove nginx -y yum install nginx -y # Ubuntu apt remove nginx -y apt install nginx -y报错8远程访问Linux服务器的Nginx浏览器无法打开原因Linux防火墙未开放80端口或云服务器安全组未配置解决开放Linux防火墙80端口firewall-cmd --permanent --add-port80/tcp firewall-cmd --reload云服务器登录控制台找到“安全组”添加80端口入站规则允许所有IP访问。八、总结本篇文章完成了Nginx的核心部署操作重点总结Linux系统新手用包管理器yum/apt安装简单快捷有自定义需求用源码编译安装Windows系统解压即可使用重点注意“纯英文路径”和“80端口占用”核心命令启动、停止、重启修改配置后必须重启Nginx报错解决遇到问题不用慌对照本文的报错列表一键就能解决。到这里你已经拥有了一台可正常运行的Nginx服务器——这是我们后续所有学习的基础。下一篇我们将进入Nginx的核心配置环节教你读懂nginx.conf配置文件亲手搭建第一个静态网站真正实现“会用”Nginx。