แก้ไขปัญหา “การเชื่อมต่อซ็อกเก็ตถูกปิดโดยไม่คาดคิด” ใน Collabora Online: ตรวจสอบ WebSocket และพร็อกซี

Collabora Online อาจดูเหมือนทำงานได้ดีในแวบแรก แต่ก็อาจล้มเหลวได้ทันทีที่โปรแกรมแก้ไขพยายามสร้างการเชื่อมต่อ WebSocket แบบเรียลไทม์ อาการที่พบได้บ่อยคือ เอกสารเริ่มโหลดแล้วแจ้งว่าการเชื่อมต่อ WebSocket ปิดลงอย่างไม่คาดคิด บางครั้งอาจมีข้อความแสดงความล้มเหลวในwss://การร้องขอในเบราว์เซอร์ด้วย ในเวอร์ชัน 2026 มีเหตุผลเฉพาะเวอร์ชันหนึ่งที่ควรตรวจสอบก่อนเปลี่ยนแปลงสิ่งอื่นใด นั่นคือ เวอร์ชัน 26.04 ได้นำ URL ของ WebSocket ที่กระชับกว่ามาใช้ และกฎ reverse-proxy เก่าๆ อาจขัดแย้งกับ URL ใหม่นี้ได้

เอกสารทางการของ Collabora เกี่ยวกับ CODE 26.04 ระบุว่า CODE 26.04.1 ซึ่งเผยแพร่เมื่อวันที่ 8 มิถุนายน 2026 กำหนดให้ผู้ใช้ Apache2 reverse-proxy ต้องเปลี่ยนกฎ ProxyPass สำหรับ URL WebSocket แบบใหม่ที่มีขนาดกะทัดรัด ส่วนเอกสารในเวอร์ชัน 26.04.2.x ระบุว่า CODE สามารถกลับไปใช้ URL เดิมได้เมื่อไม่สามารถใช้เส้นทางใหม่ได้ และจะแสดงคำเตือนในการตรวจสอบที่ชี้ให้ผู้ดูแลระบบกลับไปใช้คำแนะนำเกี่ยวกับพร็อกซีในปัจจุบัน นอกจากนี้ Collabora Online เวอร์ชัน 26.04 สำหรับองค์กรก็ยังเป็นเวอร์ชันล่าสุดในปี 2026 ดังนั้นผู้ดูแลระบบควรเปรียบเทียบการกำหนดค่าพร็อกซีที่คัดลอกมาจากคู่มือเวอร์ชัน 24.04 หรือ 25.04 เก่า กับเอกสารของผู้จำหน่ายเวอร์ชันล่าสุด ก่อนที่จะสรุปว่าปัญหาดังกล่าวเป็นความผิดพลาดของเครือข่ายโดยบังเอิญ

ข้อผิดพลาดนั้นหมายความว่าอย่างไรกันแน่

ข้อความดังกล่าวไม่ได้ระบุสาเหตุหลักที่แน่ชัด หมายความว่าการเชื่อมต่อ WebSocket จากเบราว์เซอร์ไปยัง Collabora อาจไม่ได้รับการอัปเกรดอย่างสำเร็จ หรืออาจเชื่อมต่อได้แล้วแต่ถูกยกเลิกอย่างไม่คาดคิด ความแตกต่างนี้มีความสำคัญเพราะวิธีการแก้ไขแตกต่างกัน

1. ตรวจสอบว่าปัญหาเริ่มเกิดขึ้นหลังจากอัปเกรดเป็นเวอร์ชัน 26.04 หรือไม่

หากปัญหาเกิดขึ้นทันทีหลังจากอัปเกรดจากเวอร์ชัน 25.04 หรืออิมเมจ CODE เก่ากว่า ไปเป็นเวอร์ชัน 26.04 ให้พิจารณาว่าพร็อกซีแบบย้อนกลับเป็นสาเหตุแรก นี่ไม่ใช่การคาดเดา: Collabora ได้บันทึกการเปลี่ยนแปลง URL ของ WebSocket ที่กระชับขึ้นไว้ในบันทึกการเผยแพร่เวอร์ชัน 26.04 และปัญหาอย่างเป็นทางการของโครงการรายงานว่า WebSocket ล้มเหลวหลังจากอัปเกรดเป็นเวอร์ชัน 26.04.1 จนกระทั่งมีการแก้ไขกฎพร็อกซีของ Apache

อย่าแก้ปัญหานี้ด้วยการลดเวอร์ชันเวอร์ชันโดยไม่ตรวจสอบและปล่อยให้พร็อกซีเวอร์ชันเก่าไม่เปลี่ยนแปลง การย้อนกลับอาจเป็นมาตรการกู้คืนชั่วคราว แต่การแก้ไขที่ยั่งยืนคือการปรับพร็อกซีให้ตรงกับเวอร์ชันที่คุณต้องการใช้งาน สำหรับ Apache ให้ใช้การตั้งค่าพร็อกซี Collabora Online ปัจจุบัน แทนที่จะใช้เวอร์ชันก่อน 26.04 เอกสาร บันทึกปัญหา WebSocket เวอร์ชัน 26.04 ของ Collabora เอง ได้บันทึกกรณีที่การอัปเดตกฎของ Apache ช่วยให้การทำงานกลับมาเป็นปกติได้

2. พิสูจน์ว่า HTTP ทำงานได้ในขณะที่ WebSocket ล้มเหลว

ทดสอบเอนด์พอยต์ Collabora ทั่วไปก่อน:

curl -I https://office.example.com/hosting/discovery
curl -I https://office.example.com/hosting/capabilities

การตอบสนองที่สำเร็จแสดงให้เห็นว่า DNS, TLS, พร็อกซีส่วนหน้า และอย่างน้อยส่วนหนึ่งของบริการ Collabora สามารถเข้าถึงได้ แต่ไม่ได้หมายความว่าการแก้ไขเอกสารจะใช้งานได้ ตัวแก้ไขขึ้นอยู่กับเส้นทาง WebSocket ภายใต้/cool/ซึ่งมีข้อกำหนดพร็อกซีที่แตกต่างกัน

ถัดไป เปิดเครื่องมือสำหรับนักพัฒนาของเบราว์เซอร์ ทำซ้ำข้อผิดพลาด และตรวจสอบแผงเครือข่ายด้วยตัวกรอง WS การเชื่อมต่อ WebSocket ที่สำเร็จโดยปกติจะอัปเกรดการเชื่อมต่อ HTTP; RFC 6455 กำหนดให้การตอบสนองของเซิร์ฟเวอร์เป็นสถานะ HTTP 101 เมื่อการอัปเกรดสำเร็จ หากคุณเห็น 400, 404, 405, 502 หรือคำขอที่ล้มเหลวทันที ให้เชื่อมโยงเวลาดังกล่าวกับบันทึกของ reverse-proxy และ coolwsd

3. แก้ไขเส้นทางและส่วนหัวของ WebSocket ใน Nginx

สำหรับ Nginx คุณสมบัติที่สำคัญนั้นตรงไปตรงมา ได้แก่ คำขอต้องเข้าถึง/cool/พาธของ Collabora ได้ พร็อกซีต้องใช้ HTTP/1.1 สำหรับขั้นตอนการอัปเกรด WebSocket แบบคลาสสิก ต้องส่งต่อส่วนหัว UpgradeและConnectionค่าต่างๆ ต้องเก็บรักษา Host เดิมไว้ และระยะเวลาหมดเวลาในการอ่านต้องนานพอสำหรับเซสชันการแก้ไข

คู่มือ SDK ของ Collabora แสดงตำแหน่งเฉพาะสำหรับ WebSocket มานานแล้ว โดยมีUpgrade, Connection, Host, และ นอกจากนี้proxy_read_timeoutเอกสารอย่างเป็นทางการจากโครงการ Collabora ยังระบุถึงความจำเป็นในการใช้ส่วนหัว WebSocket ใน/coolเส้นทางที่กว้างขึ้นด้วย รูปแบบที่เหมาะสมกับเวอร์ชัน 26.04 คือ:

location ^~ /cool/ {
    proxy_pass http://127.0.0.1:9980;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $http_host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 3600s;
}

อย่าคัดลอกโค้ดนี้ไปวางทับการตั้งค่าระบบที่ใช้งานได้อยู่แล้วโดยไม่ปรับที่อยู่ต้นทาง รูปแบบ TLS การจัดการเส้นทาง และการควบคุมความปลอดภัยที่มีอยู่เดิม ทางเลือกที่ถูกต้องคือการรักษารูปแบบโครงสร้างระบบเดิมไว้ ในขณะเดียวกันก็ต้องให้ตรงกับข้อกำหนดเส้นทางและส่วนหัวของ Collabora ในปัจจุบันด้วย

เหตุใดค่าหมดเวลาจึงมีความสำคัญ

เซสชันการแก้ไขผ่าน WebSocket มีอายุการใช้งานยาวนาน ค่า Helm ปัจจุบันของโครงการ Collabora อธิบายเรื่องนี้ไว้อย่างชัดเจนและใช้ค่าหมดเวลาพร็อกซีที่สูงสำหรับพร็อกซี Nginx ที่รวมมาด้วย หากโหลดบาลานเซอร์ปลายทาง, Kubernetes ingress, CDN, ไฟร์วอลล์ หรือรีเวิร์สพร็อกซีปิดการเชื่อมต่อที่ไม่ได้ใช้งานเร็วกว่าที่แอปพลิเคชันคาดไว้ ผู้ใช้จะสามารถแก้ไขได้ตามปกติชั่วขณะหนึ่งแล้วจะถูกตัดการเชื่อมต่อเป็นระยะๆ

เมื่อความล้มเหลวเกิดขึ้นหลังจากผ่านไปประมาณเวลาไม่กี่วินาทีทุกครั้ง ให้ตรวจสอบตัวกลางทุกตัวในเส้นทางแทนที่จะเพิ่มค่าหมดเวลาของ Nginx เพียงอย่างเดียว ค่าหมดเวลาที่สั้นที่สุดจะเป็นค่าที่ใช้ได้ผล

4. ทำให้การยุติการเชื่อมต่อ TLS มีความสม่ำเสมอ

การใช้งานทั่วไปมักจะยุติการเชื่อมต่อ HTTPS ที่ Nginx, Apache, HAProxy, Traefik หรือตัวควบคุมการเข้าถึง (ingress controller) แล้วส่งต่อ HTTP ธรรมดาไปยัง Collabora บนพอร์ต 9980 ในการออกแบบนี้ การกำหนดค่าอย่างเป็นทางการของ Collabora กำหนดให้แบ็กเอนด์ต้องทราบว่า TLS ถูกยุติโดยพร็อกซีแล้ว เอกสารคู่มือ SDK อธิบาย รูปแบบนี้ssl.enable=falseไว้ด้วยเช่นกันssl.termination=true

สำหรับการใช้งาน Docker นั้น โดยทั่วไปจะแสดงออกมาผ่านพารามิเตอร์เพิ่มเติมของ Collabora ดังนี้:

--o:ssl.enable=false --o:ssl.termination=true

ใช้การตั้งค่าเหล่านี้เฉพาะเมื่อ TLS ถูกยกเลิกอย่างถูกต้องที่ต้นทางเท่านั้น หากพร็อกซีเชื่อมต่อกับ Collabora ผ่าน HTTPS แทน ให้กำหนดค่าโทโพโลยีนั้นให้สอดคล้องกัน แทนที่จะผสมผสานทั้งสองแบบ การไม่ตรงกันอาจทำให้เกิดรูปแบบที่ไม่ถูกต้อง URL WebSocket ที่ไม่ถูกต้อง ความล้มเหลวของใบรับรอง หรือการเปลี่ยนเส้นทางที่ทำให้การอัปเกรดล้มเหลว

5. ตรวจสอบความไม่ตรงกันของ Host และ Origin ในบันทึกของ coolwsd

Collabora ตรวจสอบความถูกต้องของแหล่งที่มาของ WebSocket หากในบันทึกมีข้อความเช่นRejecting WebSocket upgradeตามด้วยแหล่งที่มาและโฮสต์ที่คาดหวัง ให้แก้ไขความสัมพันธ์ระหว่างชื่อโฮสต์/พอร์ตภายนอกแทนที่จะเพิ่มส่วนหัวที่อนุญาตแบบสุ่ม ตัวติดตามปัญหาอย่างเป็นทางการของ Collabora มีตัวอย่างที่บันทึกไว้ซึ่งชื่อเซิร์ฟเวอร์ที่กำหนดค่าไว้รวมถึง:443ไม่ตรงกับแหล่งที่มาของเบราว์เซอร์หากไม่มีพอร์ตที่ระบุอย่างชัดเจน

คำสั่งที่มีประโยชน์จะขึ้นอยู่กับการติดตั้งของคุณ:

docker logs collabora --tail 200
journalctl -u coolwsd --since "10 minutes ago"
nginx -t
apachectl configtest

ให้มองหาข้อผิดพลาดแรกที่เกิดขึ้นพร้อมๆ กับการร้องขอ WS ที่ล้มเหลว ข้อความเกี่ยวกับการอัปเกรดที่ถูกปฏิเสธ ไวยากรณ์ URI ที่ไม่ถูกต้อง โฮสต์ที่ไม่คาดคิด หรืออัปสตรีมที่ไม่พร้อมใช้งาน จะมีประโยชน์ในการดำเนินการมากกว่าข้อความป๊อปอัพทั่วไปของเบราว์เซอร์

6. หากพบปัญหาเฉพาะในเบราว์เซอร์ที่ใช้ Chromium เท่านั้น ให้ตรวจสอบการจัดการ HTTP/2 หรือ HTTP/3

นี่เป็นกรณีที่เฉพาะเจาะจงกว่า แต่ก็คุ้มค่าที่จะตรวจสอบก่อนที่จะสร้างเซิร์ฟเวอร์ใหม่ โครงการ Collabora ได้บันทึกกรณีที่เกี่ยวข้องกับ Chromium ซึ่งพร็อกซีส่งคำขอ HTTP/2 CONNECT WebSocket ไปยัง coolwsd โดยตรงและได้รับข้อผิดพลาด 405 Method Not Allowed อีกปัญหาหนึ่งบันทึกความล้มเหลวในการโหลดเอกสารที่เกี่ยวข้องกับ HTTP/3/QUIC ในเส้นทางพร็อกซีเฉพาะ รายงานเหล่านี้ไม่ได้หมายความว่า HTTP/2 หรือ HTTP/3 จะต้องถูกปิดใช้งานเสมอไป แต่หมายความว่าตัวกลางจะต้องแปลงพฤติกรรมของไคลเอ็นต์ให้เป็นการเชื่อมต่อ WebSocket ที่ Collabora รองรับ

หาก Firefox ใช้งานได้ในขณะที่ Chrome ใช้งานไม่ได้ในบัญชีและเอกสารเดียวกัน ให้บันทึกโปรโตคอลและรหัสสถานะที่พร็อกซี ควรแก้ไขพฤติกรรมของพร็อกซี/ขาเข้ามากกว่าการปิดใช้งานโปรโตคอลสมัยใหม่ทั่วโลก เว้นแต่สภาพแวดล้อมของคุณไม่มีทางเลือกอื่นที่เข้ากันได้

7. เริ่มการทำงานใหม่หลังจากตรวจสอบความถูกต้องของการตั้งค่าเรียบร้อยแล้วเท่านั้น

ตรวจสอบไวยากรณ์ของพร็อกซีก่อน จากนั้นจึงโหลดใหม่แทนที่จะรีสตาร์ทซ้ำ ๆ โดยไม่ตรวจสอบอะไรเลย:

sudo nginx -t && sudo systemctl reload nginx
sudo apachectl configtest && sudo systemctl reload apache2

สำหรับคอนเทนเนอร์ ให้รีสตาร์ทบริการ Collabora เฉพาะเมื่อคุณเปลี่ยนแปลงสภาพแวดล้อมหรือcoolwsdการตั้งค่าของบริการนั้นเองเท่านั้น การเปลี่ยนแปลงเฉพาะพร็อกซีโดยปกติแล้วจะต้องรีสตาร์ทพร็อกซีเท่านั้น

วิธีตรวจสอบการแก้ไขด้วยตนเอง

ควรใช้ลำดับการตรวจสอบที่สั้นกว่า แทนที่จะพึ่งพาการเปิดเอกสารสำเร็จเพียงครั้งเดียว:

• ยืนยัน/hosting/discoveryว่า/hosting/capabilitiesสามารถเข้าถึงได้ผ่านชื่อโฮสต์สาธารณะเดียวกันที่ผู้ใช้เข้าถึงได้
• เปิดเอกสารและตรวจสอบว่าการอัปเกรดคำขอ WS ของเบราว์เซอร์สำเร็จหรือไม่ แทนที่จะแสดงข้อผิดพลาด 4xx/5xx
• พิมพ์ข้อความแก้ไขหลายๆ ครั้ง รอเป็นเวลานานกว่าช่วงเวลาที่เคยเกิดข้อผิดพลาด และตรวจสอบให้แน่ใจว่าการเชื่อมต่อยังคงเสถียร
• บันทึกและปิดเอกสาร จากนั้นเปิดเอกสารอีกครั้งเพื่อตรวจสอบว่าการรับส่งข้อมูล WOPI ไป-กลับเป็นไปอย่างราบรื่น
• ตรวจสอบบันทึก coolwsd และ proxy เพื่อหาการอัปเกรด WebSocket ที่ถูกปฏิเสธ ข้อผิดพลาดในการแยกวิเคราะห์ URI หรือการวนลูปการเชื่อมต่อซ้ำๆ
• หากระบบของคุณมี Load Balancer หรือ Ingress ให้ทำการทดสอบซ้ำโดยใช้เส้นทาง Production จริงแทนการเชื่อมต่อโดยตรงกับพอร์ต 9980

คุณควรเลือกวิธีแก้ไขแบบไหนดี?

หากคุณอัปเกรดเป็นเวอร์ชัน 26.04 และใช้ Apache การอัปเดตกฎพร็อกซีเป็นสิ่งที่ควรดำเนินการเป็นอันดับแรก เนื่องจาก Collabora ได้ระบุการเปลี่ยนแปลงนี้ไว้อย่างชัดเจน หากการตัดการเชื่อมต่อเกิดขึ้นหลังจากช่วงเวลาที่กำหนด ให้ตรวจสอบการตั้งค่าหมดเวลาในทุกจุดเชื่อมต่อเครือข่าย หากความล้มเหลวเกิดขึ้นทันทีในทุกเบราว์เซอร์ ให้ตรวจสอบ/cool/การกำหนดเส้นทาง ส่วนหัวการอัปเกรด ความสอดคล้องของโฮสต์/ต้นทาง และการยุติ TLS หากมีเพียงตระกูลเบราว์เซอร์เดียวที่ล้มเหลว ให้เปรียบเทียบการจัดการโปรโตคอล HTTP ก่อนที่จะเปลี่ยนแปลง Collabora เอง

ประเด็นสำคัญคือต้องหลีกเลี่ยงการตีความข้อความ “การเชื่อมต่อซ็อกเก็ตถูกปิดโดยไม่คาดคิด” ว่าเป็นการทำงานผิดพลาดของแอปพลิเคชัน Collabora โดยค่าเริ่มต้น ในการใช้งานจริงหลายๆ ครั้ง ตัวแก้ไข จุดเชื่อมต่อการค้นหา และโฮสต์ WOPI อาจทำงานได้ปกติ แต่พร็อกซีแบบย้อนกลับอาจจัดการการเชื่อมต่อประเภทเดียวที่สำคัญที่สุดสำหรับการแก้ไขแบบเรียลไทม์อย่างไม่ถูกต้อง นั่นคือ WebSocket ที่ใช้งานได้นาน

เอกสารอ้างอิงอย่างเป็นทางการ

• บันทึกการเปลี่ยนแปลงของ Collabora CODE เวอร์ชัน 26.04
• บันทึกการเปลี่ยนแปลงของ Collabora Online เวอร์ชัน 26.04
• การตั้งค่าพร็อกซีของ Collabora Online SDK
• ปัญหา CollaboraOnline/ออนไลน์ #15918: ความล้มเหลวของ WebSocket หลังจากการอัปเกรดเป็นเวอร์ชัน 26.04
• ปัญหา CollaboraOnline/online #13751: ส่วนหัว WebSocket ในเอกสารพร็อกซี
• ค่าเริ่มต้นการหมดเวลาของพร็อกซี Helm ใน Collabora Online
• RFC 6455: โปรโตคอล WebSocket