Laravel Inertia Vue 3: Optimasi SSR & Performa Production
Untuk mengaktifkan Server-Side Rendering (SSR) pada Laravel Inertia Vue 3, Anda wajib membangun bundel entry point khusus Node.js melalui Vite dan menjalankan proses daemon SSR terpisah di server VPS menggunakan Supervisor. Langkah ini memungkinkan server merender halaman Vue menjadi HTML utuh sebelum dikirim ke browser, sekaligus memangkas Time to First Byte (TTFB) serta memastikan bot mesin pencari mengindeks seluruh konten dinamis secara instan.
Setelah pada seri sebelumnya kita berhasil mengamankan pipeline deployment otomatis menggunakan CI/CD[cite: 1], tantangan nyata berikutnya muncul saat aplikasi mulai diakses ribuan pengguna bersamaan. Tanpa konfigurasi SSR dan strategi caching tingkat lanjut, aplikasi SPA berbasis Inertia hanya mengirimkan tag <div id="app"> kosong saat pertama kali dimuat, yang berakibat fatal pada skor Core Web Vitals dan visibilitas SEO halaman publik.
Prasyarat Teknis & Perbandingan Arsitektur Rendering
Sebelum memodifikasi konfigurasi bundel produksi, pastikan lingkungan server VPS maupun lokal Anda telah memenuhi spesifikasi arsitektur berikut agar proses kompilasi berjalan tanpa hambatan memori:
Backend Runtime: PHP 8.2+ dengan ekstensi
php-redisaktif serta Laravel 11.x.Frontend & Bundler: Vue 3.4+,
@inertiajs/vue3v1.0+, dan Vite 5.x.SSR Runtime Engine: Node.js v20 LTS terinstal di server produksi (wajib untuk mengeksekusi server SSR).
Infrastruktur Cloud / VPS: Minimal RAM 2 GB dengan akses root untuk konfigurasi Supervisor dan Redis Server.
Dalam proyek Enterprise Architecture dan SaaS yang saya tangani, pemilihan mode rendering sangat menentukan beban CPU server dan kecepatan muat awal. Tabel berikut merangkum perbandingan performa antara mode standar dengan arsitektur SSR teroptimasi:
Parameter Teknis | Client-Side Rendering (CSR) | Inertia SSR + Vite Splitting | Inertia SSR + Redis Cache |
|---|---|---|---|
Respons HTML Awal | Kosong (Hanya div root) | HTML penuh ter-render | HTML penuh dari memori |
Indeksasi SEO Bot | Lambat (Butuh eksekusi JS) | Instan (100% terbaca) | Instan (100% terbaca) |
Beban CPU Server | Rendah (Beban di browser) | Tinggi saat trafik melonjak | Sangat rendah (Bypass render) |
First Contentful Paint | 1.4s – 2.8s | 0.5s – 0.9s | < 0.3s |
Langkah 1: Konfigurasi Entry Point SSR & Vite Code Splitting
Secara default, Laravel hanya memiliki file resources/js/app.js yang berjalan di sisi browser. Untuk menjalankan SSR, kita perlu membuat file resources/js/ssr.js sebagai pintu masuk khusus bagi daemon Node.js sekaligus memasang paket @vue/server-renderer.
npm install @vue/server-rendererSetelah paket terpasang, buat file resources/js/ssr.js untuk menangani rendering komponen Vue di sisi server dan menyinkronkan rute Ziggy agar fungsi route() tetap bekerja tanpa objek window:
import { createSSRApp, h } from 'vue';
import { renderToString } from '@vue/server-renderer';
import { createInertiaApp } from '@inertiajs/vue3';
import createServer from '@inertiajs/vue3/server';
import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers';
import { ZiggyVue } from '../../vendor/tightenco/ziggy';
const appName = import.meta.env.VITE_APP_NAME || 'SarjanaIT';
createServer((page) =>
createInertiaApp({
page,
render: renderToString,
title: (title) => `${title} - ${appName}`,
resolve: (name) =>
resolvePageComponent(
`./Pages/${name}.vue`,
import.meta.glob('./Pages/**/*.vue')
),
setup({ App, props, plugin }) {
return createSSRApp({ render: () => h(App, props) })
.use(plugin)
.use(ZiggyVue, {
...page.props.ziggy,
location: new URL(page.props.ziggy.location),
});
},
})
);Bedah Teknis Kode di Atas:
createServer&renderToString: Membuka server HTTP internal Node.js (default port 13714) yang menerima payload JSON dari Laravel dan mengembalikannya sebagai string HTML matang.createSSRApp: Menggantikan fungsicreateAppbiasa agar Vue melakukan proses hydration (menempelkan event listener ke DOM yang sudah ada) alih-alih merender ulang seluruh elemen dari nol.Konfigurasi
ZiggyVue: Karena Node.js tidak memiliki objek globalwindow.location, kita wajib menyuntikkan URL saat ini secara eksplisit dari propertipage.props.ziggy.location.
Selanjutnya, perbarui vite.config.js untuk mendaftarkan entry point SSR sekaligus memecah ukuran bundel vendor (Manual Chunks) agar browser tidak mengunduh satu file JavaScript raksasa:
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
plugins: [
laravel({
input: 'resources/js/app.js',
ssr: 'resources/js/ssr.js',
refresh: true,
}),
vue({
template: {
transformAssetUrls: {
base: null,
includeAbsolute: false,
},
},
}),
],
build: {
rollupOptions: {
output: {
manualChunks(id) {
if (id.includes('node_modules')) {
if (id.includes('vue') || id.includes('@inertiajs')) {
return 'vendor-core';
}
return 'vendor-libs';
}
},
},
},
},
});Dengan aturan manualChunks di atas, Vite memisahkan library inti Vue dan Inertia ke dalam vendor-core.js yang jarang berubah sehingga dapat disimpan di cache browser pengguna dalam jangka waktu lama.

Langkah 2: Mengaktifkan SSR & Redis Payload Caching di Backend
Publikasikan file konfigurasi Inertia apabila belum tersedia di folder config/inertia.php menggunakan perintah php artisan vendor:publish --provider="Inertia\ServiceProvider", lalu pastikan opsi SSR diaktifkan:
<?php
return [
'ssr' => [
'enabled' => env('INERTIA_SSR_ENABLED', true),
'url' => env('INERTIA_SSR_URL', 'http://127.0.0.1:13714'),
],
];Merender komponen Vue via Node.js pada setiap permintaan masuk tetap memakan siklus CPU. Untuk halaman katalog, artikel, atau landing page SaaS yang datanya jarang berubah setiap detik, saya selalu membungkus data controller dengan Redis Cache serta mengevaluasi properti malas (Lazy Evaluation) di dalam HandleInertiaRequests.php:
<?php
namespace App\Http\Controllers;
use App\Models\Article;
use Illuminate\Support\Facades\Cache;
use Inertia\Inertia;
use Inertia\Response;
class PublicArticleController extends Controller
{
public function show(string $slug): Response
{
$article = Cache::tags(['articles'])->remember(
"article_detail_{$slug}",
now()->addHours(6),
fn () => Article::with(['author:id,name,avatar', 'category:id,name,slug'])
->where('slug', $slug)
->where('status', 'published')
->firstOrFail()
);
return Inertia::render('Articles/Show', [
'article' => $article,
'relatedArticles' => Inertia::defer(fn () =>
Article::where('category_id', $article->category_id)
->where('id', '!=', $article->id)
->select('id', 'title', 'slug', 'published_at')
->limit(4)
->get()
),
]);
}
}Analisis Optimasi Query & Inertia Payload:
Cache::tags(['articles']): Menyimpan hasil query Eloquent beserta relasinya di memori RAM Redis selama 6 jam, sehingga database MySQL/PostgreSQL tidak tersentuh saat terjadi lonjakan trafik.Inertia::defer(): Menunda pemuatan data sekunder seperti daftar artikel terkait hingga halaman utama selesai di-render, menjaga ukuran payload JSON awal tetap sangat ringan.
💡 Tips Praktis & Optimasi Performa dari Pengalaman Saya
Saat mengelola server Cloud VPS produksi dengan trafik tinggi, jangan pernah menjalankan perintah
php artisan inertia:start-ssrsecara manual di sesi SSH karena prosesnya akan mati begitu terminal ditutup. Daftarkan layanan SSR ke dalam Supervisor agar otomatis menyala ulang jika terjadi lonjakan memori.Tambahkan juga perintah
php artisan inertia:stop-ssrpada baris akhir skrip deployment CI/CD Anda. Supervisor akan langsung mendeteksi penghentian tersebut dan me-restart daemon Node.js menggunakan bundelssr.mjsversi terbaru tanpa downtime.
Langkah 3: Konfigurasi Supervisor di Server Produksi VPS
Buat file konfigurasi worker baru di direktori /etc/supervisor/conf.d/inertia-ssr.conf pada server Ubuntu/Debian Anda untuk menjaga stabilitas daemon SSR:
[program:inertia-ssr]
process_name=%(program_name)s
command=php /var/www/sarjanait/artisan inertia:start-ssr
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/sarjanait/storage/logs/ssr.log
stopwaitsecs=3600Aktifkan worker tersebut dengan menjalankan sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start inertia-ssr. Anda bisa memverifikasi apakah SSR sudah bekerja dengan melihat kode sumber halaman (View Page Source atau Ctrl + U) di browser; seluruh teks HTML komponen Vue kini tampil utuh di dalam elemen <div id="app" data-page="...">.

⚠️ Troubleshooting & Skenario Error Handling di Lapangan
Error Spesifik:
ReferenceError: window is not definedataudocument is not defineddi dalam file logstorage/logs/ssr.logsaat halaman diakses.Akar Masalah & Solusi: Error ini terjadi karena ada kode atau library pihak ketiga (seperti chart atau editor teks) yang memanggil objek DOM browser di dalam blok
<script setup>tingkat atas yang ikut dieksekusi oleh Node.js. Pindahkan seluruh manipulasiwindowataulocalStorageke dalam hookonMounted(() => { ... })karena hook tersebut hanya dieksekusi di sisi browser setelah proses hydration selesai.
FAQ Teknis Implementasi SSR & Optimasi Laravel Inertia
1. Apakah semua halaman dashboard admin wajib menggunakan SSR?
Tidak perlu. Halaman internal di balik layar login seperti panel admin tidak membutuhkan indeksasi SEO. Anda bisa membatasi SSR hanya untuk rute publik melalui konfigurasi middleware atau membiarkan server SSR berjalan ringan karena Inertia hanya merender permintaan pertama kali (initial page load), sementara navigasi berikutnya tetap berjalan murni sebagai SPA via XHR.
2. Apa yang terjadi jika daemon Node.js SSR tiba-tiba crash di server produksi?
Laravel Inertia memiliki mekanisme graceful fallback bawaan. Jika koneksi ke port 13714 gagal atau timeout, Laravel otomatis menurunkan mode rendering kembali ke Client-Side Rendering standar tanpa memunculkan error 500 kepada pengguna.
3. Bagaimana cara mengatasi kebocoran memori (Memory Leak) pada proses Node.js SSR?
Hindari menyimpan state global atau instance variabel di luar fungsi callback createServer((page) => ...) pada file ssr.js. State yang dideklarasikan di luar fungsi tersebut akan bertahan di memori antar-permintaan pengguna yang berbeda, yang tidak hanya memicu kebocoran RAM tetapi juga berisiko membocorkan data sesi antar-pengguna.
4. Apakah Laravel Octane kompatibel dijalankan bersamaan dengan Inertia SSR?
Sangat kompatibel. Kombinasi Laravel Octane (berbasis Swoole atau FrankenPHP) dengan daemon Inertia SSR memangkas latensi komunikasi HTTP lokal antar-proses menjadi hitungan milidetik, menjadikannya arsitektur paling ideal untuk aplikasi SaaS skala tinggi.
Diskusi & Komentar
0Sampaikan pertanyaan teknis, masukan, atau feedback Anda seputar artikel ini.
Belum Ada Komentar
Jadilah pembaca pertama yang memulai diskusi menarik atau bertanya seputar materi artikel ini!