Tutorial Rocky Linux 10 / Mengonfigurasi situs statis Nginx dan mendiagnosis 403 serta 404

Untuk mengonfigurasi situs Nginx di Rocky Linux 10, Anda perlu memisahkan konfigurasi situs dan direktori dokumen, serta memeriksa konfigurasi Nginx, izin berkas, konteks SELinux, dan firewall secara berurutan. Dalam panduan ini, kita akan mempertahankan situs default yang ada di port 80 sambil menambahkan situs statis di port 18025, dan membandingkan respons secara lokal dan dari komputer lain.

Ruang lingkup praktik dan pemeriksaan situs yang sudah ada

Nginx adalah server web yang menerima permintaan dan mengirimkan file atau mem-proxy permintaan ke program lain. Di sini, kita hanya menangani situs statis yang menyajikan file secara langsung. Menjalankan PHP, reverse proxy, dan sertifikat HTTPS memerlukan konfigurasi terpisah.

Lakukan latihan pada mesin virtual (VM) Rocky Linux 10 terpisah dengan pengguna yang memiliki hak sudo dan akses konsol yang sudah disiapkan. Lingkungan lab sumber adalah Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux Enforcing. Di lingkungan ini, Apache dihentikan dan tidak ada listener port web yang ada. Jika ada layanan yang sedang berjalan, Anda harus memeriksa port dan konfigurasi sebelum menginstal dan memulai.

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

Jika ada layanan yang tidak diinstal atau dihentikan di is-active, kode keluar mungkin bukan 0. Baca hasil pemeriksaan status untuk membuat penilaian. Jika Apache sudah menggunakan port 80, itu akan bertabrakan dengan konfigurasi default Nginx, jadi jangan jalankan begitu saja.

Dalam paket Rocky /etc/nginx/nginx.conf, include /etc/nginx/conf.d/*.conf; disertakan di dalam bagian http. Jangan anggap struktur sites-available dari Debian atau Ubuntu; periksa pengaturan paket yang sebenarnya. sudo nginx -T mengeluarkan seluruh pengaturan yang akan diterapkan, tetapi jangan berbagi nilai rahasia secara eksternal.

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/

Jika pemeriksaan pertama menunjukkan bahwa direktori cadangan sudah ada, hentikan dan periksa keadaan latihan sebelumnya. Perintah di atas didasarkan pada lingkungan latihan baru dengan port kosong. Situs default di lingkungan ini mengembalikan HTTP 200. Alih-alih mengganti seluruh file konfigurasi default, kita akan menambahkan file terpisah.

Buat direktori dokumen dan konfigurasi situs

Nama yang digunakan dalam latihan ini adalah course25.test, dan direktori dokumen adalah /srv/lf-web25. .test adalah nama uji, dan menulis nama ini di server_name tidak membuat catatan DNS yang menghubungkan nama domain ke alamat IP. Pertama, uji dengan menentukan nama situs menggunakan header Host dari 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

Jika terdapat jalur yang sudah ada atau port 18025 sedang digunakan oleh program lain, jangan menimpa contoh ini begitu saja. Direktori 0755 memberikan izin untuk menelusuri jalur dan membaca daftar direktori, sedangkan file 0644 memungkinkan membaca isi. Tidak perlu mengubah pemilik file statis yang hanya dibaca Nginx ke akun server web atau membuka file dengan 0777. Jalur tingkat atas juga harus memiliki izin penelusuran.

Pengaturan Peran dan Poin untuk Diperiksa
listen 18025 Ini adalah port TCP yang menerima permintaan. Karena alamat IPv4 tidak ditentukan, latihan ini menerima permintaan dari antarmuka eksternal juga. Jangkauan publik eksternal dibatasi oleh firewall dan jaringan VM.
server_name Ini adalah kondisi untuk memilih blok server yang sesuai dengan nama permintaan yang datang ke alamat dan port yang sama. Ini bukan fitur registrasi DNS atau autentikasi akses.
root dan index Menetapkan jalur root file dan dokumen default untuk permintaan direktori. Di sini, permintaan / ditangani sebagai index.html.
try_files Menemukan file atau direktori yang sesuai dengan URI permintaan, dan mengembalikan 404 jika tidak ditemukan. $uri adalah variabel Nginx, bukan variabel shell, sehingga disimpan apa adanya dalam heredoc dengan tanda kutip.
Log spesifik situs Memisahkan file log akses dan kesalahan untuk menghindari pencampuran permintaan dari berbagai situs.

Dokumen pengantar resmi Nginx menjelaskan blok konfigurasi dan cara menyajikan file statis. Dokumentasi direktif try_files menjelaskan pencarian file dan tindakan pada langkah terakhir.

Konteks jalur SELinux dan izin port

Meskipun izin file umum sudah benar, SELinux harus mengizinkan akses. SELinux membandingkan konteks keamanan yang melekat pada proses dan file dengan kebijakannya. Proses Nginx di lingkungan ini dijalankan dalam domain httpd_t , dan dokumen baru /srv awalnya 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 mendaftarkan aturan permanen yang akan diterapkan pada jalur, dan restorecon menerapkan aturan tersebut pada berkas yang sebenarnya. Hanya mendaftarkan aturan tidak langsung mengubah konteks berkas yang sudah ada. httpd_sys_content_t digunakan untuk dokumen yang akan dibaca di situs statis ini, membedakannya dari jalur yang memerlukan izin tulis untuk tindakan seperti unggahan. Untuk prinsip-prinsip terperinci, rujuk ke dokumentasi SELinux Rocky Linux .

Port 18025 baru saja didaftarkan karena tidak termasuk dalam port HTTP yang diizinkan pada awal praktik. Jika port sudah terdaftar untuk tipe lain, jangan otomatis mengubahnya menjadi -m setelah menerima kesalahan. Periksa layanan yang ada terlebih dahulu, kemudian pilih port yang tersedia atau tinjau cakupan kebijakan yang diperlukan. Izin port SELinux terpisah dari mengizinkan paket jaringan di firewalld.

Dalam perbandingan sumber, ketika hanya port yang diizinkan terlebih dahulu dan dokumen adalah var_t, HTTP 403 terjadi, dan log audit mencatat penolakan AVC (Access Vector Cache) di mana httpd_t tidak dapat mengakses file var_t. Setelah menerapkan aturan jalur dan restorecon, status berubah menjadi 200. SELinux tidak dimatikan, juga seluruh layanan tidak diatur ke mode permisif.

Perbandingan respons lokal dengan respons dari komputer lain

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

Untuk permintaan pertama, LF25 nginx site works dan 200 diharapkan, dan jalur yang tidak ada diharapkan mengembalikan 404. Jangan hanya melihat angka 200; juga periksa apakah itu konten situs yang diharapkan. Keberhasilan lokal adalah bukti bahwa Nginx dan akses dokumen dapat dilakukan, tetapi ini tidak berarti jalur jaringan eksternal berhasil.

Periksa zona tempat antarmuka eksternal berada dan izinkan hanya port latihan untuk zona tersebut. public di bawah ini adalah nilai yang diperiksa di VM ini, jadi ubah menjadi nilai yang sebenarnya di lingkungan lain. Jangan mengubah aturan izin SSH yang sudah ada.

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

Di komputer lain dalam jaringan yang sama, buat permintaan menggunakan alamat IPv4 server yang sebenarnya. IP berikut adalah contoh, jadi jangan menggunakannya begitu saja. Di Windows, Anda bisa menggunakan curl.exe untuk membedakannya dari alias PowerShell.

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

Lingkungan NAT (Network Address Translation) VirtualBox tidak memungkinkan akses langsung ke alamat tamu dari host. Dengan menambahkan aturan praktis di pengaturan VM: Network → Adapter 1 → Advanced → Port Forwarding dengan TCP, Host IP 127.0.0.1, Host Port 18025, dan Guest Port 18025, Anda dapat memeriksa http://127.0.0.1:18025/ dari host. Jika Host IP dikosongkan, jangkauan eksposur mungkin meningkat, jadi ditentukan untuk praktik lokal. Izin firewall tamu masih diperlukan.

Dalam praktik sumber, permintaan dibuat ke VM melalui penerusan NAT localhost dari curl di Windows. Sebelum mengizinkan firewall, terjadi timeout tanpa respons selama 4 detik, dan setelah mengizinkan port runtime, konten yang sama dan status 200 dikonfirmasi. Ini tidak menguji akses publik internet atau keberhasilan kueri DNS yang sebenarnya.

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

Kedua kueri harus yes untuk mencerminkan pengaturan saat ini dan yang disimpan. Anda tidak perlu memuat ulang seluruh firewall untuk menambahkan izin saat ini dan izin permanen secara terpisah. Pada tahap ini, uji ketahanan terhadap reboot belum dilakukan. Perbedaan antara kedua pengaturan juga dijelaskan dalam dokumentasi resmi izin port firewalld . Definisi layanan http untuk HTTP standar umumnya berarti port 80, jadi jangan bingung dengan izin port non-standar ini.

Diagnosa dengan membedakan antara kesalahan 403, 404, dan konfigurasi

Jika koneksi ditolak atau habis waktu, periksa terlebih dahulu listener, alamat dan jaringan VM, serta zona aktual. Jika respons HTTP datang, periksa situs yang menangani permintaan tersebut dan lognya. Jangan menyimpulkan bahwa ini masalah SELinux semata-mata berdasarkan 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

Dalam praktiknya, bahkan jika konteks SELinux yang benar dipertahankan, mengubah file menjadi milik root dengan 0600 mengakibatkan 403, dan mengembalikannya menjadi 0644 mengembalikan 200. Permission denied dalam log kesalahan dapat muncul baik dari izin normal maupun SELinux, jadi korelasikan kejadian AVC pada waktu permintaan gagal dengan izin path. Jangan menentukan penyebab spesifik hanya berdasarkan fakta bahwa tidak ada log. 404 untuk path yang tidak ada adalah hasil yang dimaksud dari try_files.

Setelah mengubah pengaturan, sambungkan keberhasilan verifikasi dan aplikasi seperti di sudo nginx -t && sudo systemctl reload nginx. Dalam laboratorium sumber, ketika direktif yang tidak ada ditambahkan ke sebuah file, pemeriksaan konfigurasi gagal dengan kode keluar 1, tetapi proses Nginx yang ada yang belum menerapkannya tetap mengembalikan 200 dengan PID yang sama. Segera kembalikan file yang salah ke kontennya yang asli dan periksa kembali. Jangan menilai konfigurasi yang tersimpan sebagai normal hanya karena mengembalikan respons sebelumnya.

Selain itu, untuk instance 18025 ini, hanya ada satu blok server, jadi bahkan saat melakukan permintaan melalui Host: another.test, situs yang sama tetap mengembalikan 200. Ini karena jika tidak ada nama yang cocok, server default untuk alamat dan port tersebut mungkin dipilih. server_name bukan perangkat pembatas akses, dan jika Anda ingin menolak nama yang tidak dikenal, Anda perlu merancang server default terpisah dan kebijakan respons yang eksplisit. Untuk aturan terperinci tentang pemilihan nama, lihat dokumentasi nama server Nginx.

Periksa situs yang ada dan hapus konfigurasi lab

Setelah situs baru disiapkan, juga periksa situs default port 80 yang asli. Saat membandingkannya dengan respons yang disimpan sebelumnya, body harus sama untuk menyimpulkan bahwa halaman default statis saat ini belum diubah. Karena respons dinamis dari situs operasi yang sebenarnya dapat bervariasi seiring waktu, fungsi inti, status, dan konten harus dibandingkan secara terpisah.

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

Dalam tiga perbandingan sumber yang direkam, situs default semuanya mengembalikan 200 dan body responsnya sama. File konfigurasi yang ada, termasuk nginx.conf, dipertahankan. Jika server ini akan terus digunakan, pertahankan hanya situs yang diperlukan, dan ketika diperlukan start otomatis setelah reboot, pilih sudo systemctl enable nginx dan kemudian verifikasi reboot secara terpisah.

Saat menghapus praktik, pertama pindahkan file situs yang Anda tambahkan ke lokasi cadangan, lalu periksa dan muat ulang. Perintah berikut hanya berlaku untuk file dan aturan yang baru dibuat dalam kursus ini. Jangan hapus jalur atau aturan port yang sudah ada yang Anda gunakan kembali.

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

Setelah pengaturan diterapkan, periksa bahwa listener 18025 telah hilang dan hapus aturan penerusan port yang ditambahkan ke VM. Cadangkan log praktik jika perlu. Di VM sumber, log baru disimpan, serta file situs, dokumen, kebijakan, firewall, dan aturan NAT dibersihkan sebelum menghentikan Nginx. Pengaturan dan firewall yang ada dibandingkan dengan kondisi awal, sementara SSH, status aktif firewalld, dan SELinux Enforcing dipertahankan. Paket Nginx dibiarkan untuk praktik berikutnya.