Linux系统Nginx安装与卸载全攻略：从包管理到源码编译

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（使用系统源）

1. 更新软件包列表：这是一个好习惯，确保你获取的是仓库中最新的安装包信息。

   sudo apt update

   这条命令会从配置的软件源服务器下载最新的软件包列表，但不会安装或升级任何软件。

2. 安装Nginx：

   sudo apt install nginx -y

   -y参数表示对安装过程中的所有确认提示都回答“yes”，让安装自动进行。安装过程会自动处理依赖，比如libpcre3、zlib1g等。

3. 验证安装：

   • 检查版本：nginx -v或nginx -V（-V会显示详细的编译参数）。
   • 检查服务状态：安装后，Nginx服务会自动启动并设置为开机自启。可以通过systemctl命令查看。

     sudo systemctl status nginx

     如果看到active (running)的字样，说明服务正在运行。
   • 访问测试：在浏览器中输入你的服务器IP地址，你应该能看到Nginx的默认欢迎页面。如果是在本地服务器，可以运行curl http://localhost来测试。

3.1.2 安装Nginx（使用Nginx官方源）

如果你需要更新的版本，可以添加Nginx官方源。

1. 安装前置依赖：用于通过HTTPS添加软件源。

   sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring -y

2. 导入Nginx官方的GPG签名密钥：这是为了验证从Nginx源下载的软件包的完整性和真实性，确保软件包未被篡改。

   curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

3. 添加稳定版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），并写入了源列表。

4. 设置偏好，阻止从系统源安装：避免apt在官方源和系统源之间混淆。

   echo -e "Package: *\nPin: origin nginx.org\nPin-Priority: 900\n" | sudo tee /etc/apt/preferences.d/99nginx

5. 更新并安装：

   sudo apt update sudo apt install nginx -y

   之后的验证步骤同上。

3.1.3 彻底卸载Nginx

卸载的目标是移除软件包、清理主要配置和日志。但注意，通过apt remove默认不会删除网站数据（如/var/www/html下的内容）和用户创建的配置文件。

1. 停止服务：

   sudo systemctl stop nginx sudo systemctl disable nginx # 禁止开机自启

2. 卸载软件包：

   sudo apt remove nginx nginx-common nginx-core -y

   nginx-common包含共享的配置和文档，nginx-core是核心二进制文件。一起移除更干净。

3. 自动移除不再需要的依赖：

   sudo apt autoremove -y

4. （可选）彻底清理残留文件和目录：这一步需要谨慎，最好先备份或确认目录内容不再需要。

   sudo rm -rf /etc/nginx /var/log/nginx /var/cache/nginx

   • /etc/nginx：所有Nginx配置文件。
   • /var/log/nginx：所有Nginx日志文件。
   • /var/cache/nginx：Nginx的缓存目录。注意：/var/www/html目录通常存放网站文件，它不属于Nginx包，而是由apache2或独立创建，请根据实际情况决定是否删除。

3.2 CentOS/RHEL/Rocky Linux/AlmaLinux 系统

这类系统使用yum（CentOS 7）或dnf（CentOS 8+）作为包管理器。

3.2.1 安装Nginx（使用EPEL源）

在CentOS等系统中，Nginx默认不在基础仓库里。最方便的方法是启用EPEL（Extra Packages for Enterprise Linux）扩展仓库。

1. 安装EPEL仓库：

   • CentOS 7:

     sudo yum install epel-release -y

   • CentOS 8/Stream, Rocky Linux 8+, AlmaLinux 8+:

     sudo dnf install epel-release -y

2. 安装Nginx：

   • CentOS 7:

     sudo yum install nginx -y

   • CentOS 8+:

     sudo dnf install nginx -y

3. 启动并设置开机自启：

   sudo systemctl start nginx sudo systemctl enable nginx

4. 验证：同样使用nginx -v和systemctl status nginx，或通过浏览器/IP访问验证。

3.2.2 安装Nginx（使用Nginx官方源）

1. 创建Nginx官方源的repo文件：

   sudo vi /etc/yum.repos.d/nginx.repo

   根据你的系统版本，填入以下内容（以CentOS 7为例）：

   [nginx-stable] name=nginx stable repo baseurl=http://nginx.org/packages/centos/$releasever/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://nginx.org/keys/nginx_signing.key [nginx-mainline] name=nginx mainline repo baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/ gpgcheck=1 enabled=0 gpgkey=https://nginx.org/keys/nginx_signing.key

   这里同时配置了稳定版(stable)和主线版(mainline)，默认启用稳定版。如果想用主线版，将[nginx-mainline]部分的enabled改为1，并将[nginx-stable]的enabled改为0。

2. 清除缓存并安装：

   sudo yum clean all # 或 dnf clean all sudo yum install nginx -y

3. 后续的启动、启用、验证步骤同上。

3.2.3 彻底卸载Nginx

1. 停止并禁用服务：

   sudo systemctl stop nginx sudo systemctl disable nginx

2. 卸载软件包：

   • CentOS 7:sudo yum remove nginx -y
   • CentOS 8+:sudo dnf remove nginx -y

3. 删除残留文件和目录：

   sudo rm -rf /etc/nginx /usr/share/nginx /var/log/nginx

   注意：CentOS系列中，默认的网站根目录通常是/usr/share/nginx/html，它属于nginx包，所以上述命令会将其删除。请确保已备份重要数据。

4. （可选）移除之前添加的官方源repo文件：

   sudo rm -f /etc/yum.repos.d/nginx.repo

4. 源码编译安装与卸载流程精讲

源码安装给了你最大的控制权，但步骤也最繁琐。这里概述关键流程。

4.1 编译安装核心步骤

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 -y

   • build-essential/Development Tools：提供gcc, make等编译工具链。
   • pcre-devel：Perl兼容正则表达式库，Nginx的rewrite模块需要。
   • zlib-devel：压缩库，用于Gzip压缩。
   • openssl-devel：SSL/TLS库，用于HTTPS支持。

2. 下载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

3. 配置编译选项：这是最关键的一步，决定了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可以查看所有可用选项。

4. 编译和安装：

   make # 编译，将源代码转换为二进制 sudo make install # 将编译好的文件安装到 --prefix 指定的目录

5. 运行与验证：由于不是通过包管理器安装，需要手动启动。

   # 启动 /usr/local/nginx/sbin/nginx # 检查进程 ps aux | grep nginx # 测试访问 curl http://localhost

4.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）。

1. 停止Nginx进程。
2. 删除安装目录：

   sudo rm -rf /usr/local/nginx

3. （可选）删除源码目录和下载的压缩包。

注意事项：源码安装的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 第一个自定义站点配置

让我们抛开默认页面，配置一个简单的静态站点。

1. 创建网站根目录和测试文件：

   sudo mkdir -p /var/www/mywebsite echo "<h1>Hello 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

2. 创建站点配置文件：

   • Ubuntu/Debian风格（使用sites-available/enabled）：

     sudo 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.d）：

     sudo vi /etc/nginx/conf.d/mywebsite.conf

     写入同样的server块内容，然后直接测试语法：sudo nginx -t。

3. 重载Nginx使配置生效：

   sudo systemctl reload nginx # 或 sudo nginx -s reload

4. 测试访问：在本地/etc/hosts文件中添加一行127.0.0.1 mywebsite.test，然后在浏览器访问http://mywebsite.test，就能看到你的自定义页面了。

6. 实战问题排查与经验技巧实录

即使按照教程操作，也难免遇到问题。这里记录了几个最常见的问题和排查思路。

6.1 常见问题速查表

6.2 独家避坑技巧与心得

1. nginx -t是你的守护神：任何对nginx.conf或其包含的配置文件的修改，在保存后、重载前，必须执行sudo nginx -t。这个命令只做语法检查，不会影响正在运行的服务。它能帮你避免因一个拼写错误导致整个Web服务宕机。

2. 善用日志，尤其是error.log：当遇到任何异常（403, 404, 502, 503等），第一个动作应该是tail -f /var/log/nginx/error.log。错误日志的详细程度远超你的想象，权限拒绝、文件未找到、连接超时等信息都会记录在这里。access.log则用于分析流量和请求模式。

3. 权限问题“三板斧”：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。

4. 配置文件管理策略：对于管理多个站点，我强烈推荐Ubuntu的sites-available和sites-enabled模式。sites-available里存放所有配置“草稿”，sites-enabled里通过软链接指向需要启用的配置。这样，禁用站点只需删除软链接，而不会删除配置文件本身，管理起来清晰又安全。

5. 防火墙别忘了：如果从外部网络无法访问，很可能是系统防火墙（如firewalld或ufw）阻止了80或443端口。

   • firewalld (CentOS):

     sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --permanent --add-service=https sudo firewall-cmd --reload

   • ufw (Ubuntu):

     sudo ufw allow 'Nginx Full' # 允许80和443 sudo ufw reload

从选择安装方式到最终上线一个可访问的站点，整个过程看似步骤繁多，但每一步都有其明确的目的。我的建议是，在测试环境中，把每种安装方式都亲手操作一遍，特别是源码编译，它能让你最深刻地理解Nginx的模块化构成。而在生产环境中，除非有极强的定制需求，否则优先使用系统包管理器或官方源安装，稳定性、安全更新和可维护性才是第一位的。记住，nginx -t和错误日志是你最好的朋友，遇到问题先找它们，能解决90%的疑惑。