Tutorial do Rocky Linux 10 / Nginx no Rocky Linux 10: site estático, SELinux e firewall

Para configurar um site Nginx no Rocky Linux 10, você precisa separar a configuração do site e os diretórios de documentos, e verificar a configuração do Nginx, as permissões de arquivo, o contexto SELinux e o firewall em ordem. Neste tutorial, manteremos o site padrão existente na porta 80 enquanto adicionamos um site estático na porta 18025, e compararemos as respostas localmente e de outros computadores.

Âmbito da prática e verificação dos sites existentes

Nginx é um servidor web que recebe solicitações e entrega arquivos ou encaminha solicitações para outros programas. Aqui, lidamos apenas com sites estáticos que servem arquivos diretamente. Executar PHP, proxy reverso e certificados HTTPS exigem configuração separada.

Execute o exercício em uma máquina virtual (VM) separada com Rocky Linux 10, com um usuário que tenha privilégios de sudo e acesso ao console preparado. O ambiente de laboratório de origem era Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux Enforcing. Neste ambiente, o Apache estava parado e não havia nenhum processo escutando nas portas web. Se houver quaisquer serviços atualmente em execução, você deve verificar portas e configurações antes de instalar e iniciar.

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

Se algum serviço não foi instalado ou foi parado em is-active, o código de saída pode não ser 0. Leia os resultados da verificação de status para fazer um julgamento. Se o Apache já estiver usando a porta 80, ele entrará em conflito com a configuração padrão do Nginx, portanto, não o inicie tal como está.

No pacote Rocky /etc/nginx/nginx.conf, include /etc/nginx/conf.d/*.conf; foi incluído na seção http. Não presuma a estrutura sites-available do Debian ou Ubuntu; verifique as configurações reais do pacote. sudo nginx -T gera todas as configurações a serem aplicadas, mas não compartilhe nenhum valor secreto externamente.

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/

Se a primeira verificação mostrar que um diretório de backup já existe, pare e verifique o estado do exercício anterior. O comando acima é baseado em um novo ambiente de exercício com portas vazias. O site padrão neste ambiente retornou HTTP 200. Em vez de substituir o arquivo de configuração padrão completamente, adicionaremos um arquivo separado.

Crie o diretório de documentos e a configuração do site

O nome a ser usado neste exercício é course25.test, e o diretório de documentos é /srv/lf-web25. .test é um nome de teste, e escrever esse nome em server_name não cria um registro DNS que vincule o nome de domínio a um endereço IP. Primeiro, teste especificando o nome do site usando o cabeçalho Host do curl.

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

Se houver um caminho existente ou a porta 18025 estiver sendo usada por outro programa, não sobrescreva este exemplo como está. O diretório 0755 concede permissão para percorrer o caminho e ler a listagem do diretório, enquanto o arquivo 0644 permite ler o conteúdo. Não é necessário alterar o proprietário dos arquivos estáticos que o Nginx apenas lê para a conta do servidor web ou abri-los com 0777. Caminhos de nível superior também devem ter permissões de travessia.

Configurações Funções e Pontos a Verificar
listen 18025 Esta é a porta TCP que recebe solicitações. Como um endereço IPv4 não foi especificado, este exercício recebe solicitações de interfaces externas também. O alcance público externo é limitado pelo firewall e pela rede da VM.
server_name Esta é a condição para selecionar o bloco de servidor que corresponde ao nome das solicitações que chegam ao mesmo endereço e porta. Não é um recurso de registro DNS ou autenticação de acesso.
root e index Define o caminho raiz dos arquivos e o documento padrão para solicitações de diretório. Aqui, as solicitações / são tratadas como index.html.
try_files Encontra o arquivo ou diretório correspondente ao URI da solicitação e retorna 404 se não for encontrado. $uri é uma variável do Nginx, não uma variável de shell, então é armazenada como está em um heredoc com aspas.
Logs específicos do site Separa arquivos de log de acesso e de erro para evitar misturar solicitações de sites diferentes.

O documento introdutório oficial do Nginx explica blocos de configuração e métodos para servir arquivos estáticos. No documento da diretiva try_files , você pode verificar o significado da busca de arquivos e a última etapa de processamento.

Contextos de caminho e permissões de porta do SELinux

Mesmo que as permissões gerais de arquivos estejam corretas, o SELinux deve permitir o acesso. O SELinux compara os contextos de segurança atribuídos a processos e arquivos com suas políticas. O processo do Nginx nesse ambiente rodava no domínio httpd_t, e o novo diretório de documentos em /srv tinha inicialmente o tipo 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 registra regras permanentes a serem aplicadas a caminhos, e restorecon aplica essas regras aos arquivos reais. Apenas registrar as regras não altera imediatamente o contexto dos arquivos existentes. httpd_sys_content_t é usado para documentos a serem lidos neste site estático, distinguindo-os de caminhos que exigem permissões de escrita para ações como uploads. Para princípios detalhados, consulte a documentação do SELinux do Rocky Linux.

A porta 18025 foi recém-registrada porque não estava incluída nas portas HTTP permitidas no início da prática. Se a porta já estiver registrada para outro tipo, não a altere automaticamente para -m após receber um erro. Verifique os serviços existentes primeiro, depois escolha uma porta disponível ou revise o escopo de política necessário. A permissão de porta do SELinux é separada de permitir pacotes de rede no firewalld.

Na comparação registrada no laboratório de origem, quando apenas a porta foi permitida primeiro e o documento era var_t, ocorreu HTTP 403, e o log de auditoria registrou uma negação AVC (Access Vector Cache) onde httpd_t não pôde acessar o arquivo var_t. Após aplicar regras de caminho e restorecon, mudou para 200. O SELinux não foi desligado, nem todo o serviço foi configurado como permissivo.

Comparação da resposta local com a resposta de outro computador

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

Para a primeira solicitação, LF25 nginx site works e 200 são esperados, e espera-se que um caminho inexistente retorne 404. Não olhe apenas para o número 200; verifique também se é o conteúdo esperado do site. O sucesso local é evidência de que o Nginx e o acesso a documentos são possíveis, mas não significa que o caminho da rede externa tenha sido bem-sucedido.

Verifique a zona à qual a interface externa pertence e permita apenas as portas de prática para essa zona. O public abaixo é o valor verificado nesta VM, então altere para o valor real em outros ambientes. Não modifique as regras de permissão SSH existentes.

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

Em outro computador na mesma rede, faça a solicitação usando o endereço IPv4 real do servidor. O seguinte IP é um exemplo, portanto, não o use como está. No Windows, você pode usar curl.exe para distingui-lo dos aliases do PowerShell.

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

O ambiente NAT (Network Address Translation) do VirtualBox não permite acesso direto ao endereço do convidado a partir do host. Adicionando uma regra prática nas configurações da VM: Rede → Adaptador 1 → Avançado → Encaminhamento de Portas com TCP, IP do Host 127.0.0.1, Porta do Host 18025 e Porta do Convidado 18025, você pode verificar http://127.0.0.1:18025/ a partir do host. Se você deixar o IP do Host vazio, o alcance de exposição pode aumentar, portanto, ele é especificado para prática local. Ainda é necessária a permissão do firewall do convidado.

Na prática de origem, requisições foram feitas para a VM através do encaminhamento NAT localhost a partir do curl no Windows. Antes de permitir o firewall, ocorreu um tempo limite sem resposta por 4 segundos, e após liberar a porta na configuração em execução, o mesmo conteúdo e 200 foram confirmados. Isso não testa o acesso público à internet nem o sucesso real da consulta 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

Ambas as consultas devem ser yes para refletir as configurações atuais e salvas. Você não precisa recarregar todo o firewall para adicionar separadamente a permissão atual e a permissão permanente. Neste estágio, o teste de persistência após o reinício não foi realizado. A distinção entre as duas configurações também é explicada na documentação oficial de liberação de portas do firewalld. A definição de serviço http do HTTP padrão geralmente significa a porta 80, então não a confunda com esta permissão de porta não padrão.

Diagnostique distinguindo entre erros 403, 404 e erros de configuração

Se a conexão for recusada ou expirar, verifique primeiro o listener, o endereço e a rede da VM, e a zona real. Se chegar uma resposta HTTP, verifique o site que atendeu a essa solicitação e os logs. Não conclua que seja um problema de SELinux apenas com base em um 403.

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

Na prática, mesmo que o contexto SELinux correto seja mantido, alterar o arquivo para 0600 de propriedade do root resultou em um 403, e revertê-lo para 0644 retornou 200. O Permission denied no log de erro pode aparecer tanto por permissões regulares quanto por SELinux, portanto, correlacione eventos AVC no momento da solicitação falhada com as permissões do caminho. Não determine uma causa específica apenas pelo fato de não haver log. Um 404 para um caminho inexistente é o resultado esperado deste try_files.

Após modificar as configurações, conecte o sucesso da verificação e a aplicação como em sudo nginx -t && sudo systemctl reload nginx. Na prática, quando uma diretiva inexistente foi adicionada a um arquivo, a verificação da configuração falhou com o código de saída 1, mas o processo Nginx existente que ainda não a havia aplicado continuou retornando 200 com o mesmo PID. Reverteu-se imediatamente o arquivo incorreto para seu conteúdo original e verificou-se novamente. Não julgue a configuração armazenada como normal apenas porque retorna a resposta anterior.

Além disso, para esta instância 18025, havia apenas um bloco de servidor, então mesmo ao solicitar via Host: another.test, o mesmo site retornou 200. Isso acontece porque, se não houver um nome correspondente, o servidor padrão para esse endereço e porta pode ser selecionado. server_name não é um dispositivo de restrição de acesso, e se você quiser rejeitar nomes desconhecidos, é necessário projetar um servidor padrão separado e uma política de resposta explícita. Para regras detalhadas sobre seleção de nomes, consulte o documento nomes de servidor Nginx .

Verifique o site existente e remova a configuração do laboratório

Depois que o novo site for configurado, verifique também o site padrão original na porta 80. Ao compará-lo com a resposta inicialmente salva, o corpo deve ser o mesmo para concluir que a página padrão estática atual não foi alterada. Como respostas dinâmicas de sites em operação podem variar ao longo do tempo, as funções principais, status e conteúdo devem ser comparados separadamente.

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

Nas três comparações de origem registradas, o site padrão retornou 200 e os corpos das respostas eram os mesmos. Os arquivos de configuração existentes, incluindo nginx.conf, foram mantidos. Se este servidor continuar a ser usado, mantenha apenas os sites necessários e, quando for necessário o início automático após reinicialização, selecione sudo systemctl enable nginx e depois verifique a reinicialização separadamente.

Ao remover a prática, primeiro mova os arquivos do site que você adicionou para um local de backup, depois verifique e recarregue. Os seguintes comandos se aplicam apenas aos arquivos e regras recém-criados neste curso. Não exclua nenhuma regra de caminho ou porta existente que você tenha reutilizado.

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

Após as configurações serem aplicadas, verifique se o listener 18025 desapareceu e exclua as regras de encaminhamento de porta adicionadas à VM. Faça backup dos logs da prática, se necessário. Na VM de origem, novos logs foram armazenados, e os arquivos do site, documentos, políticas, regras de firewall e NAT foram limpos antes de parar o Nginx. As configurações existentes e o firewall foram comparados ao estado original, enquanto SSH, status ativo do firewalld e SELinux Enforcing foram mantidos. O pacote do Nginx foi mantido para práticas subsequentes.