Cara mengatasi error listen EACCES: permission denied ::1:4001 pada TinaCMS (Windows 11 & WSL2)

Pesan Error listen EACCES: permission denied ::1:4001 menunjukkan bahwa aplikasi kita tidak memiliki izin yang diperlukan untuk listen port 4001 (GraphQL TinaCMS) pada antarmuka yang ditentukan (::1 adalah alamat loopback IPv6). Ini adalah masalah umum pada pengembangan web modern seperti TinaCMS yang berjalan di atas Vite.

Masalah

Berikut adalah potongan kode error EACCESS tersebut:

Error occured during tinacms dev
Error: listen EACCES: permission denied ::1:4001
at Server.setupListenHandle [as _listen2] (node:net:1918:21)
at listenInCluster (node:net:1997:12)
at GetAddrInfoReqWrap.callback (node:net:2206:7)
at GetAddrInfoReqWrap.onlookupall [as oncomplete] (node:dns:134:8)
{
code: 'EACCES',
errno: -4092,
syscall: 'listen',
address: '::1',
port: 4001
}

Solusi

Untuk mengatasi masalah ini, dengan indikasi kuat ada ::1 di pesan error diatas, maka yang perlu kita lakukan adalah nonaktifkan sementara IPv6. Namun sebelum melakukannya, ada baiknya kita cek dulu di PowerShell (jalankan sebagai Run As Administrator) apakah ada port yang konflik atau tidak dengan perintah netstat -ano | findstr :4001, jika ada port aktif matikan dengan perintah taskkill /F /PID <PID> di jendela PowerShell yang sama, ubah <PID> dengan angka yang kita dapatkan dari netstat tadi.

Setelah memeriksa port yang konflik, kita dapat lanjutkan untuk menonaktifkan IPv6 dari jaringan, baik dari LAN ataupun WiFi. Caranya masuk Control Panel View network status and task Change adapter settings klik kanan di bagian antarmuka jaringan, misal WiFi Properties buka centang Internet Protocol Version 6 (TCP/IPv6).

Untuk pengguna WSL2, kita dapat lakukan restart pada WinNAT sehingga layanan tersebut membaca pengaturan terbaru dengan IPv6 yang telah dinonaktifkan. Caranya buka PowerShell (jalankan sebagai Run As Administrator).

net stop winnat
net start winnat

Masih di jendela yang sama, kita akan naikkan batas awal dynamic port range karena beberapa kasus, Windows (terutama dengan Hyper-V aktif) mengalokasikan rentang port dinamis yang terlalu luas dan mencakup port 4001.

netsh int ipv4 set dynamicport tcp start=49152 num=16384

Kesimpulan

Sejauh pengalaman saya, solusi diatas adalah cara paling ampuh mengatasi port 4001 tidak berfungsi dengan baik di Windows 11 maupun WSL2. Saran-saran di internet dan AI (terutama ChatGPT) seperti menonaktifkan antivirus, firewall, Windows Defender, mengubah konfigurasi script di package.json, vite config adalah saran paling bodoh dan konyol yang tidak perlu dilakukan.