Panduan Konfigurasi Wildcard vHost pada Server VPS (Nginx, CyberPanel, aaPanel)

Konfigurasi Wildcard Virtual Host (vHost) adalah proses pendaftaran pola nama host universal (*.domainanda.com) pada berkas konfigurasi web server VPS (seperti Nginx, OpenLiteSpeed, atau Apache). Konfigurasi ini memastikan server web menyalurkan seluruh lalu lintas subdomain dinamis ke direktori instalasi WordPress yang sama tanpa menampilkan halaman default server.

Perbedaan Penanganan Shared Hosting vs Server VPS

Pada layanan shared hosting dengan antarmuka cPanel, pengaturan vHost ditangani secara otomatis di latar belakang saat Anda membuat subdomain bertanda bintang.

Namun jika agensi Anda menggunakan Server VPS (Virtual Private Server) mandiri:

• Web server tidak secara otomatis mengetahui bahwa subdomain baru harus membuka website WordPress Anda.
• Pengunjung yang mengakses andy-zhea.websiteundangan.com akan mendapati halaman kesalahan 404 Not Found Nginx atau dialihkan ke website lain yang berada di VPS yang sama.
• Oleh karena itu, penyesuaian berkas konfigurasi vHost adalah langkah wajib bagi pemilik VPS.

1. Konfigurasi pada Nginx Standalone

Jika VPS Anda menggunakan instalasi Nginx murni (tanpa panel):

1. Buka terminal SSH server Anda menggunakan PuTTY atau terminal lokal.
2. Navigasikan ke folder konfigurasi situs Nginx:

   sudo nano /etc/nginx/sites-available/websiteundangan.com.conf

1. Cari baris direktif server_name, lalu tambahkan pola wildcard:

   server {
       listen 80;
       listen [::]:80;
       server_name websiteundangan.com *.websiteundangan.com;

       root /var/www/websiteundangan.com/public_html;
       index index.php index.html;

       location / {
           try_files $uri $uri/ /index.php?$args;
       }

       location ~ .php$ {
           include snippets/fastcgi-php.conf;
           fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
       }
   }

1. Uji validitas sintaksis konfigurasi:

   sudo nginx -t

1. Terapkan konfigurasi baru:

   sudo systemctl reload nginx

2. Konfigurasi pada CyberPanel (OpenLiteSpeed)

Bagi pengguna panel CyberPanel dengan web server OpenLiteSpeed:

1. Masuk ke dasbor CyberPanel Anda (port 8090).
2. Masuk ke menu Websites > List Websites, cari website WordPress utama Anda, lalu klik Manage.
3. Di bagian bawah, klik opsi vHost Conf.
4. Cari baris vhAliases, lalu tambahkan subdomain wildcard dipisahkan tanda koma:

   vhAliases               websiteundangan.com, *.websiteundangan.com

1. Klik tombol Save untuk menyimpan perubahan. CyberPanel akan me-restart layanan OpenLiteSpeed secara otomatis dalam 2 detik.

3. Konfigurasi pada aaPanel

Bagi pengguna panel manajemen aaPanel:

1. Login ke dasbor aaPanel Anda.
2. Klik menu Website pada bilah menu samping.
3. Klik nama domain website WordPress utama Anda untuk membuka panel pengaturan.
4. Pada tab Domain Manager, tambahkan dua baris domain:

• websiteundangan.com
• *.websiteundangan.com

1. Klik tombol Add.
2. Buka tab SSL, pilih opsi Let's Encrypt, centang kedua domain, pilih metode verifikasi DNS Verification via Cloudflare API, lalu klik Apply untuk menerbitkan sertifikat SSL wildcard.

Studi Kasus Operasional: Migrasi VPS Andy & Zhea

Agensi yang menangani pernikahan Andy & Zhea melakukan migrasi dari shared hosting ke VPS Ubuntu 24.04 berbasis Nginx:

• Pengelola menyetel server_name websiteundangan.com *.websiteundangan.com; pada blok port 80 dan 443.
• Sertifikat SSL diterbitkan menggunakan Certbot Cloudflare DNS Plugin.
• Pengujian akses ke https://andy-zhea.websiteundangan.com berhasil seketika dengan respon HTTP 200 OK dan latensi server turun menjadi hanya 45 milidetik.

Matriks Perbandingan Penyetelan Antar Web Server

Tips & Praktik Terbaik