Instalasi & Optimasi di VPS (Manual)

Pilih tingkat berdasarkan jumlah siswa yang mengerjakan ujian bersamaan, bukan jumlah seluruh siswa. Pilihan Anda juga mengatur nilai pada semua kotak perintah di halaman ini.

Tingkat terpilih: 301–600 siswa serentak. Cocok untuk sekolah menengah dengan ujian bergelombang per ruang.

Dari mana angka ini berasal

Beban aplikasi ujian tidak merata. Ada tiga fase dengan kebutuhan berbeda:

• CPU menentukan seberapa cepat gelombang login di awal ujian terlayani. Bila ratusan siswa masuk dalam hitungan detik, tambah vCPU, atau bagi siswa per ruang agar mulai bergelombang.
• RAM dibagi untuk PHP-FPM (sekitar 40–60 MB per worker), buffer pool database, dan sistem operasi. Karena itu RAM tidak boleh diirit.
• Disk bukan soal kapasitas melainkan kecepatan. Pilih SSD atau NVMe. Gambar soal disimpan di database (dikompres ke WebP), sehingga ukuran database tumbuh seiring jumlah gambar, tetapi tetap kecil dibanding kapasitas disk yang disarankan.
• Bandwidth server jarang jadi masalah, tetapi internet sekolah sering jadi penyempit. Ratusan siswa yang memuat soal bersamaan lewat satu jalur sekolah butuh sekitar 50–100 Mbps. Jika jalur sekolah kecil, pertimbangkan server di jaringan lokal (LAN).

Memilih penyedia VPS

• Pilih virtualisasi KVM dengan sumber daya khusus (bukan oversold), dan lokasi pusat data di Indonesia atau Singapura agar latensi rendah.
• Pilih sistem operasi Ubuntu 24.04 LTS. Panduan ini memakainya karena PHP 8.3 dan MariaDB sudah tersedia di repositori bawaan.
• Pilih penyedia yang mengizinkan menaikkan paket per jam atau per hari. Anda bisa menaikkan spek hanya selama pekan ujian, lalu menurunkannya lagi.
• Aktifkan snapshot atau backup bawaan penyedia sebagai lapisan cadangan tambahan.

Seluruh proses terdiri dari delapan tahap. Setiap tahap dibahas berurutan di halaman ini.

• Semua perintah diuji alurnya untuk Ubuntu 24.04 LTS. Di Ubuntu 22.04, PHP 8.3 memerlukan repositori tambahan (PPA) sehingga nama paket dan jalur berkas berbeda.
• Contoh domain ujian.sekolah.sch.id dan database cbt_ujian perlu diganti sesuai milik Anda.
• Siapkan juga berkas ZIP aplikasi dan kode lisensi dari penjual.

Masuk ke VPS, perbarui sistem, buat user khusus, dan amankan akses sebelum memasang apa pun.

1. Masuk dan perbarui sistem

Dari komputer Anda (Windows PowerShell, macOS, atau Linux), masuk sebagai root memakai IP dari penyedia VPS:

ssh root@IP_VPS

Setelah masuk, perbarui paket dan atur zona waktu serta nama server:

apt update && apt upgrade -y
timedatectl set-timezone Asia/Jakarta
hostnamectl set-hostname server-ujian

2. Buat user khusus dan pakai kunci SSH

Jangan bekerja sebagai root. Buat user deploy dengan hak sudo:

adduser deploy
usermod -aG sudo deploy

Di komputer Anda, buat kunci SSH bila belum ada, lalu kirim kunci publiknya ke server. Perintah kedua untuk Windows PowerShell:

ssh-keygen -t ed25519

type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh deploy@IP_VPS "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys"

Pada macOS atau Linux, cukup ssh-copy-id deploy@IP_VPS. Uji dulu bahwa ssh deploy@IP_VPS berhasil tanpa meminta password server.

3. Perketat SSH

Setelah login dengan kunci berhasil, matikan login root dan login dengan password:

sudo tee /etc/ssh/sshd_config.d/99-hardening.conf >/dev/null <<'EOF'
PermitRootLogin no
PasswordAuthentication no
EOF
sudo sshd -t && sudo systemctl reload ssh

4. Firewall dan perlindungan brute force

Izinkan hanya SSH, HTTP, dan HTTPS. Izinkan SSH sebelum mengaktifkan firewall.

sudo apt install -y ufw fail2ban
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw --force enable
sudo systemctl enable --now fail2ban
sudo ufw status verbose

Port database (3306) sengaja tidak dibuka. MariaDB hanya melayani koneksi dari server itu sendiri.

Tumpukan yang ringan dan cepat untuk banyak koneksi serentak.

sudo apt install -y nginx mariadb-server unzip rsync curl \
  php8.3-fpm php8.3-cli php8.3-mysql php8.3-mbstring php8.3-zip php8.3-gd php8.3-curl php8.3-xml php8.3-intl

Periksa bahwa ekstensi yang dibutuhkan aplikasi aktif (sodium dipakai untuk verifikasi lisensi):

php -v
php -m | grep -E "pdo_mysql|mysqli|sodium|zip|mbstring|gd|curl|openssl"

Delapan nama ekstensi harus tampil. Lalu pastikan layanan berjalan dan menyala otomatis saat server hidup:

sudo systemctl enable --now nginx mariadb php8.3-fpm
systemctl is-active nginx mariadb php8.3-fpm

Amankan MariaDB. Jawab pertanyaan sesuai saran di bawah kotak.

sudo mariadb-secure-installation

• Switch to unix_socket authentication: N (sudah bawaan)  ·  Change root password: N bila memakai socket
• Remove anonymous users: Y  ·  Disallow root login remotely: Y
• Remove test database: Y  ·  Reload privilege tables: Y

Buat database, unggah aplikasi, isi koneksi, lalu pasang situs di Nginx dengan HTTPS.

1. Buat database dan user

Buat password yang kuat dan catat hasilnya:

openssl rand -base64 24

Ganti GANTI_PASSWORD_KUAT dengan password tadi, lalu jalankan:

sudo mariadb <<'SQL'
CREATE DATABASE cbt_ujian CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'cbt_user'@'localhost' IDENTIFIED BY 'GANTI_PASSWORD_KUAT';
GRANT ALL PRIVILEGES ON cbt_ujian.* TO 'cbt_user'@'localhost';
FLUSH PRIVILEGES;
SQL

Tabel dibuat otomatis saat aplikasi pertama kali dibuka. Jika paket Anda menyertakan berkas .sql, impor dengan sudo mariadb cbt_ujian < berkas.sql.

2. Unggah dan ekstrak aplikasi

Dari komputer Anda, kirim berkas ZIP ke server:

scp ryuexam-cbt.zip deploy@IP_VPS:/tmp/

Di server, ekstrak ke folder situs lalu atur kepemilikan dan izin berkas:

sudo mkdir -p /var/www/ujian
sudo unzip -q /tmp/ryuexam-cbt.zip -d /var/www/ujian
ls -la /var/www/ujian | head -20

Pastikan index.php, admin.php, dan config.php terlihat langsung di /var/www/ujian. Jika terbentuk satu subfolder tambahan, pindahkan isinya ke atas lebih dulu. Lalu:

sudo chown -R www-data:www-data /var/www/ujian
sudo find /var/www/ujian -type d -exec chmod 755 {} \;
sudo find /var/www/ujian -type f -exec chmod 644 {} \;
rm /tmp/ryuexam-cbt.zip

3. Isi koneksi database di config.php

sudo nano /var/www/ujian/config.php

Isi bagian $db_hosting, dan paksa mode hosting agar aplikasi selalu memakainya di server ini:

$environment_mode = 'hosting';

$db_hosting = [
    'host' => 'localhost',
    'port' => '3306',
    'name' => 'cbt_ujian',
    'user' => 'cbt_user',
    'pass' => 'GANTI_PASSWORD_KUAT',
];

Simpan dengan Ctrl+O, Enter, lalu keluar dengan Ctrl+X. Batasi akses berkas ini:

sudo chmod 640 /var/www/ujian/config.php
sudo chown www-data:www-data /var/www/ujian/config.php

4. Pasang situs di Nginx

Arahkan dulu DNS domain/subdomain ke IP VPS (rekaman A) dan tunggu sampai aktif. Aplikasi memakai .htaccess khusus Apache untuk melindungi berkas, sedangkan Nginx tidak membaca .htaccess. Karena itu konfigurasi di bawah menerjemahkan aturan yang sama: folder internal diblokir, berkas sensitif ditolak, header keamanan dipasang, gambar soal di-cache lama, dan skrip PHP tidak di-cache.

Pertama, berkas potongan untuk header keamanan:

sudo tee /etc/nginx/snippets/ryuexam-headers.conf >/dev/null <<'EOF'
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
EOF

Kedua, zona cache untuk gambar soal. Gambar disimpan di database dan disajikan lewat img.php; dengan cache ini, Nginx melayani gambar dari disk sehingga PHP dan database tidak dipanggil berulang untuk tiap siswa:

sudo tee /etc/nginx/conf.d/ryuexam-cache.conf >/dev/null <<'EOF'
fastcgi_cache_path /var/cache/nginx/ryuexam levels=1:2 keys_zone=ryuimg:20m max_size=500m inactive=7d use_temp_path=off;
EOF

Ketiga, konfigurasi situs. Ganti ujian.sekolah.sch.id dengan domain Anda:

sudo tee /etc/nginx/sites-available/ujian >/dev/null <<'EOF'
server {
    listen 80;
    listen [::]:80;
    server_name ujian.sekolah.sch.id;
    root /var/www/ujian;
    index index.php;
    server_tokens off;
    client_max_body_size 64M;

    include snippets/ryuexam-headers.conf;

    # 1. Folder internal tidak boleh dibuka dari browser
    location ~ ^/(views|_backup_questions|data|_loadtest)/ { return 403; }

    # 2. Berkas tersembunyi dan berkas sensitif
    location ~ /\.(?!well-known) { return 403; }
    location ~* \.(json|sql|docx?|log|md|txt|bak|old|env|sh|bat|ini|conf|ya?ml)$ { return 403; }
    location = /manifest.json { try_files $uri =404; }

    # 3. Gambar soal: isinya tidak pernah berubah, cache di Nginx dan browser
    location = /img.php {
        include snippets/ryuexam-headers.conf;
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_hide_header Cache-Control;
        fastcgi_cache ryuimg;
        fastcgi_cache_key "$scheme$host$request_uri";
        fastcgi_cache_valid 200 30d;
        fastcgi_ignore_headers Cache-Control Expires Set-Cookie;
        add_header Cache-Control "public, max-age=31536000, immutable";
    }

    # 4. Aset statis
    location ~* \.(css|js)$ {
        include snippets/ryuexam-headers.conf;
        expires 7d;
        access_log off;
    }
    location ~* \.(png|jpe?g|gif|webp|svg|ico|woff2?|ttf)$ {
        include snippets/ryuexam-headers.conf;
        expires 30d;
        access_log off;
    }

    # 5. Skrip PHP (API dan admin) tidak boleh di-cache
    location ~ \.php$ {
        include snippets/ryuexam-headers.conf;
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_read_timeout 120;
        fastcgi_hide_header Cache-Control;
        add_header Cache-Control "private, no-cache, no-store, must-revalidate" always;
    }

    # Status PHP-FPM, hanya dari server ini (untuk pemantauan)
    location = /fpm-status {
        allow 127.0.0.1;
        deny all;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location / { try_files $uri $uri/ =404; }
}
EOF

Aktifkan situs, nonaktifkan situs bawaan Nginx, uji sintaks, lalu muat ulang:

sudo ln -sf /etc/nginx/sites-available/ujian /etc/nginx/sites-enabled/ujian
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl reload nginx

Pastikan tulisan syntax is ok muncul. Bagian /fpm-status baru bekerja setelah pool PHP-FPM di bagian Optimasi dibuat. Jangan khawatir bila sebelum itu halaman PHP belum tampil.

5. Pasang HTTPS (Let's Encrypt)

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d ujian.sekolah.sch.id --redirect

Ikuti pertanyaan interaktif (alamat email dan persetujuan ketentuan). Pembaruan sertifikat berjalan otomatis; ujilah dengan:

sudo certbot renew --dry-run

Setelah selesai dan bagian Optimasi dikerjakan, buka https://ujian.sekolah.sch.id/admin.php, masuk dengan akun admin dari paket, ganti password, lalu aktifkan lisensi lewat Memasukkan Lisensi.

Nilai pada kotak di bagian ini mengikuti tingkat yang Anda pilih di bagian Spesifikasi VPS. Ubah pilihan, dan nilainya ikut berubah.

1. PHP-FPM dan OPcache

PHP-FPM mengatur berapa permintaan PHP yang dilayani bersamaan. Terlalu sedikit membuat siswa mengantre, terlalu banyak menghabiskan RAM. Rumus kasarnya: (RAM − RAM untuk database dan sistem) ÷ 50 MB. Gantikan pool bawaan dengan pool khusus aplikasi:

sudo mv /etc/php/8.3/fpm/pool.d/www.conf /etc/php/8.3/fpm/pool.d/www.conf.disabled
sudo tee /etc/php/8.3/fpm/pool.d/ryuexam.conf >/dev/null <<'EOF'
[ryuexam]
user = www-data
group = www-data
listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.backlog = 4096

pm = dynamic
pm.max_children = 80
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30
pm.max_requests = 500
pm.status_path = /fpm-status

request_terminate_timeout = 120s
php_admin_value[error_log] = /var/log/php8.3-fpm-ryuexam.log
php_admin_flag[log_errors] = on
EOF

Lalu atur PHP dan OPcache. OPcache menyimpan kode PHP yang sudah dikompilasi sehingga permintaan berikutnya jauh lebih cepat:

sudo tee /etc/php/8.3/fpm/conf.d/99-ryuexam.ini >/dev/null <<'EOF'
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 120
date.timezone = Asia/Jakarta

opcache.enable = 1
opcache.memory_consumption = 256
opcache.interned_strings_buffer = 16
opcache.max_accelerated_files = 20000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 60
EOF
sudo php-fpm8.3 -t && sudo systemctl restart php8.3-fpm

validate_timestamps dibiarkan aktif dengan jeda 60 detik agar pembaruan berkas aplikasi otomatis terbaca tanpa restart manual.

2. MariaDB

Parameter terpenting adalah innodb_buffer_pool_size, yaitu memori yang dipakai database untuk menyimpan data aktif. Nilainya sekitar 40–50% dari RAM bila server juga menjalankan PHP.

sudo tee /etc/mysql/mariadb.conf.d/99-ryuexam.cnf >/dev/null <<'EOF'
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
skip_name_resolve = 1
bind-address = 127.0.0.1

innodb_buffer_pool_size = 3G
innodb_log_file_size = 512M
innodb_flush_method = O_DIRECT
innodb_flush_log_at_trx_commit = 2

max_connections = 250
max_allowed_packet = 64M
thread_cache_size = 64
table_open_cache = 2000
tmp_table_size = 64M
max_heap_table_size = 64M

slow_query_log = 1
slow_query_log_file = /var/log/mysql/mariadb-slow.log
long_query_time = 1
EOF
sudo systemctl restart mariadb

Periksa bahwa pengaturan terbaca:

sudo mariadb -e "SHOW VARIABLES WHERE Variable_name IN ('innodb_buffer_pool_size','max_connections','innodb_flush_log_at_trx_commit');"

3. Nginx

Naikkan batas koneksi serentak dan aktifkan kompresi untuk data JSON, CSS, dan JavaScript:

sudo tee /etc/nginx/conf.d/ryuexam-gzip.conf >/dev/null <<'EOF'
gzip_vary on;
gzip_comp_level 5;
gzip_min_length 1024;
gzip_types text/plain text/css text/xml application/json application/javascript text/javascript application/xml image/svg+xml;
EOF
grep -n "gzip on" /etc/nginx/nginx.conf

Baris terakhir harus menampilkan gzip on;. Bila tidak muncul, tambahkan gzip on; di blok http pada /etc/nginx/nginx.conf. Selanjutnya naikkan batas berkas terbuka dan koneksi per worker (jalankan satu kali saja):

sudo sed -i 's/^\s*worker_connections.*/    worker_connections 8192;/' /etc/nginx/nginx.conf
sudo sed -i '/^worker_processes/a worker_rlimit_nofile 65535;' /etc/nginx/nginx.conf
sudo nginx -t && sudo systemctl reload nginx

Perintah kedua menambah satu baris di nginx.conf. Jika dijalankan dua kali, Nginx menolak karena baris ganda. Periksa dengan sudo nginx -t.

4. Sistem operasi

Naikkan batas antrean koneksi dan berkas terbuka, dan kurangi kecenderungan memakai swap:

sudo tee /etc/sysctl.d/99-ryuexam.conf >/dev/null <<'EOF'
net.core.somaxconn = 4096
net.ipv4.tcp_max_syn_backlog = 4096
net.ipv4.ip_local_port_range = 10240 65535
net.ipv4.tcp_tw_reuse = 1
fs.file-max = 200000
vm.swappiness = 10
EOF
sudo sysctl --system >/dev/null

Pada tingkat 2 GB dan 4 GB, tambahkan swap 2 GB sebagai pengaman:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
free -h

Putar log agar disk tidak penuh. Ubuntu sudah memutar log Nginx dan MariaDB secara otomatis. Batasi ukuran log sistemd dengan:

sudo journalctl --vacuum-size=200M

5. Pengaturan di dalam aplikasi

Beberapa pengaturan di panel admin ikut menentukan beban server. Buka Pengaturan lalu atur:

Untuk memantau secara langsung, buka menu Status Ujian. Halaman itu membaca hanya jadwal aktif dan data tidak diperbarui otomatis, sehingga aman dibuka beberapa pengawas sekaligus.

Buktikan bahwa server sanggup menampung jumlah siswa Anda. Aplikasi menyertakan alat uji beban yang meniru siswa sungguhan: membuka halaman, login, memulai ujian, memuat soal, menjawab dan menyinkronkan, lalu mengumpulkan.

1. Siapkan alat di komputer Anda

   Alatnya ada di folder _loadtest pada paket aplikasi dan berjalan dari komputer Anda, bukan dari VPS. Klik dua kali Jalankan Uji Beban.bat. Panel terbuka di browser (http://127.0.0.1:8765/) dan jendela hitam harus tetap terbuka selama tes.

2. Isi data tes

   Masukkan URL aplikasi di VPS, username dan password admin, serta jumlah siswa virtual. Mulailah dari 50% target, lalu naik ke 100% dan 120%.

3. Pantau server saat tes berjalan

   Buka dua sesi SSH dan jalankan perintah di bawah. Perhatikan CPU, RAM, dan jumlah worker PHP-FPM.

4. Baca hasilnya

   Setelah selesai, data uji dihapus otomatis (kecuali dicentang Jangan hapus). Bila tes terputus, klik Bersihkan Data Uji.

sudo apt install -y htop sysstat
htop

watch -n 2 'curl -s http://127.0.0.1/fpm-status | head -14'

sudo mariadb -e "SHOW GLOBAL STATUS LIKE 'Max_used_connections'; SHOW GLOBAL STATUS LIKE 'Threads_connected';"
sudo tail -n 20 /var/log/mysql/mariadb-slow.log
sudo tail -n 20 /var/log/nginx/error.log

Cara menafsirkan hasil

Ulangi tes setelah setiap perubahan, satu perubahan dalam satu waktu, supaya jelas mana yang berpengaruh.

Backup otomatis harian

Skrip berikut mencadangkan database dan berkas penting setiap malam pukul 01.30, lalu menghapus cadangan yang lebih tua dari 14 hari:

sudo tee /usr/local/bin/backup-ujian.sh >/dev/null <<'EOF'
#!/bin/bash
set -euo pipefail
DIR=/var/backups/ujian
STAMP=$(date +%F_%H%M)
mkdir -p "$DIR"
mariadb-dump --single-transaction --quick cbt_ujian | gzip > "$DIR/cbt_ujian_$STAMP.sql.gz"
tar -czf "$DIR/berkas_$STAMP.tar.gz" -C /var/www ujian/data ujian/_backup_questions ujian/config.php
find "$DIR" -type f -mtime +14 -delete
EOF
sudo chmod 750 /usr/local/bin/backup-ujian.sh
echo "30 1 * * * root /usr/local/bin/backup-ujian.sh" | sudo tee /etc/cron.d/backup-ujian
sudo /usr/local/bin/backup-ujian.sh && ls -lh /var/backups/ujian

Salin cadangan keluar dari server secara berkala, misalnya ke komputer Anda atau penyimpanan cloud, karena cadangan di server yang sama ikut hilang bila server rusak. Dari komputer Anda:

scp deploy@IP_VPS:/var/backups/ujian/*.gz .

Agar user deploy bisa membacanya, jalankan satu kali di server: sudo chmod 750 /var/backups/ujian && sudo chgrp deploy /var/backups/ujian. Selain itu, unduh juga cadangan dari menu Pengaturan › Database sebelum dan sesudah ujian.

Pemantauan harian

df -h /
free -h
systemctl --no-pager --failed
uptime

Memperbarui aplikasi

1. Cadangkan lebih dulu

   Jalankan sudo /usr/local/bin/backup-ujian.sh.

2. Unggah paket pembaruan

   Kirim ZIP ke /tmp dengan scp seperti sebelumnya.

3. Timpa tanpa menyentuh data

   Perintah di bawah menyalin berkas baru, namun mengecualikan config.php, folder data, dan _backup_questions. Sesuaikan jalur folder hasil ekstrak.

mkdir -p /tmp/update
unzip -q /tmp/ryuexam-update.zip -d /tmp/update
sudo rsync -a --exclude 'config.php' --exclude 'data/' --exclude '_backup_questions/' --exclude '_loadtest/' /tmp/update/ /var/www/ujian/
sudo chown -R www-data:www-data /var/www/ujian
sudo systemctl reload php8.3-fpm

Buka situs sekali agar pembaruan tabel berjalan otomatis, lalu cek Log Pembaruan di panel admin untuk memastikan versinya benar.