Rocky Linux 10 教程 / 配置独立Nginx静态站点并检查SELinux与firewalld

要在 Rocky Linux 10 上配置 Nginx 站点,需要分离站点配置和文档目录,并按顺序检查 Nginx 配置、文件权限、SELinux 上下文和防火墙。在本教程中,我们将在 80 端口保持现有默认站点的同时,在 18025 端口添加一个静态站点,并对本地和其他计算机的响应进行比较。

操作范围及检查现有站点

Nginx 是一个 web 服务器,它接收请求并传送文件或将请求代理给其他程序。在这里,我们只处理直接提供文件的静态网站。运行 PHP、反向代理和 HTTPS 证书需要单独配置。

请在一个单独的 Rocky Linux 10 虚拟机 (VM) 上完成练习,并使用具有 sudo 权限和已准备好控制台访问权限的用户。原实验环境为 Rocky Linux 10.2,Nginx 1.26.3-6.el10_2.7,SELinux 处于强制模式。在该环境中,Apache 已停止,并且没有现有的 web 端口监听器。如果当前有任何正在运行的服务,你应在安装和启动之前检查端口和配置。

cat /etc/rocky-release
sudo ss -lntp
systemctl is-active nginx httpd
sudo firewall-cmd --get-active-zones
getenforce
sudo dnf install nginx policycoreutils-python-utils
rpm -q nginx
sudo nginx -t

如果在 is-active 中有任何服务未安装或已停止,退出代码可能不是 0。请阅读状态检查结果以作出判断。如果 Apache 已经使用了端口 80,它将与默认的 Nginx 配置冲突,因此不要直接启动它。

在 Rocky 软件包 /etc/nginx/nginx.conf 中,include /etc/nginx/conf.d/*.conf; 被包含在 http 部分中。不要假设 Debian 或 Ubuntu 的 sites-available 结构;请检查实际的软件包设置。sudo nginx -T 输出需要应用的全部设置,但不要将任何机密值外泄。

sudo bash <<'BASH'
set -eu
test ! -e /root/lf-course25-before
install -d -m 0700 /root/lf-course25-before
cp -a /etc/nginx /root/lf-course25-before/nginx
BASH
sudo nginx -t && sudo systemctl start nginx
curl -sS -o /tmp/lf25-default-before.html -w 'HTTP %{http_code}\n' http://127.0.0.1/

如果第一次检查显示备份目录已存在,请停止并检查上一个练习的状态。上述命令基于一个端口为空的新练习环境。在此环境中默认站点返回 HTTP 200。我们不会完全替换默认配置文件,而是添加一个单独的文件。

创建文档目录和站点配置

本练习中使用的名称是 course25.test,文档目录是 /srv/lf-web25。.test 是一个测试名称,在 server_name 中写入该名称并不会创建将域名与 IP 地址关联的 DNS 记录。首先,通过指定 curl 的 Host 头测试站点名称。

sudo bash <<'BASH'
set -eu
test ! -e /srv/lf-web25
test ! -e /etc/nginx/conf.d/lf-course25.conf
LISTENERS=$(ss -H -lnt 'sport = :18025')
test -z "$LISTENERS"
install -d -m 0755 /srv/lf-web25
printf 'LF25 nginx site works\n' > /srv/lf-web25/index.html
chmod 0644 /srv/lf-web25/index.html
cat > /etc/nginx/conf.d/lf-course25.conf <<'EOF' 
server {
    listen 18025;
    server_name course25.test;
    root /srv/lf-web25;
    index index.html;
    access_log /var/log/nginx/lf-course25-access.log;
    error_log /var/log/nginx/lf-course25-error.log;
    location / {
        try_files $uri $uri/ =404;
    }
}
EOF
BASH

如果已有路径存在或端口 18025 被其他程序使用,请不要直接覆盖此示例。目录 0755 赋予遍历路径和读取目录列表的权限,而文件 0644 允许读取内容。无需将 Nginx 仅读取的静态文件的所有者更改为 Web 服务器账户,也无需将其权限设置为 0777。更高层级的路径也必须具有遍历权限。

设置 角色和需检查的点
listen 18025 这是接收请求的 TCP 端口。由于未指定 IPv4 地址,该练习还会接收来自外部接口的请求。外部公网范围受防火墙和虚拟机网络限制。
server_name 这是选择与访问相同地址和端口的请求名称匹配的服务器块的条件。它不是DNS注册或访问认证功能。
root 和 index 设置文件根路径和目录请求的默认文档。在这里,/ 请求被处理为 index.html。
try_files 查找与请求URI对应的文件或目录,如果未找到则返回404。$uri是Nginx变量。heredoc结束标识EOF使用单引号,因此shell不会展开正文中的变量,$uri被原样写入配置。
特定站点日志 将访问日志和错误日志文件分开,以避免不同站点的请求混合。

Nginx 的 官方入门文档 解释了配置块和提供静态文件的方法。在 try_files 指令文档 中,你可以查看文件搜索的含义以及最后的处理步骤。

SELinux 路径上下文和端口允许

即使一般的文件权限正确,SELinux 也必须允许访问。SELinux 将附加在进程和文件上的安全上下文与其策略进行比较。该环境中的 Nginx 进程运行在 httpd_t 域中,而新建的/srv内容路径最初为var_t。

ls -Zd /srv/lf-web25 /srv/lf-web25/index.html
sudo semanage fcontext -l -C
sudo semanage port -l | grep http_port_t
sudo semanage fcontext -a -t httpd_sys_content_t '/srv/lf-web25(/.*)?'
sudo restorecon -Rv /srv/lf-web25
sudo semanage port -a -t http_port_t -p tcp 18025
sudo nginx -t && sudo systemctl reload nginx
sudo ss -lntp 'sport = :18025'

semanage fcontext 注册将应用于路径的永久规则,而 restorecon 将这些规则应用于实际文件。仅注册规则不会立即更改现有文件的上下文。httpd_sys_content_t 用于将在此静态站点上阅读的文档,将它们与需要写权限以进行上传等操作的路径区分开。有关详细原则,请参阅 Rocky Linux SELinux 文档 。

端口18025是新注册的,因为在练习开始时它不在允许的HTTP端口中。如果该端口已为其他类型注册,请在收到错误后不要自动更改为-m。请先检查现有服务,然后选择可用端口或查看必要的策略范围。SELinux端口允许与在firewalld中允许网络数据包是分开的。

在原比较实验中,当最初只允许端口且文档为var_t时,发生了HTTP 403,并且审计日志记录了一个AVC(访问向量缓存)拒绝,其中httpd_t无法访问var_t文件。应用路径规则和restorecon后,它变为200。SELinux未被关闭,也没有将整个服务设置为宽容模式。

比较本地响应与另一台计算机的响应

curl -sS -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/
curl -sS -o /dev/null -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/missing

对于第一个请求,期望返回 LF25 nginx site works 和 200,而对于不存在的路径则期望返回 404。不要只看 200 这个数字;还要检查它是否是预期网站的内容。本地成功是 Nginx 和文档访问可能性的证据,但并不意味着外部网络路径成功。

检查外部接口所属的区域,并仅允许该区域的练习端口。下面的 public 是在此虚拟机上检查的值,因此在其他环境中请更改为实际值。不要修改现有的 SSH 允许规则。

sudo firewall-cmd --get-active-zones
sudo firewall-cmd --zone=public --add-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

在同一网络的另一台计算机上,使用实际的服务器 IPv4 地址发出请求。以下 IP 只是一个示例,因此不要照搬使用。在 Windows 中,您可以使用 curl.exe 来区分它与 PowerShell 别名。

curl --max-time 5 -sS -H 'Host: course25.test' http://192.0.2.10:18025/

VirtualBox 的 NAT(网络地址转换)环境不允许从主机直接访问虚拟机的地址。通过在虚拟机设置中添加一个实际规则:网络 → 适配器 1 → 高级 → 端口转发(TCP),主机 IP 127.0.0.1,主机端口 18025,以及虚拟机端口 18025,您可以从主机检查 http://127.0.0.1:18025/。如果将主机 IP 留空,暴露范围可能会增加,因此为了本地实践进行了指定。虚拟机防火墙仍然需要允许访问。

在原练习中,通过 Windows 中的 curl 通过 localhost NAT 转发向虚拟机发出请求。在允许防火墙之前,它在 4 秒内无响应而超时;在允许运行时端口后,确认了相同的内容和 200。这并不是测试互联网公共访问或实际 DNS 查询的成功。

sudo firewall-cmd --permanent --zone=public --add-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --query-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

两个查询都必须是 yes,以反映当前和保存的设置。你不需要重新加载整个防火墙来单独添加当前允许和永久允许。在此阶段,尚未进行重启持久性测试。两种设置之间的区别也在 防火墙官方端口允许文档 中进行了说明。http 的标准 HTTP 服务定义通常指端口 80,因此不要将其与此非标准端口允许混淆。

通过区分 403、404 和配置错误进行诊断

如果连接被拒绝或超时,首先检查监听器、地址和虚拟机网络,以及实际区域。如果收到 HTTP 响应,请检查处理该请求的网站及日志。不要仅根据 403 就断定是 SELinux 问题。

sudo nginx -t
sudo systemctl status nginx --no-pager
sudo journalctl -u nginx -b -n 30 --no-pager
sudo tail -n 20 /var/log/nginx/lf-course25-access.log
sudo tail -n 20 /var/log/nginx/lf-course25-error.log
namei -l /srv/lf-web25/index.html
ls -Z /srv/lf-web25/index.html
sudo ausearch --input-logs -m AVC -c nginx -ts recent -i

实际上,即使保持了正确的 SELinux 上下文,将文件更改为 root 拥有的 0600 也会导致 403,而将其恢复为 0644 则返回 200。错误日志中的 Permission denied 可能来自常规权限和 SELinux,因此应将失败请求时的 AVC 事件与路径权限相关联。不应仅因为没有日志就确定特定原因。不存在路径的 404 是 try_files 的预期结果。

修改设置后,使用sudo nginx -t && sudo systemctl reload nginx,只有语法检查成功才重载;随后还需另行验证新连接。在实践中,当向文件中添加了不存在的指令时,配置检查会以退出代码 1 失败,但尚未应用的现有 Nginx 进程仍然返回 200,并且 PID 相同。立即将错误的文件恢复到原始内容并重新检查。不要仅因为返回之前的响应就认为存储的配置是正常的。

此外,对于这个 18025 实例,只有一个服务器块,因此即使通过 Host: another.test 请求,相同的网站也会返回 200。这是因为如果没有匹配的名称,可能会选择该地址和端口的默认服务器。server_name不是访问控制机制,如果你想拒绝未知名称,需要设计一个单独的默认服务器和明确的响应策略。有关名称选择的详细规则,请参考 Nginx 服务器名称文档 。

验证现有站点并删除实验配置

在新网站建立后,还要检查原来的端口 80 默认站点。将其与最初保存的响应进行比较时,正文应保持一致,以确认当前的静态默认页面未被更改。由于实际运行站点的动态响应可能随时间变化,核心功能、状态和内容应分别进行比较。

curl -sS -o /tmp/lf25-default-after.html -w 'HTTP %{http_code}\n' http://127.0.0.1/
cmp /tmp/lf25-default-before.html /tmp/lf25-default-after.html
sudo diff -u /root/lf-course25-before/nginx/nginx.conf /etc/nginx/nginx.conf

在三次原课程记录的比较中,默认站点都返回了 200,响应正文相同。现有的配置文件,包括 nginx.conf,都已保留。如果该服务器将继续使用,仅保留必要的网站,并且在需要重启后自动启动时,选择 sudo systemctl enable nginx,然后单独验证重启情况。

在删除练习时,先将你添加的网站文件移动到备份位置,然后检查并重新加载。以下命令仅适用于本课程中新创建的文件和规则。不要删除你重复使用的任何现有路径或端口规则。

sudo mv /etc/nginx/conf.d/lf-course25.conf /root/lf-course25-before/site.conf
sudo nginx -t && sudo systemctl reload nginx
sudo firewall-cmd --zone=public --remove-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --remove-port=18025/tcp
sudo semanage fcontext -d '/srv/lf-web25(/.*)?'
sudo semanage port -d -p tcp 18025
sudo rm -- /srv/lf-web25/index.html
sudo rmdir /srv/lf-web25

设置应用后,检查监听器 18025 是否已消失,并删除添加到虚拟机的端口转发规则。如有必要,请备份练习日志。在原实验虚拟机中,新的日志已被存储,网站文件、文档、策略、防火墙和 NAT 规则在停止 Nginx 前已被清理。现有设置和防火墙已与原始状态进行比较,同时保持 SSH、firewalld 活动状态以及 SELinux Enforcing。Nginx 软件包保留用于后续练习。