1. 项目概述为什么Nginx是Web服务部署的基石在Linux服务器上部署Web应用第一步往往不是写代码而是搭建一个稳定、高效的Web服务器。无论是个人博客、企业官网还是复杂的微服务网关一个可靠的HTTP服务是连接用户与应用的桥梁。在众多选择中Nginx以其高性能、低内存占用和灵活的配置成为了事实上的标准。我见过太多新手在安装Nginx时要么被各种包管理器搞晕要么卸载不干净导致后续安装冲突一个简单的“安装/卸载”操作背后其实藏着不少门道。这篇内容就是为你梳理在Linux系统上从零开始安装Nginx以及如何彻底、干净地卸载它的完整路径。我会覆盖主流的发行版CentOS/RHEL、Ubuntu/Debian不仅告诉你敲什么命令更会解释每个命令背后的逻辑以及在不同场景下的最佳选择。比如你是应该用系统自带的包管理器安装一个稳定但可能版本较旧的Nginx还是从官方源安装最新版以获取新特性卸载时如何确保配置文件、日志、缓存文件都被清理干净不给系统留下“垃圾”这些都是实战中必须面对的问题。无论你是刚接触Linux运维的开发者还是需要快速搭建测试环境的学生掌握这套标准操作流程都能让你在部署Web服务时更加得心应手避免踩坑。2. 核心思路与方案选型官方源 vs 系统源 vs 源码编译在动手之前我们先得想清楚从哪里安装Nginx这直接决定了后续的维护成本、功能特性和安全性。主要有三种路径各有优劣。2.1 使用操作系统自带的包管理器apt/yum/dnf这是最快捷、最省心的方式。以Ubuntu的apt和CentOS的yum或dnf为代表。你只需要一条命令系统就会自动解决依赖关系并完成安装。优点简单稳定命令统一安装过程自动化几乎不会出错。易于管理后续的升级、卸载都可以通过同一个包管理器完成非常规范。系统集成度高安装的服务会自动集成到系统的服务管理体系中如systemd方便使用systemctl命令启停。缺点版本可能较旧系统源中的软件包版本倾向于追求稳定性可能不是最新的主线版或最新稳定版一些新特性或性能优化无法及时获得。模块固定预编译的包通常只包含最常用的模块。如果你需要一些第三方模块如ngx_http_lua_module用于Lua脚本用系统源安装后添加会非常麻烦。适用场景追求快速部署、环境标准化、对Nginx版本没有特殊要求的生产或测试环境。这是大多数情况下的推荐选择。2.2 添加Nginx官方软件源进行安装Nginx官方为不同的Linux发行版维护了自己的软件源。通过添加这个源你可以使用系统包管理器来安装由Nginx Inc.官方直接提供和维护的软件包。优点版本较新可以方便地安装到最新的稳定版甚至主线版。官方维护安全更新和Bug修复的推送更及时。保留包管理优势依然享受apt或yum带来的依赖管理和服务集成便利。缺点需要手动添加源多了配置软件源这一步不同系统命令不同。可能与系统其他软件存在微妙的依赖冲突概率较低。适用场景需要较新版本的Nginx同时又希望保持包管理的规范性。这是平衡了“新”与“稳”的折中方案。2.3 从源码编译安装这是最灵活、也是最复杂的方式。你需要手动下载Nginx的源代码压缩包在本地编译生成可执行文件。优点极致灵活可以自定义编译参数选择需要的模块排除不需要的甚至集成第三方模块打造最符合自己需求的Nginx。版本完全自主可以安装任意历史版本或最新的开发版。性能调优可以针对特定的CPU架构进行编译优化。缺点过程繁琐需要手动解决所有依赖如PCRE、zlib、OpenSSL等。管理不便安装、升级、卸载都需要手动操作无法通过系统包管理器管理。服务也不会自动注册到systemd需要自己写服务文件。对使用者要求高需要了解基本的编译知识和Linux操作。适用场景有特殊定制化需求如添加特定第三方模块、进行深度性能调优、或学习研究Nginx内部机制的高级用户。我的实操心得对于99%的日常应用和中小型项目优先推荐使用操作系统自带的包管理器安装。它省时省力出问题也容易排查和回滚。只有在确实需要某个新特性如HTTP/3支持或者系统源版本实在太老时才考虑添加官方源。源码编译通常是架构师或性能专家在特定优化场景下的选择新手尽量避免容易在依赖问题上耗费大量时间。接下来我们将以最常用的“系统包管理器安装”和“官方源安装”为主线详细展开操作步骤。源码安装由于其复杂性将单独简要说明其核心流程。3. 基于包管理器的安装与卸载详解这是最核心、最常用的部分。我们会分系统详细讲解。3.1 Ubuntu/Debian 系统这类系统使用apt作为包管理器服务管理使用systemd。3.1.1 安装Nginx使用系统源更新软件包列表这是一个好习惯确保你获取的是仓库中最新的安装包信息。sudo apt update这条命令会从配置的软件源服务器下载最新的软件包列表但不会安装或升级任何软件。安装Nginxsudo apt install nginx -y-y参数表示对安装过程中的所有确认提示都回答“yes”让安装自动进行。安装过程会自动处理依赖比如libpcre3、zlib1g等。验证安装检查版本nginx -v或nginx -V-V会显示详细的编译参数。检查服务状态安装后Nginx服务会自动启动并设置为开机自启。可以通过systemctl命令查看。sudo systemctl status nginx如果看到active (running)的字样说明服务正在运行。访问测试在浏览器中输入你的服务器IP地址你应该能看到Nginx的默认欢迎页面。如果是在本地服务器可以运行curl http://localhost来测试。3.1.2 安装Nginx使用Nginx官方源如果你需要更新的版本可以添加Nginx官方源。安装前置依赖用于通过HTTPS添加软件源。sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring -y导入Nginx官方的GPG签名密钥这是为了验证从Nginx源下载的软件包的完整性和真实性确保软件包未被篡改。curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg /dev/null添加稳定版Nginx源这里以稳定版为例。如果要主线版将stable替换为mainline。echo deb [signed-by/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/ubuntu lsb_release -cs nginx | sudo tee /etc/apt/sources.list.d/nginx.list这个命令动态获取了当前系统的代号如jammy并写入了源列表。设置偏好阻止从系统源安装避免apt在官方源和系统源之间混淆。echo -e Package: *\nPin: origin nginx.org\nPin-Priority: 900\n | sudo tee /etc/apt/preferences.d/99nginx更新并安装sudo apt update sudo apt install nginx -y之后的验证步骤同上。3.1.3 彻底卸载Nginx卸载的目标是移除软件包、清理主要配置和日志。但注意通过apt remove默认不会删除网站数据如/var/www/html下的内容和用户创建的配置文件。停止服务sudo systemctl stop nginx sudo systemctl disable nginx # 禁止开机自启卸载软件包sudo apt remove nginx nginx-common nginx-core -ynginx-common包含共享的配置和文档nginx-core是核心二进制文件。一起移除更干净。自动移除不再需要的依赖sudo apt autoremove -y可选彻底清理残留文件和目录这一步需要谨慎最好先备份或确认目录内容不再需要。sudo rm -rf /etc/nginx /var/log/nginx /var/cache/nginx/etc/nginx所有Nginx配置文件。/var/log/nginx所有Nginx日志文件。/var/cache/nginxNginx的缓存目录。注意/var/www/html目录通常存放网站文件它不属于Nginx包而是由apache2或独立创建请根据实际情况决定是否删除。3.2 CentOS/RHEL/Rocky Linux/AlmaLinux 系统这类系统使用yumCentOS 7或dnfCentOS 8作为包管理器。3.2.1 安装Nginx使用EPEL源在CentOS等系统中Nginx默认不在基础仓库里。最方便的方法是启用EPELExtra Packages for Enterprise Linux扩展仓库。安装EPEL仓库CentOS 7:sudo yum install epel-release -yCentOS 8/Stream, Rocky Linux 8, AlmaLinux 8:sudo dnf install epel-release -y安装NginxCentOS 7:sudo yum install nginx -yCentOS 8:sudo dnf install nginx -y启动并设置开机自启sudo systemctl start nginx sudo systemctl enable nginx验证同样使用nginx -v和systemctl status nginx或通过浏览器/IP访问验证。3.2.2 安装Nginx使用Nginx官方源创建Nginx官方源的repo文件sudo vi /etc/yum.repos.d/nginx.repo根据你的系统版本填入以下内容以CentOS 7为例[nginx-stable] namenginx stable repo baseurlhttp://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck1 enabled1 gpgkeyhttps://nginx.org/keys/nginx_signing.key [nginx-mainline] namenginx mainline repo baseurlhttp://nginx.org/packages/mainline/centos/$releasever/$basearch/ gpgcheck1 enabled0 gpgkeyhttps://nginx.org/keys/nginx_signing.key这里同时配置了稳定版(stable)和主线版(mainline)默认启用稳定版。如果想用主线版将[nginx-mainline]部分的enabled改为1并将[nginx-stable]的enabled改为0。清除缓存并安装sudo yum clean all # 或 dnf clean all sudo yum install nginx -y后续的启动、启用、验证步骤同上。3.2.3 彻底卸载Nginx停止并禁用服务sudo systemctl stop nginx sudo systemctl disable nginx卸载软件包CentOS 7:sudo yum remove nginx -yCentOS 8:sudo dnf remove nginx -y删除残留文件和目录sudo rm -rf /etc/nginx /usr/share/nginx /var/log/nginx注意CentOS系列中默认的网站根目录通常是/usr/share/nginx/html它属于nginx包所以上述命令会将其删除。请确保已备份重要数据。可选移除之前添加的官方源repo文件sudo rm -f /etc/yum.repos.d/nginx.repo4. 源码编译安装与卸载流程精讲源码安装给了你最大的控制权但步骤也最繁琐。这里概述关键流程。4.1 编译安装核心步骤安装编译工具和依赖库这是成功编译的前提缺一不可。# 对于Ubuntu/Debian sudo apt update sudo apt install build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev -y # 对于CentOS/RHEL sudo yum groupinstall Development Tools sudo yum install pcre-devel zlib-devel openssl-devel -ybuild-essential/Development Tools提供gcc, make等编译工具链。pcre-develPerl兼容正则表达式库Nginx的rewrite模块需要。zlib-devel压缩库用于Gzip压缩。openssl-develSSL/TLS库用于HTTPS支持。下载Nginx源码包到 Nginx官方下载页面 获取稳定版或主线版的.tar.gz源码包。wget http://nginx.org/download/nginx-1.24.0.tar.gz tar -zxvf nginx-1.24.0.tar.gz cd nginx-1.24.0配置编译选项这是最关键的一步决定了Nginx包含哪些功能。./configure --prefix/usr/local/nginx \ --with-http_ssl_module \ --with-http_v2_module \ --with-http_realip_module \ --with-http_gzip_static_module \ --with-threads \ --with-file-aio--prefix指定安装目录所有文件都将安装在此目录下。--with-*_module启用额外的内置模块。例如http_ssl_module是HTTPS必需的http_v2_module支持HTTP/2。--without-*_module禁用默认模块如果你确定不需要。运行./configure --help可以查看所有可用选项。编译和安装make # 编译将源代码转换为二进制 sudo make install # 将编译好的文件安装到 --prefix 指定的目录运行与验证由于不是通过包管理器安装需要手动启动。# 启动 /usr/local/nginx/sbin/nginx # 检查进程 ps aux | grep nginx # 测试访问 curl http://localhost4.2 源码安装后的管理启动/停止/重载需要通过-s信号控制主进程。/usr/local/nginx/sbin/nginx -s stop # 快速停止 /usr/local/nginx/sbin/nginx -s quit # 优雅停止处理完当前请求 /usr/local/nginx/sbin/nginx -s reload # 重载配置文件 /usr/local/nginx/sbin/nginx -s reopen # 重新打开日志文件添加到系统服务为了方便你可以自己创建一个systemd服务文件/etc/systemd/system/nginx.service内容可以参考包管理器安装版本的服务文件然后就能用systemctl管理了。4.3 源码安装的卸载卸载非常简单粗暴因为所有文件都在--prefix指定的目录下这里是/usr/local/nginx。停止Nginx进程。删除安装目录sudo rm -rf /usr/local/nginx可选删除源码目录和下载的压缩包。注意事项源码安装的Nginx其配置文件、日志、HTML文件默认都在安装目录下如/usr/local/nginx/conf,/usr/local/nginx/logs,/usr/local/nginx/html。删除安装目录即完全卸载。务必在删除前备份你修改过的配置和网站数据。5. 安装后的关键配置与目录结构解析安装成功只是第一步理解Nginx的目录结构和核心配置才能更好地使用它。5.1 核心目录与文件说明无论通过哪种方式安装Nginx的核心结构是相似的源码安装的路径由--prefix决定。配置文件目录/etc/nginx/(包管理器安装)/usr/local/nginx/conf/(源码安装默认)nginx.conf主配置文件。所有配置的入口。conf.d/或sites-available/sites-enabled/推荐存放各个站点的独立配置文件。sites-available存放可用配置sites-enabled通过软链接启用其中的配置Ubuntu风格。mime.types定义文件扩展名与MIME类型的映射关系。默认网站根目录/var/www/html/(Ubuntu/Debian, Apache风格)/usr/share/nginx/html/(CentOS/RHEL)/usr/local/nginx/html/(源码安装默认) 这是访问服务器IP时Nginx返回的默认页面所在位置。日志目录/var/log/nginx/(包管理器安装)/usr/local/nginx/logs/(源码安装)access.log访问日志记录所有请求。error.log错误日志记录Nginx运行和请求处理中的错误信息。排查问题时首先查看这里二进制文件/usr/sbin/nginx(包管理器安装)/usr/local/nginx/sbin/nginx(源码安装)5.2 第一个自定义站点配置让我们抛开默认页面配置一个简单的静态站点。创建网站根目录和测试文件sudo mkdir -p /var/www/mywebsite echo h1Hello from My Website!/h1 | sudo tee /var/www/mywebsite/index.html适当修改目录的所有权以便Nginx进程通常以www-data或nginx用户运行可以读取# Ubuntu sudo chown -R www-data:www-data /var/www/mywebsite # CentOS sudo chown -R nginx:nginx /var/www/mywebsite创建站点配置文件Ubuntu/Debian风格使用sites-available/enabledsudo vi /etc/nginx/sites-available/mywebsite.conf写入以下内容server { listen 80; # 监听80端口 server_name mywebsite.test www.mywebsite.test; # 你的域名或测试用的hosts域名 root /var/www/mywebsite; # 网站根目录 index index.html index.htm; location / { try_files $uri $uri/ 404; } }然后创建软链接到sites-enabled目录以启用它并测试配置语法sudo ln -s /etc/nginx/sites-available/mywebsite.conf /etc/nginx/sites-enabled/ sudo nginx -t # 测试配置语法非常重要CentOS/RHEL风格使用conf.dsudo vi /etc/nginx/conf.d/mywebsite.conf写入同样的server块内容然后直接测试语法sudo nginx -t。重载Nginx使配置生效sudo systemctl reload nginx # 或 sudo nginx -s reload测试访问在本地/etc/hosts文件中添加一行127.0.0.1 mywebsite.test然后在浏览器访问http://mywebsite.test就能看到你的自定义页面了。6. 实战问题排查与经验技巧实录即使按照教程操作也难免遇到问题。这里记录了几个最常见的问题和排查思路。6.1 常见问题速查表问题现象可能原因排查命令/步骤sudo systemctl start nginx失败1. 端口被占用如80端口已被Apache占用2. 配置文件语法错误3. 权限问题如/var/www/html目录Nginx进程无权访问1.sudo ss -tulnp | grep :80查看80端口占用2.sudo nginx -t必做检查语法3. 查看/var/log/nginx/error.log获取具体错误信息访问服务器IP显示“403 Forbidden”1. 网站根目录权限不正确2. 目录下没有index指令指定的默认文件如index.html1.ls -la /var/www/html/检查目录权限和所有者2. 确认index.html等文件是否存在访问服务器IP显示“502 Bad Gateway”Nginx作为反向代理时后端服务如PHP-FPM, Node.js未启动或无法连接1. 检查后端服务状态systemctl status php-fpm2. 检查后端服务监听的socket或端口是否与Nginx配置一致修改配置文件后重载失败配置文件存在语法错误永远在执行reload前先运行sudo nginx -t它会精确指出错误行和原因。nginx -V显示的模块与预期不符安装的Nginx版本系统源未包含所需模块考虑卸载后从Nginx官方源安装或采用源码编译并指定--with-*_module参数。6.2 独家避坑技巧与心得nginx -t是你的守护神任何对nginx.conf或其包含的配置文件的修改在保存后、重载前必须执行sudo nginx -t。这个命令只做语法检查不会影响正在运行的服务。它能帮你避免因一个拼写错误导致整个Web服务宕机。善用日志尤其是error.log当遇到任何异常403, 404, 502, 503等第一个动作应该是tail -f /var/log/nginx/error.log。错误日志的详细程度远超你的想象权限拒绝、文件未找到、连接超时等信息都会记录在这里。access.log则用于分析流量和请求模式。权限问题“三板斧”Web目录的权限问题非常常见。记住这个检查顺序所有权运行ps aux \| grep nginx查看Nginx worker进程以什么用户运行通常是www-data或nginx。然后确保你的网站根目录及其文件的所有者或所属组是这个用户或者至少该用户有读取(r)权限。命令sudo chown -R www-data:www-data /your/webroot。目录权限确保目录至少有755权限所有者rwx组和其他人rx文件至少有644权限。命令sudo find /your/webroot -type d -exec chmod 755 {} \;和sudo find /your/webroot -type f -exec chmod 644 {} \;。SELinux/AppArmor在CentOS/RHEL上如果以上都正确但依然403可能是SELinux在阻止。可以临时设置为宽容模式测试sudo setenforce 0。生产环境请使用正确的安全上下文sudo chcon -Rt httpd_sys_content_t /your/webroot。配置文件管理策略对于管理多个站点我强烈推荐Ubuntu的sites-available和sites-enabled模式。sites-available里存放所有配置“草稿”sites-enabled里通过软链接指向需要启用的配置。这样禁用站点只需删除软链接而不会删除配置文件本身管理起来清晰又安全。防火墙别忘了如果从外部网络无法访问很可能是系统防火墙如firewalld或ufw阻止了80或443端口。firewalld (CentOS):sudo firewall-cmd --permanent --add-servicehttp sudo firewall-cmd --permanent --add-servicehttps sudo firewall-cmd --reloadufw (Ubuntu):sudo ufw allow Nginx Full # 允许80和443 sudo ufw reload从选择安装方式到最终上线一个可访问的站点整个过程看似步骤繁多但每一步都有其明确的目的。我的建议是在测试环境中把每种安装方式都亲手操作一遍特别是源码编译它能让你最深刻地理解Nginx的模块化构成。而在生产环境中除非有极强的定制需求否则优先使用系统包管理器或官方源安装稳定性、安全更新和可维护性才是第一位的。记住nginx -t和错误日志是你最好的朋友遇到问题先找它们能解决90%的疑惑。