Node.js, Next.js, Express.js কিংবা অন্য কোনো JavaScript Project নিয়ে কাজ করার সময় Windows-এ অনেক Developer একটি সমস্যার মুখোমুখি হন। Terminal-এ Project চালু করতে গেলে নিচের Error দেখা যায়:
Error: listen EACCES: permission denied 0.0.0.0:3000
at new Promise (<anonymous>) {
code: 'EACCES',
errno: -4092,
syscall: 'listen',
address: '0.0.0.0',
port: 3000
}
বিশেষ করে yarn dev, npm run dev অথবা Node.js Server চালু করার সময় এই সমস্যা দেখা দিতে পারে। মজার বিষয় হলো, অনেক সময় Port 3000 অন্য কোনো Application ব্যবহার না করলেও এই Error আসে।
আজকে Windows-এ এই সমস্যার সম্ভাব্য কারণ এবং একটি সহজ সমাধান নিয়ে আলোচনা করব।
কেন এই Error হয়?
EACCES মানে হলো Application নির্দিষ্ট Network Address ও Port-এ Server চালু করার Permission পাচ্ছে না।
এই সমস্যার কয়েকটি সম্ভাব্য কারণ রয়েছে:
১. Windows-এর কোনো Network Service নির্দিষ্ট Port Reserve করে রেখেছে। ২. Hyper-V, WSL 2 অথবা Docker-এর Virtual Networking-এর কারণে Port Excluded Range-এর মধ্যে চলে গেছে। ৩. অন্য কোনো Application ইতোমধ্যে Port 3000 ব্যবহার করছে। ৪. Windows Network Configuration বা NAT Service-সংক্রান্ত সমস্যা রয়েছে।
এখানে 0.0.0.0 বলতে IPv4-এর সব Network Interface-এ Server Listen করার চেষ্টা করছে বোঝায়।
সহজ সমাধান: WinNAT Restart করুন
অনেক Windows Developer-এর ক্ষেত্রে Windows NAT Service Restart করলে এই সমস্যার সমাধান হয়েছে। আমিও এই পদ্ধতিটি শেয়ার করছি।
ধাপ ১: PowerShell Administrator Mode-এ চালু করুন।
- Start Menu খুলুন।
- PowerShell লিখে Search করুন।
- Windows PowerShell-এর ওপর Right Click করুন।
- Run as Administrator নির্বাচন করুন।
ধাপ ২: নিচের Command দুটি একে একে Execute করুন।
প্রথমে WinNAT Service বন্ধ করুন:
net stop winnat
এরপর Service আবার চালু করুন:
net start winnat
দুটি Command সফলভাবে Execute হলে PowerShell বন্ধ করে দিন।
ধাপ ৩: Project আবার চালু করুন।
এবার আপনার Project Folder-এ গিয়ে Development Server চালু করুন।
Yarn ব্যবহার করলে:
yarn dev
NPM ব্যবহার করলে:
npm run dev
অনেক ক্ষেত্রে এরপর Port 3000-এর EACCES Error আর দেখা যায় না।
কাজ না হলে কী করবেন?
উপরের পদ্ধতিতে কাজ না হলে Port 3000 Windows-এর Excluded Port Range-এর মধ্যে আছে কি না, সেটি পরীক্ষা করুন।
Administrator PowerShell-এ এই Command চালান:
netsh interface ipv4 show excludedportrange protocol=tcp
এতে Windows-এর Reserved বা Excluded TCP Port Range দেখা যাবে। তালিকায় যদি Port 3000 কোনো Range-এর মধ্যে পড়ে, তাহলে সেটি ব্যবহার করতে সমস্যা হতে পারে।
আরেকটি বিষয় পরীক্ষা করুন। অন্য কোনো Process Port 3000 ব্যবহার করছে কি না, দেখতে চালান:
netstat -ano | findstr :3000
কোনো Process পাওয়া গেলে তার PID দেখে Task Manager থেকে Application শনাক্ত করতে পারবেন।
সবচেয়ে সহজ বিকল্প হলো Project-এর Port পরিবর্তন করে দেখা। Next.js ব্যবহার করলে:
yarn dev -p 3001
এতে Development Server Port 3001-এ চালু হবে।
সতর্কতা
WinNAT Restart করলে WSL 2, Docker বা Hyper-V-এর Virtual Networking সাময়িকভাবে প্রভাবিত হতে পারে। তাই Container বা Virtual Machine-এ গুরুত্বপূর্ণ কাজ চলার সময় Service Restart করবেন না।
আর মনে রাখবেন, net stop winnat ও net start winnat সব ধরনের EACCES Error-এর Universal Fix নয়। Port Excluded থাকলে বা অন্য কোনো Application Port ব্যবহার করলে আলাদা সমাধান প্রয়োজন হতে পারে।
শেষ কথা
Windows-এ Node.js বা Next.js Project চালু করার সময় listen EACCES: permission denied 0.0.0.0:3000 Error পেলে প্রথমে WinNAT Restart করে দেখতে পারেন। কাজ না হলে Excluded Port Range এবং Port Usage পরীক্ষা করুন।
আপনার PC-তে কোন পদ্ধতিতে সমস্যার সমাধান হয়েছে, তা কমেন্টে জানাতে পারেন। অন্য কোনো কার্যকর সমাধান জানা থাকলেও শেয়ার করুন, যাতে অন্য Developer-রাও উপকৃত হতে পারেন।