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

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

📚 导航目录

🚀 一、安装前准备
📦 二、添加 Nginx 官方仓库
⚙️ 三、设置仓库优先级
🔧 四、安装与验证 Nginx
❓ 五、关于 GPG 密钥问题
📂 六、安装后的基本操作
🔄 七、升级 Nginx
🗑️ 八、卸载 Nginx
💾 九、备份 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.🔧 本地 rsync 同步备份

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 📌 同步 nginx 主目录
rsync -avhz --progress --delete-delay --mkpath \
    /etc/nginx/ \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/nginx-标准版/nginx/

#📌 同步 html 目录
rsync -avzh --progress --delete-delay --mkpath \
    /var/www/html/ \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/nginx-标准版/html/

# 📌 同步文件服务目录
rsync -avzh --progress --delete-delay --mkpath \
    /mnt/file/ \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/file/

2. 📌 从本地备份恢复

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 恢复 nginx 配置
rsync -avzh --progress --mkpath \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/nginx-标准版/nginx/ \
    /etc/nginx/

# 恢复网站文件
rsync -avzh --progress --mkpath \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/nginx-标准版/html/ \
    /var/www/html/

# 恢复文件服务
rsync -avzh --progress --mkpath \
    /mnt/smb_fnos/阿里云盘/教程文件/Debian13/backup/file/ \
    /mnt/file/

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

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