เมื่อระบบเสียงในห้องประชุมย่อยของ BigBlueButton เชื่อมต่อไม่ได้ คำถามแรกที่สำคัญที่สุดไม่ใช่ “ฉันควรรีสตาร์ทบริการใด” แต่เป็น “เสียงล้มเหลวเฉพาะหลังจากเข้าห้องประชุมย่อย หรือล้มเหลวในระหว่างการประชุมหลักด้วย” การแยกแยะความแตกต่างนี้จะช่วยแยกปัญหาการเปลี่ยนห้องออกจากปัญหาที่เกิดจากเบราว์เซอร์ เครือข่าย หรือเซิร์ฟเวอร์มีเดียในวงกว้างได้อย่างรวดเร็ว
คู่มือนี้เขียนขึ้นสำหรับ BigBlueButton 3.0 ซึ่งยังคงเป็นเอกสารเวอร์ชันเสถียร ณ เดือนตุลาคม 2026 ส่วน BigBlueButton 4.0 ยังคงอยู่ในระหว่างการพัฒนา BigBlueButton 3.0 สามารถใช้ตัวเชื่อมต่อเสียงได้หลายแบบ รวมถึงbbb-webrtc-sfu, livekit, และfreeswitchผ่านทาง API การประชุม ดังนั้นควรหลีกเลี่ยงการสันนิษฐานว่าทุกการติดตั้งใช้งานจะมีเส้นทางสื่อเหมือนกัน เอกสาร อ้างอิง API อย่างเป็นทางการของ BigBlueButton จะอธิบายตัวเลือกตัวเชื่อมต่อเหล่านั้น ในขณะที่คู่มือการแก้ไขปัญหาของ BigBlueButtonยังคงเป็นจุดเริ่มต้นที่ดีที่สุดสำหรับการตรวจสอบฝั่งเซิร์ฟเวอร์
วิธีแก้ไขที่ดีควรเป็นอย่างไร
ผลลัพธ์ที่ประสบความสำเร็จนั้นไม่ใช่แค่การเห็นไอคอนไมโครโฟนเปลี่ยนเป็นสีเขียวเท่านั้น หลังจากแก้ไขแล้ว ผู้เข้าร่วมควรจะสามารถเข้าห้องย่อย เข้าร่วมเสียงภายในไม่กี่วินาที ได้ยินเสียงผู้เข้าร่วมคนอื่น พูดและได้ยินเสียง ปิดและเปิดเสียงได้ตามปกติ และกลับไปยังห้องหลักได้โดยไม่ติดอยู่ในวงวนการเชื่อมต่อใหม่ หากมีเพียงเบราว์เซอร์หรือเครือข่ายเดียวที่ยังคงล้มเหลวหลังจากที่คนอื่น ๆ ประสบความสำเร็จแล้ว ให้หยุดการเปลี่ยนแปลงเซิร์ฟเวอร์และมุ่งเน้นไปที่สภาพแวดล้อมไคลเอ็นต์นั้น
| การสังเกต | พื้นที่ที่มีแนวโน้มมากที่สุด | การเคลื่อนไหวครั้งต่อไป |
| ทั้งระบบเสียงในห้องหลักและห้องแยกใช้งานไม่ได้ | การอนุญาตของเบราว์เซอร์ อุปกรณ์ ไฟร์วอลล์ TURN หรือมีเดียบริดจ์ | เริ่มจากขั้นตอนที่ 1–4 |
| ห้องหลักใช้งานได้ แต่ห้องย่อยค้างอยู่ที่สถานะ "กำลังเชื่อมต่อ" | การเปลี่ยนห้อง, สถานะไคลเอ็นต์ค้าง, ปัญหาเฉพาะของบริดจ์ | เริ่มจากขั้นตอนที่ 1, 2 และ 5 |
| มีเพียงผู้ใช้ที่อยู่ในสำนักงาน โรงเรียน หรือเครือข่าย VPN เดียวกันเท่านั้นที่ประสบปัญหานี้ | การกรองเครือข่ายหรือเส้นทาง ICE/TURN | ให้ความสำคัญกับขั้นตอนที่ 4 |
| ผู้ใช้จำนวนมากทำไม่สำเร็จพร้อมกัน | การกำหนดค่าเซิร์ฟเวอร์หรือเครือข่าย | ให้ความสำคัญกับขั้นตอนที่ 3–5 |
ขั้นตอนที่ 1: จำลองปัญหาให้ชัดเจน
ก่อนที่จะเปลี่ยนแปลงการตั้งค่า ให้ลองจำลองปัญหาโดยใช้ผู้ดูแลหนึ่งคนและผู้เข้าร่วมหนึ่งคน ตรวจสอบให้แน่ใจว่าผู้เข้าร่วมสามารถเข้าร่วมเสียงในห้องหลักได้ จากนั้นย้ายผู้เข้าร่วมคนนั้นไปยังห้องย่อยและสังเกตสิ่งที่เกิดขึ้นอย่างละเอียด “กำลังเชื่อมต่อเสียง…” ที่ไม่เสร็จสมบูรณ์นั้นแตกต่างจากการปฏิเสธการอนุญาตของเบราว์เซอร์ อุปกรณ์ไมโครโฟนหายไป หรือเสียงที่เชื่อมต่อแล้วแต่ไม่มีเสียง
ข้อสังเกตแรกที่สำคัญคือ ห้องประชุมย่อยเกิดปัญหาขัดข้องระหว่างการเชื่อมต่อเสียง หรือล้มเหลวก่อนหน้านั้นเนื่องจากปัญหาเกี่ยวกับอุปกรณ์หรือสิทธิ์การเข้าถึงหรือไม่
หากห้องหลักใช้งานได้ แต่ห้องย่อยใช้งานไม่ได้ ให้ลองออกจากห้องย่อย กลับไปยังห้องหลัก แล้วเข้าห้องย่อยอีกครั้ง การเข้าร่วมใหม่ที่ถูกต้องอาจช่วยแก้ไขสถานะค้างของไคลเอ็นต์ได้ หากปัญหายังคงเกิดขึ้นซ้ำๆ ให้ตรวจสอบตามขั้นตอนด้านล่างแทนการรีเฟรชหน้าเว็บซ้ำๆ
ตรวจสอบความสำเร็จ:ผู้เข้าร่วมเข้าร่วมกลุ่มสนทนาเสียงย่อยหนึ่งครั้ง ออกจากกลุ่ม แล้วเข้าร่วมใหม่ และได้ยินเสียงอีกครั้ง หากทำได้เช่นนี้อย่างสม่ำเสมอ ปัญหาอาจเป็นเพียงชั่วคราว หากการเปลี่ยนผ่านแบบเดียวกันล้มเหลวทุกครั้ง ให้ดำเนินการต่อไป
ขั้นตอนที่ 2: ตรวจสอบสิทธิ์การเข้าถึงไมโครโฟนของเบราว์เซอร์และอุปกรณ์ที่เลือก
ระบบเสียงของ BigBlueButton ใช้ WebRTC ผ่านเว็บเบราว์เซอร์ ดังนั้น การปฏิเสธการอนุญาตไมโครโฟนอาจดูเหมือนเป็นปัญหาเฉพาะของห้องสนทนาขนาดเล็ก หากผู้ใช้สังเกตเห็นหลังจากเข้าไปในห้องนั้นแล้ว ให้เปิดการอนุญาตเว็บไซต์ของเบราว์เซอร์สำหรับชื่อโฮสต์ BigBlueButton และตรวจสอบให้แน่ใจว่าอนุญาตให้เข้าถึงไมโครโฟนแล้ว จากนั้นยืนยันว่าได้เลือกไมโครโฟนที่ต้องการแล้ว และไม่มีแอปพลิเคชันอื่นกำลังใช้งานไมโครโฟนอยู่
โปรดตรวจสอบให้แน่ใจว่าสามารถเข้าถึงไมโครโฟนของเว็บไซต์ BigBlueButton ได้ก่อนที่จะสรุปว่าปัญหาเกิดจากฝั่งเซิร์ฟเวอร์ของห้องสนทนา (breakout room)
ทดสอบด้วย Firefox เวอร์ชันปัจจุบัน หรือเบราว์เซอร์ที่ใช้ Chromium หากผู้เข้าร่วมสามารถจำลองข้อผิดพลาดเดียวกันได้ในเบราว์เซอร์สองตัวที่เป็นเวอร์ชันปัจจุบัน แสดงว่าปัญหาอาจเกิดจากโปรไฟล์เบราว์เซอร์เอง หากเบราว์เซอร์ตัวหนึ่งใช้งานได้และอีกตัวใช้งานไม่ได้บนเครื่องและเครือข่ายเดียวกัน ให้รีเซ็ตสิทธิ์การเข้าถึงหรือทดสอบด้วยโปรไฟล์เบราว์เซอร์ที่สะอาดก่อนที่จะแก้ไขการตั้งค่า BigBlueButton
ตรวจสอบความสำเร็จ:ตัวบ่งชี้การทำงานของไมโครโฟนตอบสนอง เสียงเข้าร่วมในห้องหลัก และเบราว์เซอร์เดียวกันสามารถเข้าร่วมเสียงในห้องย่อยได้ หากห้องหลักยังคงล้มเหลว แสดงว่าห้องย่อยไม่ใช่สาเหตุที่แท้จริง
ขั้นตอนที่ 3: ตรวจสอบ BigBlueButton ก่อนที่จะรีสตาร์ทอะไรก็ตาม
บนเซิร์ฟเวอร์ ให้รันsudo bbb-conf --checkคำสั่งนี้ เอกสารของ BigBlueButton เองแนะนำให้ใช้เป็นขั้นตอนแรกในการตรวจสอบฝั่งเซิร์ฟเวอร์ เพราะจะตรวจสอบว่าส่วนประกอบหลักเริ่มต้นทำงานอย่างถูกต้องหรือไม่ และแสดงปัญหาการกำหนดค่าทั่วไป ตรวจสอบสิ่งต่างๆ ที่แสดงอยู่ภายใต้หัวข้อ “ปัญหาที่อาจเกิดขึ้น” แทนที่จะรีสตาร์ททุกบริการทันที
นอกจากนี้ ให้เรียกใช้งานsudo bbb-conf --statusและตรวจสอบบริการ systemd ที่เกี่ยวข้องสำหรับระบบเสียงของคุณ ด้วย bbb-webrtc-sfuโดยทั่วไปแล้ว การใช้งาน BigBlueButton 3.0 จะใช้ระบบเสียงพื้นฐาน ในขณะที่ LiveKit สามารถเปิดใช้งานได้ต่อการประชุมหรือทั้งเซิร์ฟเวอร์ หากการผสานรวมของคุณผ่านแล้วaudioBridge=livekitให้แก้ไขปัญหา LiveKit แทนที่จะสันนิษฐานว่าเส้นทาง FreeSWITCH แบบเดิมกำลังส่งเสียงจากเบราว์เซอร์อยู่
เอกสาร อย่างเป็นทางการเกี่ยวกับไฟล์การกำหนดค่าแนะนำให้วางการแทนที่เฉพาะที่ไว้ใน เพื่อ/etc/bigbluebuttonป้องกันไม่ให้การอัปเกรดแพ็กเกจเขียนทับค่าเหล่านั้น
ตรวจสอบความสำเร็จ: bbb-conf --checkไม่พบข้อผิดพลาดที่ไม่สามารถอธิบายได้ บริการเชื่อมต่อเสียงทำงานอยู่ และการประชุมทดสอบใหม่ทำงานได้อย่างสม่ำเสมอ หากสถานะการบริการดี แต่เครือข่ายหนึ่งยังคงล้มเหลว ให้ตรวจสอบ ICE, NAT และ TURN ต่อไป
ขั้นตอนที่ 4: วินิจฉัยปัญหา ICE, NAT, ไฟร์วอลล์ และ TURN
WebRTC ต้องสร้างเส้นทางสื่อที่ใช้งานได้ระหว่างเบราว์เซอร์และโครงสร้างพื้นฐานสื่อของ BigBlueButton หากการส่งสัญญาณสำเร็จ แต่สื่อไม่สามารถหาเส้นทางเครือข่ายที่ใช้งานได้ ผู้ใช้อาจพบความล้มเหลวในการเจรจา ICE หรือติดขัดขณะเข้าร่วมเสียง เอกสารไฟร์วอลล์ของ BigBlueButton ชี้ให้เห็นโดยเฉพาะว่าการประกาศ IP ภายนอกที่ไม่ถูกต้องและการบล็อก UDP เป็นสาเหตุทั่วไป
คำสั่ง `about:webrtc` ใน Firefox สามารถแสดงได้ว่าการเจรจา ICE เสร็จสมบูรณ์หรือไม่ และเบราว์เซอร์ได้รับโฮสต์ที่ใช้งานได้หรือไม่ ไม่ว่าจะเป็นแบบ server-reflexive หรือ relay candidate
ใน Firefox ฟังก์ชันabout:webrtcนี้มีประโยชน์เพราะแสดง ICE candidate และสถานะการเชื่อมต่อ หากคุณเห็นเซิร์ฟเวอร์ประกาศที่อยู่ภายในในขณะที่คาดหวังที่อยู่ภายใน ให้ตรวจสอบการตั้งค่า NAT และ announced-IP คู่มือการตั้งค่าไฟร์วอลล์ ของ BigBlueButton อธิบายวิธีการที่ mediasoup ควรประกาศที่อยู่สาธารณะเมื่อเซิร์ฟเวอร์อยู่หลัง NAT
หากพบปัญหาการทำงานผิดพลาดในเครือข่ายที่มีข้อจำกัดสูง เช่น เครือข่ายขององค์กร โรงเรียน โรงแรม หรือ VPN ให้ตั้งค่าเซิร์ฟเวอร์ TURN เอกสารการติดตั้งของ BigBlueButton แนะนำให้ใช้ TURN สำหรับผู้ใช้ที่อยู่หลังไฟร์วอลล์ที่มีข้อจำกัด การตรวจสอบที่ได้ผลดีคือการทดสอบผู้ใช้คนเดียวกันบนเครือข่ายอื่น เช่น ฮอตสปอตของโทรศัพท์ หากฮอตสปอตใช้งานได้ แต่เครือข่ายที่จัดการอยู่ล้มเหลว นั่นเป็นหลักฐานที่ชัดเจนว่าเส้นทางเครือข่ายต่างหากที่เป็นปัจจัยจำกัด ไม่ใช่ตรรกะของห้องประชุมย่อย
อย่าเปิดพอร์ตช่วงกว้างๆ ที่คัดลอกมาจากกระทู้เก่าๆ ในฟอรัมโดยไม่ตรวจสอบให้ดี ให้ใช้พอร์ตและบริดจ์ที่เหมาะสมกับเวอร์ชัน BigBlueButton ที่ติดตั้งและโครงสร้างการใช้งานของคุณ คำแนะนำเก่าๆ ที่เกี่ยวกับ FreeSWITCH หรือ SIP.js อาจใช้ไม่ได้กับการติดตั้งเวอร์ชัน 3.0 ในปัจจุบัน
ตรวจสอบความสำเร็จ: ICE เข้าสู่สถานะเชื่อมต่อแล้ว ปรากฏเซิร์ฟเวอร์สาธารณะหรือเซิร์ฟเวอร์รีเลย์ที่คาดหวัง และผู้ใช้ที่ได้รับผลกระทบคนเดิมสามารถเข้าร่วมการสนทนาเสียงจากเครือข่ายที่ก่อนหน้านี้ล้มเหลวได้ หากผู้ใช้ยังคงล้มเหลวในขณะที่ผู้ใช้รายอื่นในเครือข่ายเดียวกันประสบความสำเร็จ ให้กลับไปตรวจสอบอุปกรณ์/เบราว์เซอร์อีกครั้ง
ขั้นตอนที่ 5: เปรียบเทียบการตั้งค่าระบบเสียงและทดสอบการเปลี่ยนผ่านระหว่างห้องอีกครั้ง
หากเสียงในห้องหลักใช้งานได้ แต่เสียงในห้องย่อยล้มเหลวอย่างต่อเนื่องสำหรับผู้ใช้หลายคน ให้ตรวจสอบว่าการประชุมนั้นใช้บริดจ์เสียงใด BigBlueButton 3.0 มีaudioBridgeพารามิเตอร์ create ที่มีค่าที่ถูกต้อง ได้แก่bbb-webrtc-sfu, livekit, และfreeswitchการผสานรวมอาจแทนที่ค่าเริ่มต้นของเซิร์ฟเวอร์ต่อการประชุม ดังนั้นการกำหนดค่าที่คุณตรวจสอบอาจไม่ตรงกับบริดจ์ที่ใช้โดยเซสชันที่ล้มเหลว
สร้างการประชุมทดสอบใหม่โดยไม่ต้องกำหนดค่าเฉพาะสำหรับการประชุมแต่ละครั้ง จากนั้นทำซ้ำลำดับการประชุมหลัก → ห้องย่อย → ห้องหลัก หากการประชุมที่สร้างใหม่ทำงานได้ แต่การประชุมที่สร้างโดย LMS หรือแอปพลิเคชันที่กำหนดเองของคุณล้มเหลว ให้ตรวจสอบพารามิเตอร์ API ที่ส่งโดยการผสานรวมนั้น หากทั้งสองอย่างล้มเหลว ปัญหาอาจอยู่ที่การกำหนดค่าสื่อของเซิร์ฟเวอร์หรือข้อบกพร่องเฉพาะเวอร์ชัน
หลังจากแก้ไขเสร็จแล้ว ให้ตรวจสอบผลลัพธ์กับผู้เข้าร่วมอย่างน้อยสองคนในห้องย่อยเดียวกัน เพื่อทดสอบทั้งการส่งและรับเสียง
หลังจากเปลี่ยนแปลงการตั้งค่าแล้ว ให้รีสตาร์ท BigBlueButton เฉพาะเมื่อจำเป็นเท่านั้น โดยใช้คำสั่ง `start` sudo bbb-conf --restartจากนั้นเรียกใช้งานsudo bbb-conf --checkอีกครั้ง หลีกเลี่ยงการเปลี่ยนแปลงหลายอย่างพร้อมกันก่อนทดสอบ การเปลี่ยนแปลงทีละอย่างจะช่วยให้ระบุได้ว่าการปรับเปลี่ยนใดแก้ไขปัญหาได้อย่างแท้จริง
ตรวจสอบความสำเร็จ:ผู้เข้าร่วมสองคนสามารถพูดคุยกันได้ในห้องย่อย กลับไปยังห้องหลัก และกลับเข้าไปในห้องย่อยได้โดยไม่มีปัญหาการเชื่อมต่อค้าง ทำซ้ำขั้นตอนนี้จากเครือข่ายภายนอกอย่างน้อยหนึ่งเครือข่ายก่อนที่จะพิจารณาว่าปัญหาได้รับการแก้ไขแล้ว
เมื่อใดควรเปลี่ยนวิธีการ
หากปัญหายังคงอยู่หลังจากตรวจสอบสิทธิ์ของเบราว์เซอร์ สุขภาพของเซิร์ฟเวอร์ ICE/TURN และการเลือกบริดจ์แล้ว ให้รวบรวมหลักฐานแทนที่จะคาดเดาต่อไป บันทึกเวอร์ชันของ BigBlueButton เวอร์ชันของเบราว์เซอร์และระบบปฏิบัติการ ว่าปัญหาเกิดขึ้นซ้ำในเดโม BigBlueButton สาธารณะหรือไม่ ผลลัพธ์ของ การตั้งค่าบริดจ์เสียงของการประชุม และการวินิจฉัย WebRTC ของเบราว์เซอร์ที่เกี่ยวข้อง คู่มือการขอความช่วยเหลือsudo bbb-conf --checkของ BigBlueButton ขอข้อมูลเครือข่ายและสภาพแวดล้อมประเภทนี้อย่างชัดเจนเมื่อแก้ไขปัญหาความล้มเหลวของเสียงหรือวิดีโอ
ณ เดือนตุลาคม 2026 เอกสารประกอบการใช้งาน BigBlueButton 3.0 ยังคงเป็นเวอร์ชันที่เสถียร โดยยังคงมีการเผยแพร่เวอร์ชัน 3.0 บน GitHub อย่างต่อเนื่อง ในขณะที่เอกสารประกอบการใช้งานเวอร์ชัน 4.0 อยู่ในระหว่างการพัฒนา เรื่องนี้สำคัญเพราะ BigBlueButton 4.0 เปลี่ยนเฟรมเวิร์กสื่อเริ่มต้นเป็น LiveKit ดังนั้นคำแนะนำเฉพาะสำหรับเวอร์ชัน 4.0 จึงไม่ควรนำไปใช้กับเซิร์ฟเวอร์เวอร์ชัน 3.0 โดยอัตโนมัติ โปรดตรวจสอบหน้ารายละเอียดการเผยแพร่ BigBlueButton อย่างเป็นทางการก่อนปฏิบัติตามคำแนะนำที่เกี่ยวข้องกับเวอร์ชัน
รายการตรวจสอบการยืนยันขั้นสุดท้าย
- ระบบเสียงหลักเชื่อมต่อสำหรับผู้เข้าร่วมที่ได้รับผลกระทบ
- อนุญาตการเข้าถึงไมโครโฟนแล้ว และอุปกรณ์ที่ต้องการใช้งานแสดงกิจกรรมการป้อนข้อมูล
bbb-conf --checkไม่มีข้อผิดพลาดในการให้บริการสื่อที่ไม่สามารถอธิบายได้
- ICE เข้าสู่สถานะเชื่อมต่อแล้ว เครือข่ายที่มีข้อจำกัดจะมีเส้นทาง TURN ที่ใช้งานได้เมื่อจำเป็น
- การประชุมนี้ใช้ระบบเชื่อมต่อเสียงอย่างที่คุณคิดนั่นแหละ
- ผู้ใช้งานสองคนสามารถได้ยินเสียงกันและกันในห้องย่อย จากนั้นกลับไปยังห้องหลักและเข้าร่วมได้อย่างสำเร็จ
หากการตรวจสอบทั้งหกข้อผ่านอย่างต่อเนื่อง การซ่อมแซมก็จะให้ผลลัพธ์ที่สำคัญ นั่นคือ เสียงที่เสถียรระหว่างการเปลี่ยนห้อง ไม่ใช่เพียงแค่ไอคอนไมโครโฟนสีเขียวชั่วคราวเท่านั้น