Niat hati mau bikin performa website makin ngebut dengan migrasi dari Apache ke Nginx di panel Webuzo VPS, tapi yang didapat justru mimpi buruk: semua custom permalink mendadak jebol dan memuntahkan pesan menyebalkan *404 Not Found (The requested URL was not found on this server)*. Homepage mungkin masih aman dibuka, begitu klik artikel atau slug URL tertentu, sistem langsung blank. 

Kepanikan seperti ini adalah makanan sehari-hari bagi sysadmin maupun webmaster yang baru pertama kali bermain di ekosistem Webuzo. Masalah ini bukan tanda VPS Anda rusak atau database korup. Nginx memang tidak membaca file konfigurasi rewrite bawaan Apache secara otomatis. Untungnya, Anda hanya butuh menyisipkan satu blok konfigurasi kecil ke dalam sistem untuk membereskan kekacauan ini.

## Biang Kerok di Balik Error 404 Nginx Webuzo

Sebelum buru-buru menyalahkan server, pahami dulu apa yang terjadi di balik layar. 

| Parameter | Apache (Sebelumnya) | Nginx (Sekarang) |
| :--- | :--- | :--- |
| **Penanganan URL** | Otomatis membaca file konfigurasi lokal direktori | Bergantung penuh pada blok konfigurasi pusat |
| **Dampak Migrasi** | Permalink custom berjalan normal tanpa konfigurasi manual | Slug dinamis gagal di-route dan memicu error 404 |
| **Lokasi Perbaikan** | Level direktori root web | File `common` di `/usr/local/apps/nginx/etc/conf.d/` |

Saat Anda beralih ke Nginx di Webuzo, web server baru ini kehilangan instruksi routing untuk melempar slug URL ke file eksekusi utama. Nginx mengira slug tersebut adalah folder atau file fisik nyata yang memang tidak ada di server, sehingga memunculkan respons 404.

## Membedah File Konfigurasi: Langkah Eksekusi

Akses server Anda via Terminal, PuTTY, atau gunakan koneksi SFTP. Pastikan Anda memiliki hak akses `root` untuk mengedit konfigurasi inti Nginx Webuzo.

File yang menjadi target perbaikan berada di direktori:
`/usr/local/apps/nginx/etc/conf.d/common`

### 1. Buka File via Text Editor

Jika Anda terbiasa dengan CLI, buka terminal dan gunakan teks editor favorit Anda. Ingat, gunakan perintah `sudo` jika belum masuk sebagai root:

```bash
sudo vim /usr/local/apps/nginx/etc/conf.d/common
```

Atau bagi yang lebih nyaman dengan `nano`:

```bash
sudo nano /usr/local/apps/nginx/etc/conf.d/common
```

*(Catatan: Jika memakai Vim, tekan tombol `i` untuk masuk ke mode insert/pengetikan).*

### 2. Sisipkan Blok Routing Nginx

Gulir ke baris paling bawah. Aturan mainnya tegas: tambahkan baris konfigurasi baru di akhir file, jangan pernah mengutak-atik konfigurasi yang sudah ada sebelumnya.

Salin dan tempel baris berikut:

```nginx
location / {  
    try_files $uri $uri/ /index.php?q=$request_uri;  
}
```

Baris ini menginstruksikan Nginx untuk memeriksa keberadaan file (`$uri`) atau folder fisik (`$uri/`). Jika keduanya tidak ada, server akan otomatis mengalihkan request slug URL tersebut ke script pemroses utama (`/index.php?q=$request_uri`).

### 3. Simpan Perubahan

Bagi pengguna Vim, tekan tombol `Esc` lalu ketik `:wq!` dan tekan Enter untuk menyimpan sekaligus keluar. Bagi pengguna Nano, tekan shortcut kombinasi `Ctrl + X`, pilih opsi `y`, lalu tekan Enter.

## Reload Sistem: Dua Opsi Praktis

Perubahan konfigurasi tidak akan berpengaruh apapun sampai Nginx membaca ulang file `common` yang baru saja Anda edit. Ada dua cara untuk merestart service ini.

### Opsi CLI Terminal
Jalankan perintah restart langsung dari console:

```bash
service nginx restart
```

### Opsi GUI Webuzo
Jika Anda lebih suka kontrol berbasis panel:
1. Masuk ke dashboard Webuzo.
2. Buka menu **Services**.
3. Cari service **nginx**.
4. Klik pada logo **reload/refresh**.

Selesai. Bersihkan cache browser Anda lalu coba klik kembali custom permalink yang sebelumnya rusak. Slug URL kini bisa diakses secara normal tanpa ada lagi gangguan error 404. Setup Nginx Anda di VPS Webuzo sudah siap melibas traffic dengan optimal.

Website mendadak error 404 Not Found setelah switch web server ke Nginx di Webuzo VPS? Simak panduan konfigurasi file common dan trik restart-nya di sini.

Migrasi Apache ke Nginx di Webuzo Malah Bikin Error 404? Ini Solusi Cepatnya

Reggi

Solusi praktis integrasi webmail custom ke dalam dashboard Gmail. Kelola, baca, dan kirim email domain pribadi langsung dari satu tempat tanpa ribet gonta-ganti tab.

Mengapa Kamu Masih Buka Dua Tab Terpisah? Panduan Setup Custom Webmail Langsung di Dashboard Gmail

Pelajari efisiensi merakit mesin tetas telur listrik AC otomatis dengan modal murah untuk mendongkrak hasil ternak unggas tanpa repot bolak-balik telur manual.

Otomasi Ternak Unggas: Kenapa Rakit Sendiri Mesin Penetas Telur AC Jauh Lebih Worth It Dibanding Cara Konvensional?

Pelajari bagaimana mesin tetas telur berbasis arus listrik DC bekerja menjaga suhu dan kelembapan ideal untuk mendongkrak keberhasilan penetasan telur unggas.

Mesin Tetas Telur Arus DC: Solusi Hardware Murah Buat Tingkatin Angka Penetasan Unggas

Kupas tuntas seluk-beluk mobil aki anak dengan kontrol ganda dan fitur multimedia. Pahami batas spesifikasi hardware sebelum eksekusi build sendiri.

EV Versi Mini: Membedah Mobil Listrik Aki Lengkap dengan Remote Control dan Fitur Multimedia

Pelajari cara merakit smart power strip berbasis NodeMCU dan Blynk untuk kontrol daya nirkabel serta integrasi IoT yang aman dan efisien.

Mengapa Beli Mahal Kalau Bisa Bikin Sendiri? Rancang Smart Power Strip Berbasis NodeMCU dan Blynk

Solusi tuntas mengatasi bug sistem dan software bermasalah di MacBook dengan panduan install ulang macOS lewat Internet Recovery secara aman.

#vps

Getting Lastest Post..

Populer Bulan Ini