SELinux i nginx: przyczyna błędu 403 mimo uprawnień
nginx zwraca 403 mimo prawidłowych uprawnień? Sprawdź odmowę SELinux, popraw etykietę przez semanage i restorecon, pozostawiając tryb enforcing.
Dlaczego nginx zwraca 403 dla pliku, którego uprawnienia są prawidłowe
Jeśli nginx zwraca 403 dla pliku, którego bity uprawnień są prawidłowe, niemal zawsze oznacza to, że SELinux (security-enhanced Linux) odrzuca odczyt. SELinux sprawdza drugi zestaw reguł po przejściu standardowej kontroli uprawnień. Serwer WWW może odczytywać tylko pliki opatrzone etykietą treści WWW. Plik ma inną etykietę, dlatego operacja otwarcia kończy się niepowodzeniem i nginx nie ma czego wysłać.
Należy sprawdzić etykietę, a nie tylko tryb uprawnień:
ls -ldZ /data/www /data/www/index.htmldrwxr-xr-x. root root unconfined_u:object_r:default_t:s0 /data/www
-rw-r--r--. root root unconfined_u:object_r:default_t:s0 /data/www/index.htmlKropka wyświetlana po drwxr-xr-x oznacza, że plik ma etykietę SELinux. default_t to wartość przypisywana ścieżce, o której zasadach nigdy nie było informacji. Żadna reguła serwera WWW nie zezwala na odczyt tego typu. Dziennik błędów pokazuje zwykły błąd systemu Unix, dlatego problem wygląda jak błąd uprawnień:
2026/08/11 09:14:02 [error] 1183#1183: *1 open() "/data/www/index.html" failed (13: Permission denied), client: 203.0.113.9, server: _, request: "GET / HTTP/1.1"Jądro zwraca 13: Permission denied w przypadku obu rodzajów odmowy: zwykłej oraz wynikającej z SELinux. Najpierw należy więc ustalić, która warstwa odrzuciła operację. Nie należy zaczynać od setenforce 0.
Część modelu, której potrzebujesz
SELinux to mechanizm obowiązkowej kontroli dostępu, zwykle określany skrótem MAC. Każdy proces działa w domenie, takiej jak httpd_t w przypadku serwera WWW. Każdy plik i każdy port sieciowy ma przypisany typ, taki jak httpd_sys_content_t. Polityka zawiera listę dozwolonych kombinacji domeny, typu i działania. Wszystko, czego nie ma na tej liście, jest odrzucane. Kontrola SELinux działa po klasycznej kontroli systemu Unix, dlatego bity uprawnień w drwxr-xr-x również muszą najpierw zezwalać na dostęp. Obie warstwy muszą zezwolić na operację.
Pełny kontekst ma cztery pola oddzielone dwukropkami, na przykład system_u:system_r:httpd_t:s0: użytkownika SELinux, rolę, typ i poziom. Na serwerze niemal zawsze analizuje się trzecie pole, czyli typ. Bieżące wartości można wyświetlić za pomocą dwóch poleceń:
ps -eZ | grep nginx
id -ZProcesy robocze nginx mają kontekst zakończony wartością httpd_t. Powłoka po zalogowaniu ma wartość unconfined_u:unconfined_r:unconfined_t:s0, ponieważ domyślna polityka targeted ogranicza usługi, ale nie ogranicza interaktywnych użytkowników. Jest to istotne, ponieważ SELinux nie zastępuje uruchamiania usług z użyciem użytkowników o minimalnych uprawnieniach. Ogranicza zasoby dostępne dla usługi po jej przejęciu przez atakującego.
Trzy tryby oraz obrazy, w których jest SELinux
sestatus
getenforceTryb Enforcing blokuje operacje i zapisuje je w dzienniku. Tryb Permissive zezwala na wszystkie operacje i zapisuje informacje o tym, co zostałoby zablokowane. Tryb Disabled nie ładuje żadnej polityki. getenforce wyświetla bieżący tryb. sestatus wyświetla również tryb z /etc/selinux/config, czyli ten, który zostanie przywrócony po ponownym uruchomieniu.
Rocky Linux, AlmaLinux, Fedora i RHEL są dostarczane z SELinux w trybie Enforcing oraz z polityką targeted. Ten wspólny domyślny wybór wynika ze wspólnego pochodzenia tych systemów, a nie z przypadku, ponieważ wszystkie wywodzą się z tej samej linii Red Hat, która obejmowała CentOS, zanim pojawiły się Rocky Linux i AlmaLinux. Wybór jednego z tych dwóch systemów nie wpływa na informacje przedstawione na tej stronie, ponieważ dostarczają tę samą politykę i te same narzędzia. Dlatego wybór między Rocky Linux i AlmaLinux zależy od deklarowanej zgodności oraz obsługi starszych procesorów, a nie od domyślnych ustawień zabezpieczeń. Ubuntu i Debian są dostarczane z AppArmor, który pełni tę samą funkcję, ale wykorzystuje inny mechanizm. Omówiono go w ostatniej sekcji. Dlatego ta sama aplikacja może zainstalować się poprawnie na jednym serwerze, a na innym zwracać kod 403.
Zainstaluj narzędzia, zanim będą potrzebne
sudo dnf install -y policycoreutils-python-utils setroubleshoot-serversemanage: command not found na obrazie minimalnym oznacza brak pakietu policycoreutils-python-utils: ten pakiet zawiera semanage i audit2allow. setroubleshoot-server dodaje sealert i zapisuje w dzienniku zrozumiałe podsumowanie każdego odrzucenia. Zainstaluj oba pakiety na nowym serwerze, ponieważ gdy stają się potrzebne, coś jest już zepsute.
Jak odczytać odmowę SELinux w dzienniku audit
Każda odmowa jest zapisywana przez demona audit jako komunikat AVC (access vector cache):
sudo ausearch -m AVC,USER_AVC,SELINUX_ERR -ts recenttype=AVC msg=audit(1754896442.881:412): avc: denied { read } for pid=1183 comm="nginx" name="index.html" dev="vda1" ino=17203 scontext=system_u:system_r:httpd_t:s0 tcontext=unconfined_u:object_r:default_t:s0 tclass=file permissive=0Całą informację zawierają cztery pola. comm to program, którego działanie zablokowano. scontext to kontekst źródłowy, czyli domena, w której działał proces. tcontext to kontekst docelowy, czyli etykieta obiektu, do którego proces próbował uzyskać dostęp. tclass określa typ obiektu, w tym przypadku plik. Odczytane razem oznaczają, że proces w httpd_t próbował odczytać plik oznaczony etykietą default_t, a permissive=0 wskazuje, że żądanie rzeczywiście zablokowano, a nie tylko zapisano w dzienniku.
Jeśli ausearch nic nie wyświetla, demon audit może nie działać. Odmowy trafiają wtedy do bufora pierścieniowego jądra:
sudo journalctl -k | grep -i avcTeraz przekształć rekord w zdanie:
sudo ausearch -m AVC -ts recent | audit2why
sudo journalctl -t setroubleshoot --since today
sudo sealert -a /var/log/audit/audit.logaudit2why odczytuje te same rekordy i wskazuje rozpoznaną przyczynę: wyłączony boolean, etykietę niezgodną z polityką albo całkowity brak reguły. sealert przegląda cały dziennik i wyświetla sugerowane polecenie dla każdej odmowy. Traktuj sugestię jako wskazówkę. Treść komunikatów zmienia się między wydaniami, a sealert czasami proponuje niestandardowy moduł polityki, mimo że prawidłowym rozwiązaniem jest jednoliniowa poprawka etykiety.
Należy znać jeszcze jedną rzecz. Polityka zawiera reguły dontaudit, które ukrywają odmowy uznane za nieszkodliwe. Program może więc działać nieprawidłowo, mimo że dziennik pozostaje pusty. Odkryj te odmowy na czas jednego testu:
sudo semodule -DB
# reproduce the problem, then read the log again
sudo semodule -BNaprawa nieprawidłowej etykiety ścieżki za pomocą semanage fcontext i restorecon
Należy użyć dwóch poleceń, a kolejność ma znaczenie. semanage fcontext -a rejestruje, jaka powinna być etykieta ścieżki. restorecon stosuje zarejestrowaną etykietę domyślną do plików na dysku.
sudo semanage fcontext -a -t httpd_sys_content_t "/data/www(/.*)?"
sudo restorecon -Rv /data/www
ls -ldZ /data/www/index.htmlŚcieżka jest wyrażeniem regularnym. (/.*)? obejmuje sam katalog oraz całą jego zawartość, co jest wymagane w przypadku katalogu głównego dokumentów. Przed wprowadzeniem zmiany należy sprawdzić jej przewidywany zakres: sudo restorecon -Rvn /data/www wyświetla planowane zmiany etykiet, ponieważ -n oznacza brak wykonywania operacji. Po rzeczywistym wykonaniu restorecon etykieta ma wartość httpd_sys_content_t, a błąd 403 znika bez restartowania usługi.
chcon należy używać wyłącznie do testów. chcon -t httpd_sys_content_t index.html ustawia etykietę bezpośrednio, a następne restorecon, aktualizacja pakietów lub pełne ponowne etykietowanie ją resetuje, ponieważ polityka nadal określa inną etykietę dla tej ścieżki. Na serwerze, na którym dnf-automatic stosuje aktualizacje zabezpieczeń zgodnie z harmonogramem, reset nastąpi zgodnie z własnym harmonogramem, a nie wtedy, gdy użytkownik pracuje bezpośrednio na maszynie. W rezultacie witryna może przestać działać kilka godzin po ostatniej wykonanej zmianie. semanage fcontext to wersja, która pozostaje zachowana. Zarejestrowane ustawienia można wyświetlić za pomocą sudo semanage fcontext -l | grep '^/data'.
Dla treści, którą usługa musi zapisywać, wymagany jest inny typ. Należy użyć httpd_sys_rw_content_t dla katalogu przesyłania lub pamięci podręcznej i ograniczyć ten typ do tych ścieżek. Witryna tylko do odczytu z typem umożliwiającym zapis zapewnia aplikacji większy zakres dostępu, niż jest jej potrzebny.
Dlaczego etykieta była nieprawidłowa? Niemal zawsze wynika to ze sposobu dostarczenia plików. mv zachowuje istniejącą etykietę pliku, dlatego witryna przeniesiona z /root otrzymuje etykietę admin_home_t i pozostaje z nią. Zwykłe cp nadaje nowemu plikowi domyślną etykietę katalogu docelowego, co zazwyczaj jest właściwym rozwiązaniem, natomiast cp -a i rsync -X kopiują etykiety źródłowe razem z plikiem. git clone do nowego katalogu najwyższego poziomu powoduje powstanie default_t. Gdy strona ładuje się poprawnie z /usr/share/nginx/html, ale nie działa z własnego katalogu, przyczyną jest właśnie to.
Naprawianie określonej klasy problemów za pomocą wartości logicznej
Niektóre awarie nie wynikają z problemu z etykietą. Reverse proxy na świeżo zainstalowanym systemie Rocky lub AlmaLinux zwraca kod 502, a dziennik błędów zawiera wpis:
2026/08/11 10:02:55 [crit] 1183#1183: *3 connect() to 127.0.0.1:3000 failed (13: Permission denied) while connecting to upstreamBackend działa prawidłowo. Domena httpd_t domyślnie nie może otwierać wychodzących połączeń sieciowych, dlatego wywołanie connect() zostaje odrzucone, zanim dotrze do interfejsu loopback. Całym tym zachowaniem steruje jeden przełącznik:
getsebool -a | grep httpd_can_network
sudo setsebool -P httpd_can_network_connect onIstotną flagą jest -P. Zapisuje ona wartość na dysku. Bez -P zmiana zostanie utracona przy następnym restarcie, co powoduje, że usługa działa tylko do czasu ponownego uruchomienia komputera. Potwierdzenie umożliwia semanage boolean -l | grep httpd_can_network_connect, które wyświetla bieżącą wartość obok wartości zapisanej.
Jeżeli istnieje odpowiednia wartość logiczna, należy użyć jej zamiast ręcznie tworzonej reguły. Wartości logiczne są dostarczane wraz z polityką dystrybucji, dlatego są utrzymywane, udokumentowane i łatwe do znalezienia przez kolejną osobę. getsebool -a wyświetla wszystkie wartości logiczne dostępne w systemie.
Ustawienie nasłuchiwania usługi na niestandardowym porcie
Porty również podlegają etykietowaniu. Przeniesienie nginx na port 8081 powoduje odmowę startu:
nginx: [emerg] bind() to 0.0.0.0:8081 failed (13: Permission denied)httpd_t może wiązać porty oznaczone jako http_port_t, a 8081 do nich nie należy. Nie jest to również port nieoznaczony: polityka podstawowa przypisuje tcp/8081 do transproxy_port_t, a port może posiadać tylko jeden typ. Należy zatem wyszukać sam port, a następnie zmodyfikować jego wpis zamiast dodawać nowy:
sudo semanage port -l | grep -w 8081
sudo semanage port -m -t http_port_t -p tcp 8081Pierwsze polecenie pokazuje 8081 w ramach transproxy_port_t, dlatego przeszukiwanie listy wyłącznie pod kątem http_port_t nie ujawnia konfliktu. Wiele wysokich portów znajduje się już w http_port_t, w tym 8008 oraz 8443, więc nie wymagają one żadnych zmian. Dla portu, do którego nie przypisano jeszcze typu, właściwym poleceniem jest -a. W systemach Rocky Linux oraz AlmaLinux 9 pakiet semanage (policycoreutils 3.6-5.el9) zawiera poprawkę, która zmienia -a na porcie już zdefiniowanym w modyfikację i wyświetla Port tcp/8081 already defined, modifying instead, podczas gdy niepoprawiony policycoreutils 3.6 kończy działanie błędem ValueError: Port tcp/8081 already defined i nie nadaje żadnych etykiet. Użycie -m dla portu posiadającego już typ daje ten sam rezultat w obu przypadkach.
To samo polecenie sprawia, że przeniesiony port SSH zaczyna działać. Bind to port 2222 on 0.0.0.0 failed: Permission denied w journalctl -u sshd oznacza, że 2222 brakuje w ssh_port_t, więc przed restartem demona i zamknięciem sesji należy wykonać sudo semanage port -a -t ssh_port_t -p tcp 2222. Jest to krok pomijany przez użytkowników korzystających z ogólnych poradników dotyczących zabezpieczania SSH na VPS w systemach z rodziny Red Hat. SELinux nie jest firewallem, więc port musi zostać otwarty: sudo firewall-cmd --permanent --add-port=8081/tcp && sudo firewall-cmd --reload w tym przypadku, lub ufw w systemie Debian lub Ubuntu. Flaga --permanent niesie ze sobą tę samą pułapkę przy restarcie co -P w przypadku wartości logicznej (boolean), a strefy decydujące o tym, do których interfejsów stosuje się reguła, warto poznać czytając podstawy firewalld dla VPS z systemem Rocky lub AlmaLinux.
Gdy nie ma ustawienia boolean ani etykiety do zmiany
Na zwykłym serwerze zdarza się to rzadko. W tym miejscu najłatwiej spowodować szkody. audit2allow może zbudować moduł zasad na podstawie odmów dostępu zapisanych w dzienniku:
sudo ausearch -m AVC -ts recent -c nginx | audit2allow -M nginx_local
cat nginx_local.te
sudo semodule -i nginx_local.ppPrzed instalacją modułu należy przeczytać nginx_local.te. Bezpieczne wykonanie tej operacji wymaga dwóch zasad. Za pomocą -c należy ograniczyć dane wejściowe do jednego programu, który jest naprawiany. Przekazanie przez potok tygodnia niezwiązanych odmów dostępu do audit2allow spowoduje jednoczesne przyznanie wszystkich tych uprawnień. Nie wolno też instalować modułu zbudowanego na podstawie odmowy dostępu, której nie można wyjaśnić. Regułę zezwalającą httpd_t na odczyt każdego pliku w systemie łatwo wygenerować, ale trudno zauważyć po kilku miesiącach. Moduł usuwa się za pomocą sudo semodule -r nginx_local.
Tryb permissive służy do diagnostyki, a nie do naprawy
sudo setenforce 0
# reproduce the problem once, all the way through
sudo ausearch -m AVC -ts recent
sudo setenforce 1Tryb permissive zezwala na dostęp i zapisuje informację o nim w dzienniku. Jego rzeczywistą wartością jest kompletność. W trybie enforcing usługa zatrzymuje się przy pierwszym odmówionym dostępie. Po naprawieniu tego problemu i ponownym uruchomieniu pojawia się kolejny. W trybie permissive działanie jest kontynuowane, a dziennik zbiera wszystkie odmowy w jednym przebiegu. Następnie można ponownie włączyć tryb enforcing i naprawić je razem.
setenforce nie zmienia /etc/selinux/config, dlatego po ponownym uruchomieniu system wraca do trybu enforcing. Jest to zabezpieczenie. Z tego samego powodu „naprawa” polegająca na użyciu setenforce 0 pojawia się ponownie w najmniej odpowiednim momencie. Jeśli podczas pracy tylko jedna usługa potrzebuje tymczasowo szerszych uprawnień, należy oznaczyć jej domenę zamiast całego systemu: sudo semanage permissive -a httpd_t pozostawia pozostałe domeny w trybie enforcing, a sudo semanage permissive -d httpd_t cofa tę zmianę.
Dlaczego wyłączenie SELinux kosztuje więcej niż naprawa etykiety
Ustawienie SELINUX=disabled w /etc/selinux/config zastępuje jednowierszową naprawę etykiety trwale słabszą ochroną serwera. Różnica staje się widoczna w dniu, w którym aplikacja internetowa zostanie przejęta. W trybie enforcing kod atakującego działa w httpd_t, więc może odczytywać zawartość serwisu, natomiast odczyt /etc/shadow lub zapis jednostki systemd zostanie odrzucony przez politykę niezależnie od uprawnień, jakie zezwalałby użytkownik Unix. Bez załadowanej polityki ten sam kod uzyskuje wszystko, do czego ma dostęp konto usługi.
Wyłączenie SELinux powoduje również późniejsze koszty. Gdy żadna polityka nie jest załadowana, nowe pliki są tworzone bez etykiety, przez co stan systemu plików przestaje odpowiadać polityce. Ponowne włączenie SELinux wymaga wtedy pełnego ponownego etykietowania albo prowadzi do jednoczesnego niepowodzenia wielu usług:
sudo fixfiles -F onboot
sudo rebootPolecenie zapisuje /.autorelabel i podczas następnego uruchomienia ponownie etykietuje każdy system plików. Na dużym dysku trwa to długo, a konsola może wyglądać na zawieszoną. Należy więc rozpocząć tę operację wtedy, gdy można poczekać. Skoro komputer i tak zostanie wyłączony, warto najpierw sprawdzić, jakie inne komponenty oczekują na ponowne uruchomienie. Informacje te przedstawia needs-restarting po tym, jak aktualizacja dnf pozostawiła stare jądra i biblioteki w pamięci. W Rocky Linux i AlmaLinux 9 plik konfiguracyjny nie wyłącza już samodzielnie mechanizmu SELinux w jądrze. Udokumentowany sposób pełnego wyłączenia SELinux polega na użyciu argumentu jądra (sudo grubby --update-kernel ALL --args selinux=0). Znajomość tego polecenia jest przydatna podczas przejmowania cudzego serwera. Nie jest to jednak sposób naprawy błędu 403.
Kontenery wymagają dodatkowej etykiety
Na hoście z rodziny Red Hat procesy kontenerów działają w container_t i mogą odczytywać wyłącznie pliki oznaczone etykietą container_file_t. Dowiązanie bind mount z hosta kończy się w kontenerze błędem Permission denied, mimo że ls -l na hoście wygląda prawidłowo. Sufiks :Z informuje silnik kontenerów, aby zmienił etykietę punktu montowania:
docker run -d -v /data/appdata:/var/lib/app:Z myimage:Z oznacza katalog wyłącznie dla tego kontenera. :z oznacza go jako współdzielony między kontenerami. Wskazanie :Z na katalog używany przez inne usługi powoduje rekurencyjną zmianę etykiet w tym katalogu, co zakłóca działanie tych usług. Kontenerom należy więc przypisywać własne ścieżki. Jeśli silnik nie jest jeszcze zainstalowany na hoście, należy pamiętać, że polecenie docker w tych dystrybucjach często wskazuje na podprogram podman. Jest to szczegół, który kroki instalacji w Rocky i AlmaLinux uwzględniają, zanim pojawi się ten problem. Pozostała konfiguracja przebiega tak samo jak w przypadku każdego innego obrazu. Opisano ją w uruchamianiu Docker na VPS.
Ubuntu i Debian oferują AppArmor
To samo zadanie, inna konstrukcja. AppArmor ogranicza program na podstawie ścieżki do pliku wykonywalnego, korzystając z profilu w /etc/apparmor.d/, zamiast etykietowania plików na dysku. Nie ma tu nic do etykietowania ani restorecon. Zacznij tutaj:
sudo aa-status
sudo journalctl -k | grep -i apparmorOdmowa dostępu pojawia się jako apparmor="DENIED" operation="open" profile="/usr/sbin/nginx" name="/data/www/index.html" requested_mask="r". Schemat pracy jest taki sam: odczytaj odmowę, znajdź profil, zmień regułę. sudo apt install apparmor-utils udostępnia aa-complain (tryb permissive dla jednego profilu) oraz aa-enforce, aby przywrócić ustawienia. Ubuntu ogranicza wybrany zestaw usług pakietowych, a resztę pozostawia bez ograniczeń, dlatego należy sprawdzić aa-status, aby zobaczyć, co faktycznie jest aktywne, zamiast zakładać to z góry.
Jeden nawyk sprawdza się w obu systemach. Gdy usługa zgłasza Permission denied w odniesieniu do czegoś, co wydaje się poprawne, przeczytaj dziennik bezpieczeństwa, zanim zmienisz uprawnienia. Uprawnienia rzadko są przyczyną problemów.
FAQ
Dlaczego nginx zwraca błąd 403, mimo że uprawnienia do pliku są poprawne?
Ponieważ SELinux zablokował odczyt, a nie bity uprawnień. Serwer WWW działa w domenie httpd_t i może odczytywać wyłącznie pliki oznaczone jako zawartość WWW, więc plik z etykietą default_t lub admin_home_t jest odrzucany, a nginx nie ma czego serwować. Należy to potwierdzić za pomocą sudo ausearch -m AVC -ts recent, co wykaże scontext kończące się na httpd_t oraz tcontext zawierające błędny typ. Następnie należy ustalić poprawną etykietę i zastosować ją: sudo semanage fcontext -a -t httpd_sys_content_t "/data/www(/.*)?", a następnie sudo restorecon -Rv /data/www.
Czy uruchomienie setenforce 0 w celu naprawy usługi jest bezpieczne?
setenforce 0 to krok diagnostyczny, a nie rozwiązanie. Należy go użyć, aby jednorazowo odtworzyć problem, dzięki czemu dziennik zbierze wszystkie odmowy w jednym przebiegu, odczytać je za pomocą sudo ausearch -m AVC -ts recent, a następnie uruchomić sudo setenforce 1 i usunąć przyczyny. Serwer pozostawiony w trybie permissive rejestruje każdą odmowę, ale żadnej nie blokuje, więc generowany jest szum przy utracie ochrony. Jeśli jedna usługa wymaga swobody podczas prac, należy uruchomić sudo semanage permissive -a httpd_t, aby reszta systemu pozostała w trybie enforcing.
Jak uruchomić usługę na niestandardowym porcie przy włączonym SELinux?
Należy przypisać portowi typ, do którego usługa ma prawo się dowiązać. Najpierw należy sprawdzić sam port za pomocą sudo semanage port -l | grep -w 8081, ponieważ wiele portów jest już przypisanych do określonego typu. Port 8081 jest już oznaczony jako transproxy_port_t w polityce bazowej, więc serwer WWW na porcie 8081 wymaga sudo semanage port -m -t http_port_t -p tcp 8081. Port, do którego nie przypisano jeszcze żadnego typu, na przykład 2222 dla SSH, przyjmuje -a: sudo semanage port -a -t ssh_port_t -p tcp 2222. Bez tego kroku demon kończy działanie przy starcie z błędem bind() ... Permission denied, mimo że żaden inny proces nie zajmuje tego portu.
Czy Ubuntu posiada SELinux?
Nie. Ubuntu i Debian dostarczane są z AppArmor, który wymusza profil powiązany ze ścieżką pliku wykonywalnego, a nie z etykietami na plikach. Należy to sprawdzić za pomocą sudo aa-status i szukać linii apparmor="DENIED" w sudo journalctl -k. Ubuntu ogranicza wybrany zestaw usług pakietowych, więc wiele programów domyślnie działa bez ograniczeń. SELinux w trybie enforcing jest standardem w systemach Rocky Linux, AlmaLinux, Fedora oraz RHEL.