Panduan ini ditujukan untuk administrator VPS dan pemilik website. Contoh perintah di bawah bersifat pemeriksaan dan pemulihan pada server milik sendiri. Artikel tidak menyertakan payload eksploit untuk mengambil alih sistem. Pengujian keberhasilan patch dilakukan dengan memeriksa versi, konfigurasi, layanan, dan fungsi normal aplikasi di lingkungan yang terkendali.
![]() |
| Ilustrasi keamanan server untuk artikel Node2Shell. |
1. Ringkasan: apa itu Node2Shell?
Node2Shell adalah nama yang digunakan untuk CVE-2026-111497, kerentanan out-of-bounds write pada decoder Brotli yang dibundel dengan Node.js. Node.js merilis perbaikan keamanan pada 21 Oktober 2026. Jika aplikasi mendekompresi data Brotli yang dikendalikan penyerang melalui API seperti node:zlib, kerusakan memori dapat menyebabkan crash, kebocoran memori, dan berpotensi RCE.
Ini bukan berarti setiap aplikasi Node.js otomatis dapat dieksploitasi. Jalur yang rentan harus dapat menerima data Brotli tidak tepercaya dan meneruskannya ke decoder. Namun, karena komponen decoder berada di runtime, administrator tetap harus memperbarui runtime di semua aplikasi dan container yang relevan. Lihat pengumuman resmi Node.js.
2. Bagaimana bug bekerja?
Brotli adalah format kompresi. Decoder mengubah data terkompresi menjadi data asli. Pada alur tertentu, decoder salah menganggap penanda perpindahan blok yang tidak valid sebagai permintaan menunggu data tambahan. Ketika data streaming berikutnya terus ditambahkan, decoder dapat menulis melewati batas buffer internal yang sangat kecil. Kondisi ini dikenal sebagai out-of-bounds write.
- Aplikasi menerima data Brotli dari sumber luar atau membaca data yang dikirim pengguna.
- Aplikasi/library memanggil decoder Brotli, misalnya melalui
node:zlib. - Decoder versi rentan salah menangani pola data yang tidak valid.
- Memori proses Node.js dapat rusak, sehingga aplikasi bisa crash atau dalam kondisi tertentu terjadi kebocoran data/RCE.
Alur ini adalah gambaran teknis, bukan contoh payload exploit. Jangan mencoba mengirim stream malformed ke server produksi.
Perlu dibedakan antara mengompresi respons dan mendekompresi input tidak tepercaya. Risiko ini berada pada decoder. Mematikan kompresi respons di Nginx tidak otomatis menutup jalur lain, misalnya aplikasi yang mendekompresi konten dari layanan pihak ketiga.
3. Versi yang terdampak dan versi perbaikan
| Cabang | Perbaikan minimum | Rilis lebih baru per 31 Okt 2026 |
|---|---|---|
| Node.js 22.x | 22.23.4 | Gunakan patch terbaru pada cabang 22.x |
| Node.js 24.x | 24.22.1 | 24.22.2 LTS |
| Node.js 26.x | 26.12.1 | 26.13.0 |
Versi 24.22.2 dan 26.13.0 dirilis pada 28 Oktober 2026, setelah rilis keamanan awal. Gunakan rilis terbaru dalam cabang yang didukung, bukan berhenti tepat pada versi minimum jika tersedia pembaruan lebih baru.
Sebagai contoh, bila terminal menampilkan v18.19.1, itu adalah Node.js 18 yang sudah EOL. Versi tersebut tidak menerima security release reguler. Jangan menyimpulkan bahwa Node 18 aman hanya karena tabel patch Oktober menyebut cabang 22, 24, dan 26; pindahkan aplikasi ke cabang LTS yang masih didukung.
Node.js 18.19.1 yang masih digunakan sebagian server sudah EOL. Versi EOL tidak menerima pembaruan keamanan reguler. Node.js 18 tidak tercantum sebagai salah satu cabang aktif yang menerima patch khusus Node2Shell, tetapi itu tidak menjadikan versi tersebut layak dipertahankan: versi EOL tidak memperoleh perbaikan untuk security release terbaru. Pindahkan aplikasi ke cabang LTS yang masih didukung setelah menguji kompatibilitas.
4. Apakah aplikasi saya benar-benar menggunakan decoder yang berisiko?
Periksa apakah project menerima atau memproses data Brotli dari pengguna, API eksternal, file upload, antrean pesan, atau layanan lain. Cari pemanggilan decoder di source code:
grep -RInE 'brotliDecompress|createBrotliDecompress|Content-Encoding.*br|brotli' . \
--exclude-dir=node_modules --exclude-dir=.git
Hasil pencarian hanya petunjuk awal. Sebuah dependency dapat melakukan dekompresi secara internal tanpa nama fungsi yang muncul langsung di kode aplikasi. Tinjau dokumentasi package dan jalur data dari luar. Penggunaan encoder saja untuk mengompresi respons tidak sama dengan menerima dan mendekompresi data berbahaya.
Catatan: npm audit berguna untuk memeriksa kerentanan dependency npm, tetapi tidak menggantikan pemeriksaan dan upgrade runtime Node.js itu sendiri. CVE ini berada pada library Brotli yang dibundel runtime, bukan selalu pada package di package.json.
5. Pemeriksaan aman di VPS aaPanel
Jalankan perintah ini melalui SSH:
node -v
npm -v
command -v node
readlink -f "$(command -v node)"
node -p "process.execPath"
node -p "process.versions.brotli"
Untuk server yang memasang Node.js dari paket Debian/Ubuntu, periksa asal paket dan proses aktif:
dpkg -S /usr/bin/node /usr/bin/npm 2>/dev/null
apt-cache policy nodejs
ps -eo pid,ppid,user,cmd | grep -E '[n]ode|[n]pm|[p]m2'
systemctl list-units --type=service --all | grep -Ei 'node|pm2'
command -v pm2 || true
Versi dari terminal belum tentu sama dengan versi yang digunakan aplikasi. Project aaPanel, systemd, Docker, PM2, atau shell login yang berbeda dapat menunjuk ke binary Node.js yang berbeda. Periksa juga halaman Node Project Manager bila plugin tersebut dipakai.
6. Tutorial upgrade Node.js di aaPanel — langkah demi langkah
- Inventarisasi semua aplikasi Node.js. Di aaPanel, periksa Node Project Manager jika tersedia. Catat direktori project, versi runtime yang dipilih, port, perintah start, user service, file environment, dan domain reverse proxy.
- Periksa apakah aplikasi berjalan dalam Docker. Lihat Docker Compose/Dockerfile. Jika image memakai Node 18 atau tag lama, catat image dan tag yang aktif. Upgrade host tidak otomatis mengganti runtime yang berada di dalam container.
- Cadangkan sebelum mengganti runtime. Backup source code, file
.env, lockfilepackage-lock.json/pnpm-lock.yaml/yarn.lock, konfigurasi service, dan data aplikasi. Jangan menaruh salinan file rahasia di folder publik. - Pilih cabang LTS yang kompatibel. Untuk instalasi baru, Node.js 24.22.2 LTS adalah pilihan yang dapat dipertimbangkan. Uji versi package, framework, native addon, dan build tool lebih dahulu. Jangan memaksa upgrade major tanpa tes.
- Jika menggunakan aaPanel Node Project Manager: buka menu Node Project Manager, tambahkan/pasang versi Node 24 LTS yang telah dipatch, lalu edit setiap project dan pilih runtime baru. Nama tombol dapat sedikit berbeda menurut versi plugin.
- Jika Node.js berasal dari APT: identifikasi repositori melalui
apt-cache policy nodejs. Jangan menjalankanapt install nodejssecara membabi buta; repositori Ubuntu yang sekarang aktif mungkin tetap menawarkan versi 18. Tambahkan/gunakan hanya repositori resmi yang sesuai dan pastikan kandidat paket benar-benar versi LTS patch sebelum memasang. Simpan data paket/config sebelum upgrade. - Jika menggunakan Docker: ubah base image ke tag Node.js yang telah dipatch, rebuild image, lalu recreate container. Jangan hanya memperbarui Node pada host sementara container masih memakai image lama.
- Pasang dependency sesuai lockfile. Di direktori aplikasi, gunakan package manager yang memang dipakai project. Untuk npm dengan lockfile, umumnya gunakan
npm cipada environment uji/build, kemudian jalankan test dan build aplikasi. - Alihkan project dan restart. Pilih runtime baru di panel atau perbarui service/container, kemudian restart aplikasi. Jangan menghapus runtime lama sampai semua project lolos uji.
Catatan untuk contoh VPS aaPanel: apabila command -v node menampilkan /usr/bin/node, artinya shell menggunakan binary sistem. Hasil dpkg -S dan apt-cache policy membantu menentukan pemilik paket dan sumbernya. Jika aplikasi dijalankan oleh panel dengan path lain, memperbarui /usr/bin/node saja belum tentu memperbarui aplikasi tersebut.
7. Uji fungsi Brotli secara aman setelah upgrade
Setelah runtime diperbarui, uji kemampuan kompresi/dekompresi normal dengan data buatan sendiri. Tes ini memastikan API Brotli dasar berjalan, tetapi bukan proof-of-concept kerentanan dan bukan pengganti pemeriksaan versi.
node -e "const z=require('node:zlib'); const input=Buffer.from('Tes Brotli lokal setelah pembaruan Node.js'); const packed=z.brotliCompressSync(input); const result=z.brotliDecompressSync(packed); console.log(result.toString());"
Output yang diharapkan adalah kalimat tes tadi. Jika fungsi gagal, periksa versi Node, log aplikasi, dan kompatibilitas package.
8. Simulasi pengujian aman di staging
Pengujian berikut hanya menggunakan data normal yang dibuat sendiri. Ini tidak menguji exploit Node2Shell, tetapi memastikan fungsi Brotli normal dan aplikasi tetap bekerja setelah pergantian runtime.
- Siapkan staging yang memakai versi Node.js yang sudah dipatch.
- Jalankan tes kompresi/dekompresi normal pada bagian sebelumnya. Pastikan teks hasil dekompresi sama dengan teks input.
- Jalankan test suite aplikasi, kemudian uji endpoint yang memang menerima data terkompresi dari sumber tepercaya.
- Uji respons HTTP, koneksi database, job queue, upload, dan worker background.
- Periksa log aplikasi untuk crash atau restart. Jika lolos, alihkan project produksi ke runtime baru dan restart sesuai jadwal maintenance.
Jangan membuat payload Brotli malformed atau mengujinya pada layanan publik. Pengujian normal tidak membuktikan keamanan dari seluruh input berbahaya; dasar utama mitigasi adalah runtime dengan patch resmi.
9. Verifikasi dan hardening setelah patch
- Jalankan kembali
node -vdari shell dan dari direktori/runtime project yang benar. - Pastikan service/container telah direstart dan tidak ada proses lama yang masih menggunakan binary rentan.
- Jalankan test aplikasi, endpoint API, integrasi HTTP client, upload/download, queue, dan worker.
- Periksa log untuk crash, restart berulang, lonjakan penggunaan memori, dan koneksi keluar yang tidak biasa.
- Batasi aplikasi agar hanya mendekompresi data dari sumber yang memang diperlukan. Validasi ukuran input dan batasi resource; jangan menganggap validasi ukuran saja menyembuhkan bug runtime.
CSA Singapura pada 30 Oktober 2026 menerbitkan peringatan bahwa kerentanan kritis Brotli yang berdampak pada berbagai produk sedang dieksploitasi secara aktif. Peringatan ini meningkatkan urgensi update, tetapi tidak berarti setiap aplikasi Node.js otomatis memiliki jalur eksploitasi yang terbuka.
10. Kesimpulan
Node2Shell berada pada decoder Brotli di runtime. Periksa semua tempat Node.js berjalan: binary sistem, Node Project Manager, service systemd, PM2 jika digunakan, serta container. Untuk server yang masih memakai Node.js 18.19.1, rencanakan migrasi ke LTS yang didukung dan uji aplikasi sebelum cutover. Memblokir Brotli di reverse proxy bukan mitigasi lengkap bagi server yang juga mendekompresi data dari sumber lain.
Referensi resmi
- Node.js — Security Releases, 21 Oktober 2026
- Node.js — daftar rilis terbaru
- Node.js — status dan jadwal dukungan versi
- CSA Singapore — peringatan eksploitasi aktif kerentanan Brotli, 30 Oktober 2026
Diperiksa 31 Oktober 2026. Versi LTS dapat berubah. Gunakan patch terbaru pada cabang yang masih didukung. Artikel ini merupakan panduan administrasi defensif.
