Nginx 标准版安装与卸载指南 📝

在 Debian 13 上安装、配置、升级、卸载和备份 Nginx 的完整流程。

📚 导航目录

一、🚀 安装前准备

  • 在开始安装之前，确保已安装所需依赖：
1
2
sudo apt update && sudo apt upgrade -y && \
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring -y
  • 导入 nginx 官方 GPG 密钥：
1
curl -fsSL https://nginx.org/keys/nginx_signing.key | sudo gpg --dearmor -o /usr/share/keyrings/nginx-archive-keyring.gpg

二、📦 添加 Nginx 官方 APT 仓库

使用以下命令添加 Nginx 官方主线版仓库（获取最新版本）：

1
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/mainline/debian/ $(lsb_release -cs) nginx" | sudo tee /etc/apt/sources.list.d/nginx.list

✨ Nginx 官方仓库提供了最新稳定版本，确保您能获得最新功能和安全更新。

三、⚙️ 设置仓库优先级

为确保系统优先使用 Nginx 官方仓库（而不是系统自带的较旧版本），设置优先级配置：

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

🔧 优先级设置可防止系统自动更新时覆盖为旧版本，保持版本一致性。

四、🔧 安装与验证 Nginx

  • 更新软件包列表并安装 Nginx：
1
2
sudo apt update && \
sudo apt install nginx -y
  • 验证安装是否成功：
1
nginx -v

📌 如果一切顺利，将显示 Nginx 1.29.x 版本号。

五、❓ 关于 GPG 密钥验证问题

安装过程中可能遇到的 GPG 错误 (/root/.gnupg: directory does not exist!) 是因为系统缺少 GPG 默认密钥存储目录。这不会影响安装，因为：

  • 密钥已成功下载到 /usr/share/keyrings/nginx-archive-keyring.gpg
  • 使用 signed-by 参数明确指定了密钥位置

如需修复 GPG 目录问题，可执行：

1
2
mkdir -p ~/.gnupg
chmod 700 ~/.gnupg

⚠️ 这不是必须操作，不影响 Nginx 正常安装和使用。

六、📂 安装后的基本操作

检查端口占用

1
sudo ss -tulnp | grep -E ':80|:443'

  • 如果有其他服务（如 Apache、另一个 Nginx 实例、或某个占用端口的程序）正在运行，请先停止它们：
1
2
sudo systemctl stop apache2 && \
sudo systemctl stop nginx

启动 Nginx 服务：

1
sudo systemctl start nginx

设置开机自启：

1
sudo systemctl enable nginx

检查服务状态：

1
sudo systemctl status nginx

测试配置文件语法：

1
sudo nginx -t

重新加载配置（不中断服务）：

1
sudo systemctl reload nginx

🛡️ Nginx 以其高性能、高并发能力和低内存占用著称，非常适合作为 Web 服务器、反向代理服务器或负载均衡器。

七、🔄 升级 Nginx

如果您是按照之前指南通过官方仓库安装的 Nginx，这是最简单的升级方法：

1. 更新软件包列表

1
sudo apt update

2. 查看可升级版本

1
apt-cache policy nginx

3. 执行升级

1
sudo apt upgrade nginx

4. 或者全面升级系统（包含 Nginx）

1
sudo apt full-upgrade

5. 验证升级结果

1
nginx -v

6. 重新加载配置（应用变更）

1
sudo systemctl reload nginx

📌 升级前建议备份配置，并检查官方发布说明了解重大变更。

八、🗑️ 卸载 Nginx

如需完全卸载 Nginx 及其配置文件，请执行以下步骤：

停止 Nginx 服务：

1
sudo systemctl stop nginx

禁用开机自启：

1
sudo systemctl disable nginx

卸载 Nginx 软件包：

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

删除仓库配置：

1
2
sudo rm -f /etc/apt/sources.list.d/nginx.list
sudo rm -f /etc/apt/preferences.d/99nginx

更新软件包列表：

1
sudo apt update

📌 --purge 参数会同时删除配置文件，确保完全卸载。如需保留配置，可省略此参数。

九、💾 备份 Nginx 配置

定期备份 Nginx 配置是良好的运维习惯：

备份配置文件：

1
sudo tar -czvf nginx-backup-$(date +%Y%m%d).tar.gz /etc/nginx

备份网站数据：

1
sudo tar -czvf nginx-html-backup-$(date +%Y%m%d).tar.gz /var/www/html

仅备份 Nginx 配置（推荐）：

1
sudo cp -r /etc/nginx /etc/nginx-backup-$(date +%Y%m%d)

🔐 建议将备份文件存储到安全位置，如外部存储或云存储服务。

💡 提示：现在您已经掌握了在 Debian 13 上安装、配置、升级、卸载和备份 Nginx 的完整流程。如有任何问题，欢迎随时提问！