21/11/2026 00:00น.

localhost กับ Port คืออะไร แก้ error "Port 3000 is already in use" บน Mac และ Windows
#localhost 3000 คือ
#port 3000 is already in use
#localhost คือ
#port 8080 คือ
#eaddrinuse
ลองนึกภาพว่าคุณเพิ่ง clone โปรเจกต์ Node.js มาจาก GitHub พิมพ์ npm run dev แล้วรอดูหน้าเว็บ แต่สิ่งที่ขึ้นมากลับเป็นตัวหนังสือสีแดงยาวเหยียด บรรทัดที่สำคัญที่สุดเขียนว่า Error: listen EADDRINUSE: address already in use :::3000 เมื่อวานยังรันได้ดีๆ วันนี้ไม่ได้แก้อะไรเลย แต่มันไม่ยอมขึ้น
ไม่ต้องตกใจ โค้ดคุณไม่ได้พัง และไม่ได้เกิดกับคุณคนเดียว error นี้แค่บอกว่ามีโปรแกรมอื่นจองที่ไว้ก่อนแล้ว วันนี้ Superdev Academy จะพาไปเข้าใจว่า localhost กับ port คืออะไร ลองทำให้ error นี้เกิดขึ้นเองบนเครื่องจริง แล้วแก้ให้ครบทั้งบน Mac และ Windows
localhost คืออะไร ทำไมต้องเป็น 127.0.0.1
localhost คือชื่อที่ใช้เรียก "เครื่องที่คุณนั่งอยู่ตอนนี้" เวลาเปิด http://localhost:3000 เบราว์เซอร์ไม่ได้ออกไปหาเว็บที่ไหนบนอินเทอร์เน็ต แต่วนกลับมาคุยกับโปรแกรมที่รันอยู่ในเครื่องตัวเอง
มาตรฐาน RFC 6761 กำหนดไว้ว่าชื่อ localhost ต้องชี้ไปที่ Loopback Address (ที่อยู่สำหรับวนกลับเข้าเครื่องตัวเอง) เสมอ และระบบไม่ควรส่งชื่อนี้ไปถาม DNS ข้างนอกด้วยซ้ำ ส่วนตัวเลขที่อยู่เบื้องหลังมีสองแบบ
127.0.0.1: ที่อยู่ Loopback แบบ IPv4 มาตรฐาน RFC 1122 กำหนดให้ที่อยู่ที่ขึ้นต้นด้วย 127 ทั้งหมดเป็น Loopback ภายในเครื่อง และห้ามหลุดออกไปนอกเครื่อง
::1: ที่อยู่ Loopback แบบ IPv6 ตามมาตรฐาน RFC 4291
เพราะฉะนั้นคำถามที่คนค้นบ่อยว่า "localhost คือ IP อะไร" ตอบได้ว่าปกติคือ 127.0.0.1 หรือ ::1 แล้วแต่ว่าโปรแกรมฟังอยู่บน IPv4 หรือ IPv6 ข้อสำคัญคือมันเข้าได้จากเครื่องตัวเองเท่านั้น เพื่อนที่นั่งข้างๆ พิมพ์ localhost บนเครื่องเขา ก็จะไปเจอเครื่องของเขาเอง ไม่ใช่เครื่องคุณ
ทีมเราลองเปิด server ทดสอบ (ตัวเดียวกับในหัวข้อถัดไป) แล้วเรียกสามแบบ คือ localhost, 127.0.0.1 และ [::1] ทั้งสามแบบได้คำตอบกลับมาจากโปรเซสเดียวกัน เพราะ server ตัวนี้ฟังที่อยู่ :: ซึ่งรับได้ทั้ง IPv4 และ IPv6 พอใช้ curl -v http://localhost:3917 ดูรายละเอียด จะเห็นบรรทัด Trying 127.0.0.1:3917... ตามด้วย Connected to localhost (127.0.0.1) แปลว่าบนเครื่องทีมเรา ชื่อ localhost ถูกแปลงเป็น 127.0.0.1 ก่อนเชื่อมต่อจริง
ถ้าอยากให้คนอื่นเปิดเว็บที่รันอยู่ในเครื่องคุณได้ ต้องใช้วิธีอื่น เช่นที่เราเล่าไว้ใน วิธีใช้ Cloudflare Tunnel เชื่อม Localhost ออกเน็ต โดยไม่ต้องเปิด Port
Port คืออะไร ทำไมต้อง 3000, 5173, 8080 หรือ 80
ถ้าเปรียบ IP เป็นที่อยู่ของตึก Port ก็คือเลขห้องในตึกนั้น เครื่องหนึ่งเครื่องรันโปรแกรมที่รอรับการเชื่อมต่อได้หลายตัวพร้อมกัน เช่น เว็บที่กำลังพัฒนา ฐานข้อมูล และโปรแกรมแชต แต่ละตัวต้องจองห้องของตัวเองไว้ ข้อมูลที่ส่งเข้ามาถึงจะรู้ว่าต้องไปหาโปรแกรมไหน
กฎข้อเดียวที่ต้องจำคือ หนึ่ง Port ให้โปรแกรมจองฟังได้ทีละตัว บนที่อยู่เดียวกัน ถ้ามีตัวหนึ่งจองไว้แล้ว ตัวที่มาทีหลังจะเข้าไม่ได้ ตรงนี้แหละคือที่มาของ error ตอนต้นบทความ
เลข Port มีตั้งแต่ 0 ถึง 65535 มาตรฐาน RFC 6335 แบ่งไว้เป็นสามช่วง
0 ถึง 1023 (System Ports หรือ Well Known Ports): ช่วงของบริการมาตรฐาน IANA เป็นผู้กำหนด
1024 ถึง 49151 (User Ports หรือ Registered Ports): IANA รับลงทะเบียนให้บริการต่างๆ
49152 ถึง 65535 (Dynamic Ports): ไม่มีการกำหนดให้ใคร ระบบหยิบไปใช้ชั่วคราวได้
ช่วง Dynamic Ports มีให้เห็นจริงทุกครั้งที่เบราว์เซอร์เปิดเว็บ ฝั่งที่ถูกเรียกจองเลขห้องที่แน่นอน เช่น 3917 ส่วนฝั่งที่เรียก ระบบจะสุ่มเลขห้องชั่วคราวให้ ทีมเราลองให้ server ทดสอบหน่วงคำตอบไว้ 3 วินาที แล้วใช้ curl เรียกเข้าไป ระหว่างนั้นรัน lsof ดู ได้ผลแบบนี้
node ... TCP *:3917 (LISTEN)
node ... TCP 127.0.0.1:3917->127.0.0.1:54225 (ESTABLISHED)
curl ... TCP 127.0.0.1:54225->127.0.0.1:3917 (ESTABLISHED)บรรทัดแรกคือ server ที่ยังจองห้อง 3917 รอคนใหม่อยู่ อีกสองบรรทัดคือการเชื่อมต่อที่กำลังคุยกัน curl ได้เลขห้องชั่วคราว 54225 ซึ่งอยู่ในช่วง Dynamic Ports พอดี และค่าของ macOS บนเครื่องทีมเราก็ตั้งช่วงนี้ไว้ที่ 49152 ถึง 65535 ตรงกับมาตรฐาน ข้อนี้ช่วยตอนอ่านผล lsof ด้วย ถ้าเห็นหลายบรรทัด ให้ดูบรรทัดที่มีคำว่า LISTEN เป็นหลัก เพราะนั่นคือโปรแกรมที่จองห้องไว้จริง
ทีนี้มาดูเลขที่เจอบ่อยในงานเว็บ ตามทะเบียน Service Name and Port Number Registry ของ IANA Port 80 ลงทะเบียนเป็น http, Port 443 เป็น https และ Port 8080 เป็น http-alt ซึ่งทะเบียนอธิบายไว้ว่าเป็น HTTP ทางเลือก นี่คือเหตุผลที่เว็บจริงไม่ต้องพิมพ์เลข Port เพราะเบราว์เซอร์ใช้ 80 หรือ 443 ให้เองอยู่แล้ว ส่วนคำถามว่า Port 8080 กับ 80 ต่างกันยังไง คำตอบคือ 8080 เป็นเลขที่คนนิยมใช้แทน 80 ตอนพัฒนาหรือทดสอบ
ที่น่าสนใจคือ Port 3000 ไม่ได้เป็นของ Node.js หรือ React เลย ในทะเบียน IANA เลข 3000 ลงไว้กับบริการชื่อ HBCI เลขนี้กลายเป็นค่าที่เจอบ่อยเพราะเครื่องมือหลายตัวเลือกใช้เป็นค่าเริ่มต้น เช่น Next.js ระบุใน CLI ว่า next dev ใช้ Port 3000 ถ้าไม่ได้กำหนดอย่างอื่น ส่วน Vite ใช้ 5173 เป็นค่าเริ่มต้น
localhost บอกว่า "เครื่องไหน" ส่วน Port บอกว่า "ห้องไหน" localhost:3000 จึงแปลว่าห้อง 3000 ในเครื่องตัวเอง
ลองทำให้ Port ชนกันเอง: EADDRINUSE เกิดจากอะไร
วิธีที่เข้าใจ error ได้เร็วที่สุดคือทำให้มันเกิดเอง ทีมเราเขียน server เล็กๆ ด้วย Node.js แล้วรันบน Mac ด้วย Node.js 26.5.0 เลือก Port 3917 ที่เช็กแล้วว่าว่าง จะได้ไม่ไปชนกับงานอื่นในเครื่อง
const http = require('http');
const port = process.env.PORT || 3917;
http.createServer((req, res) => res.end('hello from ' + process.pid + '\n'))
.listen(port, () => console.log(`listening on http://localhost:${port} (pid ${process.pid})`));รันครั้งแรกด้วย node server.js ทำงานปกติ
listening on http://localhost:3917 (pid 89374)ทีนี้เปิด Terminal อีกหน้าต่างหนึ่ง แล้วรันไฟล์เดิมซ้ำ ขณะที่ตัวแรกยังเปิดอยู่ ผลที่ได้คือ error ตัวเดียวกับตอนต้นบทความ (ตัดบรรทัด stack trace ตรงกลางออก)
Error: listen EADDRINUSE: address already in use :::3917
...
code: 'EADDRINUSE',
errno: -48,
syscall: 'listen',
address: '::',
port: 3917
}อ่านทีละส่วนได้แบบนี้ listen คือขั้นที่โปรแกรมขอจองห้อง EADDRINUSE ย่อมาจาก Address in use และ :::3917 หมายถึง Port 3917 บนทุกที่อยู่ของเครื่องแบบ IPv6 เอกสาร Node.js Errors อธิบายตรงกันว่า error นี้เกิดเมื่อ server พยายามจองที่อยู่ในเครื่อง แต่มี server อื่นในเครื่องเดียวกันจองไว้แล้ว
ในชีวิตจริง "ตัวแรก" มักไม่ได้เปิดค้างไว้ให้เห็นแบบนี้ บ่อยครั้งเป็น server จากเมื่อวานที่ปิดหน้าต่าง Terminal ไปแล้วแต่โปรเซสยังรันอยู่ หรือเป็นโปรเจกต์อื่นที่ใช้ Port เดียวกัน ขั้นต่อไปจึงต้องหาให้เจอว่าใครจองไว้
เพราะอะไรเมื่อวานถึงยังรันได้ แต่วันนี้ไม่ได้ สาเหตุที่พบบ่อยมีไม่กี่แบบ แบบแรกคือปิดหน้าต่างหรือแท็บ Terminal ไปแล้ว แต่ server ไม่ได้ถูกสั่งหยุดจริง แบบที่สองคือรัน server ไว้ใน Terminal ของ VS Code แล้วลืม พอเปิดอีกหน้าต่างก็รันซ้ำ แบบที่สามคือโปรเจกต์อื่นในเครื่องใช้ Port เดียวกันพอดี วิธีป้องกันที่ง่ายที่สุดคือปิด server ด้วย Ctrl+C ในหน้าต่างที่รันมันทุกครั้ง ปุ่มนี้ส่งสัญญาณ INT (Interrupt) ไปบอกให้โปรแกรมหยุด ทีมเราลองส่งสัญญาณ INT ให้ server ทดสอบแล้ว รัน lsof ซ้ำก็ไม่เจออะไร Port ว่างทันที
หาว่าโปรแกรมไหนจอง Port แล้วปิดอย่างปลอดภัย
บน Mac และ Linux: lsof แล้ว kill
ใช้คำสั่ง lsof (List Open Files) ถามว่าใครเปิด Port นี้อยู่ ทีมเราเจอเรื่องน่างงตอนทดสอบ ถ้าพิมพ์ lsof -i :3917 เฉยๆ ช่องสุดท้ายแสดงแบบนี้
COMMAND PID USER FD TYPE ... NAME
node 89374 superdevteam 12u IPv6 ... TCP *:aftmux (LISTEN)คำว่า aftmux คือชื่อบริการที่ IANA ลงทะเบียนไว้กับเลข 3917 lsof แปลงเลขเป็นชื่อให้เอง เลยดูไม่ออกว่าเป็น Port ที่เราตามหา วิธีแก้คือเติม -nP ซึ่งในคู่มือของ lsof ตัว -n สั่งไม่ให้แปลงที่อยู่เป็นชื่อเครื่อง และ -P สั่งไม่ให้แปลงเลข Port เป็นชื่อบริการ
lsof -nP -iTCP:3917 -sTCP:LISTENCOMMAND PID USER FD TYPE ... NAME
node 89374 superdevteam 12u IPv6 ... TCP *:3917 (LISTEN)อ่านผลลัพธ์ทีละคอลัมน์ได้แบบนี้ COMMAND คือชื่อโปรแกรม PID คือเลขประจำตัวโปรเซส USER คือผู้ใช้ที่รันโปรแกรมนั้น ส่วน NAME บอกว่าฟังอยู่ที่ไหน *:3917 แปลว่าฟัง Port 3917 บนทุกที่อยู่ของเครื่อง และคำว่า (LISTEN) ยืนยันว่ากำลังรอรับการเชื่อมต่อ ถ้า USER ไม่ใช่ชื่อคุณ เช่น เป็นผู้ใช้ของระบบ ให้หยุดคิดก่อนสั่งปิด
ส่วน -sTCP:LISTEN กรองให้เหลือแค่โปรแกรมที่กำลังจองฟังอยู่ ตอนนี้รู้แล้วว่าเป็นโปรแกรม node และ PID (Process ID หรือเลขประจำตัวโปรเซส) คือ 89374 ถ้าแน่ใจว่าเป็น server ของเราเอง ก็ปิดด้วย
kill 89374คู่มือของคำสั่ง kill บน Mac ระบุว่าถ้าไม่ใส่ตัวเลือก จะส่งสัญญาณ TERM ซึ่งเป็นการขอให้โปรแกรมปิดตัวตามปกติ ทีมเรารัน lsof ซ้ำหลังสั่ง kill ก็ไม่เจออะไรแล้ว Port ว่างทันที ส่วน kill -9 เป็นการส่งสัญญาณ KILL ที่โปรแกรมปฏิเสธไม่ได้ ควรเก็บไว้ใช้ตอนที่ kill ธรรมดาไม่ได้ผลจริงๆ เท่านั้น เพราะโปรแกรมจะไม่มีโอกาสปิดไฟล์หรือบันทึกงานให้เรียบร้อย
บน Windows: netstat แล้ว taskkill
ส่วนนี้ทีมเรายังไม่ได้รันเองบนเครื่อง Windows ขั้นตอนเรียบเรียงจากเอกสารของ Microsoft ถ้าเจอข้อความไม่ตรงกับในนี้ ให้ยึดเอกสารของ Microsoft เป็นหลัก
เปิด Command Prompt แล้วใช้ netstat ตาม เอกสาร netstat ของ Microsoft ตัวเลือก -a แสดง Port ทั้งหมดที่เครื่องกำลังฟังอยู่ -n แสดงที่อยู่และ Port เป็นตัวเลข และ -o แสดง PID ของแต่ละรายการ จากนั้นกรองเฉพาะ Port ที่สนใจด้วย findstr
netstat -ano | findstr :3000ผลที่ได้อาจมีหลายบรรทัด เพราะเอกสารของ Microsoft ระบุว่า -a แสดงทั้งการเชื่อมต่อ TCP ที่กำลังคุยกันอยู่และ Port ที่กำลังฟัง หลักการอ่านจึงเหมือนผล lsof บน Mac คือดูบรรทัดที่สถานะเป็น LISTENING เป็นหลัก ตัวเลขในคอลัมน์สุดท้ายของบรรทัดที่เป็น LISTENING คือ PID เอกสารของ Microsoft บอกว่าเอา PID ไปดูชื่อโปรแกรมได้ในแท็บ Processes ของ Task Manager ถ้าแน่ใจแล้วว่าเป็นโปรแกรมของเรา ก็ปิดด้วย taskkill ตาม เอกสาร taskkill โดยแทน 1234 ด้วย PID ที่เจอ
taskkill /pid 1234ถ้าโปรแกรมไม่ยอมปิด ค่อยเติม /f เพื่อบังคับปิด หลักการเดียวกับ kill -9 บน Mac คือใช้เมื่อจำเป็นเท่านั้น
อีกเรื่องที่ไม่ควรมองข้ามคือ อย่าเห็นเลข PID แล้วสั่งปิดทันที โดยเฉพาะ Port ที่คุณไม่ได้เป็นคนเปิด บางครั้งโปรแกรมที่จองอยู่คือฐานข้อมูลหรือบริการของระบบที่งานอื่นยังใช้อยู่ ดูชื่อโปรแกรมในช่อง COMMAND หรือใน Task Manager ก่อนทุกครั้ง ถ้าไม่แน่ใจ ทางที่ปลอดภัยกว่าคือเปลี่ยน Port ของเราแทน ซึ่งเป็นเรื่องของหัวข้อถัดไป
ถ้ายังไม่คุ้นกับการพิมพ์คำสั่งใน Terminal ลองปูพื้นที่ Terminal/Command Line ฉบับมือโปร: คำสั่งที่ควรรู้ ก่อนก็ได้
ไม่อยากปิดโปรแกรม? เปลี่ยน Port แทน
หลายครั้งการปิดโปรแกรมไม่ใช่ทางที่ดีที่สุด เช่น ต้องรันสองโปรเจกต์พร้อมกัน หรือโปรแกรมที่จอง Port เป็นของคนอื่น วิธีที่ง่ายกว่าคือให้โปรเจกต์ของเราย้ายไปห้องอื่น แต่ละเครื่องมือมีวิธีของตัวเอง
Next.js: CLI ของ Next.js รองรับ
next dev -p 3001หรือ--port 3001และอ่านค่าจากตัวแปรPORTได้ด้วยVite: เอกสาร Vite ระบุว่าถ้า Port 5173 ไม่ว่าง Vite จะลอง Port ถัดไปให้เองโดยอัตโนมัติ เพราะฉะนั้นถ้าใช้ Vite ให้ดูข้อความตอนรันว่าสุดท้ายได้ Port อะไร ถ้าอยากให้หยุดและแจ้ง error แทน ตั้ง
server.strictPortเป็นtrueNode.js ที่เขียนเอง: ให้อ่าน Port จากตัวแปรแวดล้อมแบบในตัวอย่างข้างบน แล้วรันด้วย
PORT=3918 node server.jsทีมเราลองแล้วได้listening on http://localhost:3918ทันที
ข้อควรระวังเวลาเปลี่ยน Port คือ ถ้าหน้าเว็บกับ API แยกกันรันคนละ Port เบราว์เซอร์จะมองว่าเป็นคนละ Origin และอาจเจอ CORS error ตามมา เรื่องนี้อธิบายไว้ละเอียดใน CORS error คืออะไร ทำไมเบราว์เซอร์บล็อก และแก้ยังไงให้ถูกที่
localhost refused to connect ไม่ใช่ Port ชน
อีก error หนึ่งที่คนมักเอาไปปนกันคือหน้าเบราว์เซอร์ขึ้นว่า localhost refused to connect หรือ ERR_CONNECTION_REFUSED อาการนี้ตรงข้ามกับ Port ชนเลย Port ชนคือมีคนอยู่ในห้องแล้วเราเข้าไม่ได้ ส่วน refused คือเคาะประตูแล้วไม่มีใครอยู่ในห้องเลย
ทีมเราลองหลังปิด server ทดสอบไปแล้ว ใช้ curl เรียก Port เดิม ได้ผลแบบนี้
curl: (7) Failed to connect to localhost port 3917 after 2 ms: Couldn't connect to serverเพราะฉะนั้นวิธีแก้จึงต่างกัน ถ้าเจอ refused ให้เช็กตามนี้
server รันอยู่จริงไหม: ดูใน Terminal ว่ายังมีข้อความ listening อยู่ หรือมี error ทำให้มันหยุดไปแล้ว
เปิดถูก Port ไหม: โดยเฉพาะ Vite ที่อาจย้ายไป 5174 ให้เองตอน 5173 ไม่ว่าง ดูเลขจากข้อความตอนรัน อย่าเดาเอง
เข้าจากเครื่องอื่นหรือเปล่า: server ที่ฟังเฉพาะ localhost จะรับได้แค่จากเครื่องตัวเอง ถ้าจะเปิดจากมือถือในวง Wi-Fi เดียวกัน ต้องให้ server ฟังที่
0.0.0.0ซึ่งเอกสาร Vite อธิบายว่าคือฟังทุกที่อยู่ของเครื่อง รวมถึงที่อยู่ในวง LAN สั่งได้ด้วย--host 0.0.0.0
อาการแปลกอีกแบบที่เจอบ่อยคือเปิด localhost:3000 แล้วไม่ได้ขึ้น error เลย แต่หน้าเว็บกลายเป็นของโปรเจกต์อื่น ต้นเหตุเหมือนกับ Port ชน คือมี server จากโปรเจกต์เก่ายังจองห้อง 3000 อยู่ ส่วนโปรเจกต์ใหม่ล้มไปตั้งแต่ตอนรัน หรือถูกย้ายไป Port อื่นโดยที่คุณไม่ทันเห็นข้อความ วิธีเช็กก็ใช้ lsof หรือ netstat แบบเดิม ดูว่าโปรแกรมที่จอง 3000 อยู่ในโฟลเดอร์ไหน แล้วกลับไปอ่านข้อความใน Terminal ของโปรเจกต์ใหม่ทีละบรรทัด
เรื่อง 0.0.0.0 ต้องระวังด้วย การฟังทุกที่อยู่แปลว่าคนอื่นในเครือข่ายเดียวกันเข้าถึงโปรเจกต์ของคุณได้ ใช้เฉพาะตอนที่ตั้งใจจะเปิดจากอุปกรณ์อื่นจริงๆ ใน Wi-Fi สาธารณะไม่ควรเปิดทิ้งไว้
สรุป: localhost กับ Port คืออะไร และแก้ Port 3000 is already in use ยังไง
localhost คือเครื่องตัวเอง ใช้ที่อยู่ 127.0.0.1 หรือ ::1 ส่วน Port คือเลขห้องที่แต่ละโปรแกรมจองไว้ฟัง หนึ่งห้องรับได้ทีละโปรแกรม เมื่อเจอ EADDRINUSE แปลว่ามีโปรแกรมอื่นจองห้องนั้นอยู่แล้ว ให้หาตัวการด้วย lsof -nP -iTCP:3000 -sTCP:LISTEN บน Mac หรือ netstat -ano | findstr :3000 บน Windows ดูชื่อโปรแกรมให้แน่ใจ แล้วค่อยปิดด้วย kill หรือ taskkill ถ้าไม่แน่ใจก็เปลี่ยน Port ของเราแทน และถ้าเจอ refused แทน แปลว่าไม่มีใครอยู่ในห้อง ไม่ใช่ห้องเต็ม
ครั้งหน้าที่เจอ error สีแดงตอน npm run dev ลองพิมพ์คำสั่ง lsof หรือ netstat ดูก่อน แค่รู้ว่าใครอยู่ในห้อง ปัญหาส่วนใหญ่ก็แก้ได้ในไม่กี่วินาที
ติดตามบทความและเทคนิคสำหรับคนเริ่มต้นสายโปรแกรมเมอร์ได้ที่ช่องทางของเรา
Facebook: Superdev Academy Thailand — https://www.facebook.com/superdev.academy.th
YouTube: Superdev Academy Channel — https://www.youtube.com/@SuperdevAcademy
Instagram: @superdevacademy — https://www.instagram.com/superdevacademy/
TikTok: @superdevacademy — https://www.tiktok.com/@superdevacademy?lang=th-TH
FAQ: คำถามที่พบบ่อยเกี่ยวกับบทความนี้
รวมคำถามและคำตอบที่ช่วยให้คุณเข้าใจเนื้อหาในบทความนี้ได้ดียิ่งขึ้น