Debian 13 教程 / 配置Nginx虚拟主机并诊断403与404响应

在 Debian 13 上,Nginx 站点的配置可以存储在 sites-available 中,并通过 sites-enabled 中的符号链接来激活。在检查配置后,使用 reload 应用它,并分别验证端口、Host 值、文件权限以及实际的 HTTP 响应。本教程在 127.0.0.1:8080 上添加一个静态站点,同时保留默认站点,并比较 200、403 和 404 响应的原因。

检查静态站点实验的范围和现有监听器

Nginx 是一个接收 HTTP(Hypertext Transfer Protocol,超文本传输协议)请求并提供文件或将请求传递给其他应用程序的网络服务器。在这里,我们只配置一个直接提供 HTML 文件的静态站点。您需要一个具有 sudo 权限的 Debian 13 普通用户以及 curl,所有的 HTTP 检查都应该在 Debian 虚拟机内部执行。示例只监听虚拟机自身的回环地址。从主机 PC 访问将需要针对监听地址和转发的单独计划;本实验将所有请求保持在虚拟机内部。

在安装软件包期间,默认站点可能会启动。在实际的生产服务器上,首先检查端口 80 和 443 上是否与现有的 Web 服务器冲突,并建立维护程序。还要检查 127.0.0.1:8080 是否未被使用。如果另一个服务占用了所需的地址和端口,请停止此次安装并查明冲突,而不要停止该服务。

ss -ltn
dpkg-query -W nginx nginx-common 2>/dev/null
apt-cache policy nginx

dpkg-query 对未安装的软件包可能会返回非零状态。这本身并不是系统错误。在练习虚拟机上,Nginx 没有安装,并且只有端口 22 上的 SSH 是开放的。它是从 Debian 仓库安装的,如下所示。

sudo apt update
sudo apt install nginx curl
nginx -v
systemctl is-active nginx
systemctl is-enabled nginx
sudo nginx -t

这台虚拟机上安装的 nginx 和 nginx-common 版本为 1.26.3-3+deb13u10,服务处于激活和启用状态。根据部署时间和安全更新,软件包的修订版本号可能会有所不同。如果服务无法启动,请检查实际原因,例如使用 systemctl status nginx --no-pager 和 sudo journalctl -u nginx -n 50 --no-pager 检查绑定失败等问题。

检查 Debian 的包含路径并备份原始文件

sites-available 目录是存放配置文件的地方,并非其中所有文件都会自动应用。在实践包中,/etc/nginx/nginx.conf 在 http 上下文中包含了 /etc/nginx/conf.d/*.conf 和 /etc/nginx/sites-enabled/*。在直接检查该规则后再继续操作。

grep -nE 'user |include .*(conf.d|sites-enabled)' /etc/nginx/nginx.conf
ls -l /etc/nginx/sites-enabled
sudo nginx -T | less

nginx -T 会打印出所有包含的配置并进行检查。由于可能包含认证信息或内部地址,请勿将输出未经检查就原样对外公开。在 less 中,按 q 退出。在此虚拟机上,处理请求的 worker(工作进程)以 www-data 用户运行,默认站点链接已保留。

以下是一个准备块,用于检查练习路径是否不存在,并保留原始文件。在同一 Bash 终端中执行。如果路径已存在,则停止操作,不进行删除或覆盖。由读者准备的操作配置备份也应包括所有相关的 include 文件和证书。

set -euo pipefail
for p in /srv/lf-web25 /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25 /var/backups/lf-debian13-25; do
    if test -e "$p" || test -L "$p"; then
        echo "Path already exists: $p" >&2
        exit 1
    fi
done
sudo install -d -m 700 /var/backups/lf-debian13-25
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/sites-available/default /var/backups/lf-debian13-25/
sudo sha256sum /etc/nginx/nginx.conf /etc/nginx/sites-available/default | sudo tee /var/backups/lf-debian13-25/original.sha256

创建静态文件和完整的虚拟主机配置

练习站点文件放置在 /srv/lf-web25/public。管理员拥有这些文件,Nginx 工作进程只能读取它们。目录需要执行权限以遍历路径,文件需要读取权限。此示例仅适用于公共静态文件,密码或私人材料不放置在此路径中。

sudo install -d -m 755 /srv/lf-web25/public /srv/lf-web25/public/empty
printf '%s
' '<!doctype html><html lang="en"><meta charset="utf-8"><title>Lab 25</title><h1>LF WEB 25</h1></html>' | sudo tee /srv/lf-web25/public/index.html
sudo chmod 644 /srv/lf-web25/public/index.html

将整个下一个块写入配置文件。带引号的 heredoc 终止符 CONF 会将 $uri 保留为 Nginx 变量,而不是 shell 变量。shell 包装器是一个 Bash 块;CONF 标记之间的内容是完整的 Nginx 配置。

sudo tee /etc/nginx/sites-available/lf-web25 > /dev/null <<'CONF'
server {
    listen 127.0.0.1:8080 default_server;
    server_name _;
    return 404;
}
server {
    listen 127.0.0.1:8080;
    server_name lab25.test;
    root /srv/lf-web25/public;
    index index.html;
    access_log /var/log/nginx/lf-web25-access.log;
    error_log /var/log/nginx/lf-web25-error.log;
    location / {
        try_files $uri $uri/ =404;
    }
}
CONF
设置 此练习的作用
listen 127.0.0.1:8080 它只接受来自虚拟机自身回环的连接。不能直接从互联网访问。
default_server 指定该地址和端口上名称不匹配请求的默认服务器。
server_name lab25.test 将 Host 请求头匹配 lab25.test 的请求交给该站点。它不会创建 DNS 记录。
root / index 设置请求 URI(Uniform Resource Identifier,统一资源标识符)对应的文件路径,以及目录的默认文件。
try_files $uri $uri/ =404 检查文件或目录,如果未找到则返回 404。

server_name _ 本身不是一个捕获所有名称的特殊通配符。在这里,default_server 决定默认选择。如果在同一地址和端口上重复此操作,可能会发生错误,因此请检查现有设置。Nginx 的请求处理文档 解释了先选择地址和端口,然后确定主机名和默认服务器的顺序。

创建用于启用站点的符号链接,通过配置检查后再应用。继续在专用的 Bash 会话中。以下 && 链仅在 nginx -t 成功时运行 reload;检查失败必须在继续之前进行修正。

sudo ln -s /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
systemctl is-active nginx
ss -ltn | grep '127.0.0.1:8080'

重新加载会使其再次读取配置,但保存配置文件本身的操作不会应用于正在运行的进程。即使它通过了检查,也不能保证工作进程实际上具有文件读取权限或预期的 Host 请求头匹配结果,因此 HTTP 验证仍然继续。nginx -t 和 -T 选项的范围可以在 Debian nginx 命令文档 中查看。

比较 Host 站点选择、HTTP 响应与 DNS

以下命令使用 --noproxy 来排除代理环境变量的影响。第一次请求是实际网站,第二次请求是名称不匹配的默认服务器,第三次请求是不存在的文件,第四次请求是没有索引的目录。

curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: other.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/missing
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/empty/
请求 验证结果 解释
lab25.test / 200,LF WEB 25 已选择所需的站点和静态文件。
other.test / 404 这是默认服务器的显式返回值。
lab25.test /missing 404 在匹配的站点上找不到目标文件。
lab25.test /empty/ 403 存在目录,但没有索引,并且不允许列出目录。

默认情况下,curl 不会将接收到 HTTP 404 视为处理失败。对于自动化检查,可以使用 -f 在 HTTP 错误响应时返回失败,或者使用 -w 打印状态并显式比较。仅使用 -w 打印状态不会使 HTTP 错误导致 curl 退出状态失败。要在 URL 中写入站点名但请求时不更改公共 DNS,请使用以下命令。--resolve 仅为此 curl 请求提供名称、端口和地址映射。

curl --noproxy '*' -fsS --resolve lab25.test:8080:127.0.0.1 http://lab25.test:8080/

即使命令成功,lab25.test 也未在互联网 DNS 中注册。要使外部服务公开,您需要一个实际的域名、服务器路径、适当的监听地址、防火墙和单独的 HTTPS。本练习不需要外部打开端口 8080。

将文件权限失败与错误日志匹配

即使您得到相同的403,原因可能不同。下面是一个比较示例,我们只将本练习中创建的一个root拥有的文件更改为600,移除了worker 工作进程的读取权限,然后发起请求。不要将此操作应用于生产文件。检查HTTP状态并立即将其恢复为644。

sudo chmod 600 /srv/lf-web25/public/index.html
curl --noproxy '*' -sS -o /dev/null -w '%{http_code}
' -H 'Host: lab25.test' http://127.0.0.1:8080/
namei -l /srv/lf-web25/public/index.html
sudo tail -n 10 /var/log/nginx/lf-web25-error.log
sudo chmod 644 /srv/lf-web25/public/index.html
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/

实际结果是设置为600时为403并提示 Permission denied,恢复后为200。之前的 /empty/ 请求日志则显示 directory index is forbidden,因此同样是 403 也能区分原因。namei显示到中间目录的权限。如果您没有沿路径访问父目录的执行权限,即使最终文件是644,也无法读取。

不要使用 chmod -R 777 来解决。检查路径、所有者、工作账户、访问控制列表(ACL,Access Control List)以及 AppArmor 拒绝日志(如有必要),并且只授予所需的权限。即使以 root 身份检查 Nginx 配置成功,也不等于 www-data 工作进程能够读取。访问日志用于查看请求和状态,错误日志用于缩小拒绝的原因。

恢复站点配置并清理实验环境

在更改设置之前,先单独复制一份该站点的已知良好版本。在验证过程中,当包含未知指令的配置被 nginx -t 拒绝时,尚未重新加载的现有工作进程仍会返回 200。将失败的文件恢复到已知良好版本并再次检查。读者应该养成在不引入生产环境错误的情况下,复制、检查并应用已知良好版本的习惯。

sudo cp -a /etc/nginx/sites-available/lf-web25 /var/backups/lf-debian13-25/good-site
sudo nginx -t && sudo systemctl reload nginx
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/

要恢复此实验室文件,请将其与 sudo diff -u /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25 进行比较。如果保存的文件是预期版本,请使用 sudo cp -a /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25 恢复它。运行上面仅在 nginx -t 成功时才执行 reload 的命令,并重复指定 Host 请求头的 HTTP 请求。在复制之前保留任何较新的预期修改。

如果更改的网站出现问题,请将刚保存的已知良好版本与当前文件进行比较,并仅恢复该网站的文件。不要轻率地覆盖公共设置。重新加载时的工作进程替换行为以及在失败情况下的处理方法,可在 Nginx 配置重载指南 中确认。

要结束该操作,首先删除链接,并使用检查和重载功能关闭 8080 上的专用服务器。不要停止默认网站或整个 Nginx 服务。如果在执行以下步骤之前想保留日志,请将两个专用日志复制到备份文件夹。

sudo cp -a /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log /var/backups/lf-debian13-25/
sudo rm -- /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
ss -ltn
sudo sha256sum -c /var/backups/lf-debian13-25/original.sha256

重新加载后,允许一些时间让现有的工作进程完成请求,然后再次检查。在确认127.0.0.1:8080监听器已消失且原始哈希值正常后,仅清理专用文件。在生产环境中,还需检查正在使用的工作进程不再访问专用日志。

sudo rm -- /etc/nginx/sites-available/lf-web25 /srv/lf-web25/public/index.html
sudo rmdir /srv/lf-web25/public/empty /srv/lf-web25/public /srv/lf-web25
sudo rm -- /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log
systemctl is-active nginx

在最终验证中,专用监听器和文件已被移除,nginx.conf 和默认站点的哈希值保持不变,Nginx 本身仍处于活动状态。已安装的软件包被保留。软件包的移除将通过检查它们与其他站点的使用情况及未来使用情况后另行决定。