ติดตามเอกสาร Collabora ว่างเปล่าไปยังเลเยอร์ที่ล้มเหลว

เริ่มต้นด้วยการตรวจสอบว่าหน้าจอว่างเปล่าเกิดขึ้นกับไฟล์เดียวหรือทุกไฟล์ จากนั้นตรวจสอบแผงเครือข่ายและคอนโซลของเบราว์เซอร์ควบคู่ไปกับบันทึกของ Collabora และแพลตฟอร์มจัดเก็บข้อมูล หน้าจอว่างเปล่าเป็นเพียงอาการ ไม่ใช่การวินิจฉัยปัญหา: โปรแกรมแก้ไขอาจโหลดขึ้นมาในขณะที่การเชื่อมต่อเอกสาร การอนุญาต WOPI หรือทรัพยากรที่ฝังอยู่ล้มเหลว

1. พิจารณาว่าปัญหาเกิดจากไฟล์ เบราว์เซอร์ หรือบริการ

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

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

2. ค้นหาคำขอที่ล้มเหลวก่อนที่จะเปลี่ยนการตั้งค่า

ใน Chrome หรือ Chromium ให้เปิดเครื่องมือสำหรับนักพัฒนา ( F12หรือCtrl+Shift+I ) เลือกเครือข่ายเปิดใช้งานบันทึกข้อมูล (Preserve log ) แล้วรีโหลดหน้าเว็บ กรองหาWS (WebSocket) และตรวจสอบข้อผิดพลาดคู่มืออ้างอิงเครือข่ายของ Chrome DevToolsจะอธิบายตัวกรองคำขอและรายละเอียดสถานะ ตรวจสอบคอนโซลเพื่อหาข้อผิดพลาด CSP ใบรับรอง เนื้อหาผสม หรือ JavaScript

ควรวิเคราะห์หลักฐานมากกว่าที่จะใช้สูตรสำเร็จรูปทั่วไป:

• ข้อผิดพลาด 404 สำหรับไฟล์หรือ/browser/พาธของตัวแก้ไข:ตรวจสอบว่าพร็อกซีแบบย้อนกลับส่งต่อพาธ Collabora ปัจจุบันไปยังเซิร์ฟเวอร์ต้นทางที่ถูกต้องหรือไม่
• หากพบข้อผิดพลาด 502, หมดเวลา หรือ WebSocket ปิดตัวลงทันที ให้ตรวจสอบการเข้าถึงเซิร์ฟเวอร์ต้นทาง บันทึกพร็อกซี การจัดการ WebSocket และเส้นทางการร้องขอ การที่ปลายทางสามารถเข้าถึงได้/hosting/discoveryนั้นแสดงให้เห็นเพียงการเข้าถึง HTTP ขั้นพื้นฐานเท่านั้น ไม่ได้หมายความว่าการเชื่อมต่อแบบเรียลไทม์ของโปรแกรมแก้ไขข้อความนั้นใช้งานได้
• หากพบข้อผิดพลาด 403 หรือ “Unauthorized WOPI host” ในบันทึก:โปรดตรวจสอบโฮสต์จัดเก็บข้อมูลที่ระบุใน URL ของ WOPI ว่าตรงกับโฮสต์ WOPI ที่ Collabora อนุญาตหรือไม่
• ข้อผิดพลาด CSP หรือใบรับรอง:แก้ไขต้นทางการฝังข้อมูลหรือห่วงโซ่ใบรับรองให้ถูกต้อง อย่าปิดใช้งานความปลอดภัยของเบราว์เซอร์หรือผ่อนปรน Content Security Policy อย่างกว้างขวางเพื่อให้หน้าจอโหลดได้

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

3. เลือกวิธีการแก้ไขให้ตรงกับชั้นที่เกิดปัญหา

ตรวจสอบทั้งสองทิศทางและรูปแบบ URL

คำแนะนำการแก้ไขปัญหาในสำนักงานปัจจุบันของ Nextcloud ระบุว่าเบราว์เซอร์ของผู้ใช้ต้องเข้าถึงเซิร์ฟเวอร์ทั้งสองผ่าน HTTP(S) โดย Nextcloud ต้องเข้าถึง Collabora และ Collabora ต้องเข้าถึง Nextcloud นอกจากนี้ยังระบุให้ใช้โปรโตคอลเดียวกันในทั้งสองบริการ ทดสอบที่อยู่สาธารณะของ Collabora จากเบราว์เซอร์ที่https://office.example.com/hosting/discoveryและhttps://office.example.com/hosting/capabilitiesจากโฮสต์ Nextcloud ให้ใช้:

curl -fsS https://office.example.com/hosting/discovery -o /dev/null

curl -fsS https://office.example.com/hosting/capabilities -o /dev/null

แทนที่ชื่อโฮสต์ตัวอย่างด้วย URL จริงของ Collabora ของคุณ การตรวจสอบเหล่านี้เป็นการตรวจสอบว่าสามารถเข้าถึง HTTP ได้หรือไม่ ไม่ใช่การแก้ไขที่สำเร็จ หากเซิร์ฟเวอร์เชื่อมต่อได้สำเร็จ แต่เบราว์เซอร์ล้มเหลว ให้ตรวจสอบ DNS สาธารณะ, TLS, ไฟร์วอลล์ หรือการเปิดเผยพร็อกซีคู่มือการแก้ไขปัญหา Nextcloud Officeแสดงรายการการตรวจสอบการเชื่อมต่อเหล่านี้และแนะนำให้ตรวจสอบบันทึกแอปพลิเคชันทั้งสองรายการ

ซ่อมแซมการกำหนดเส้นทางพร็อกซีเฉพาะเมื่อคำขอเหล่านั้นเกี่ยวข้องเท่านั้น

หากทรัพยากรตัวแก้ไขแบบคงที่ส่งคืนรหัส 404 หรือการเชื่อมต่อแบบเรียลไทม์ส่งคืนรหัส 502 ให้เปรียบเทียบเส้นทางพร็อกซีแบบย้อนกลับของคุณกับการตั้งค่าพร็อกซีอย่างเป็นทางการ ของ Collabora ตรวจสอบให้แน่ใจว่าพร็อกซีส่งเส้นทาง Collabora ที่จำเป็นไปยังอัปสตรีมที่ถูกต้องและรองรับการเชื่อมต่อ WebSocket ที่เบราว์เซอร์ใช้ รักษาข้อมูลโฮสต์ภายนอกและ HTTPS ที่การใช้งานของคุณคาดหวังไว้ อย่าคัดลอกการกำหนดค่าสำหรับพร็อกซี คำนำหน้า URL หรือรุ่น Collabora ที่แตกต่างกันโดยไม่ตรวจสอบข้อสมมติฐานก่อน ชื่อโฮสต์ Collabora เฉพาะมักจะง่ายต่อการแก้ไขปัญหา การกำหนดเส้นทางตามเส้นทางต้องมีการจัดการคำนำหน้าที่สอดคล้องกัน

แก้ไขรายการอนุญาต WOPI โดยไม่ต้องเปิดรายการเหล่านั้น

WOPI คือโปรโตคอลที่ Collabora ใช้ในการดึงและบันทึกเอกสารผ่านแพลตฟอร์มจัดเก็บข้อมูล โดยปกติแล้วโฮสต์ WOPI จะเป็นชื่อโฮสต์ของ Nextcloud หรือแพลตฟอร์มจัดเก็บข้อมูลอื่นๆ ไม่ใช่ชื่อโฮสต์ของ Collabora หากในบันทึกแสดงข้อความว่าNo acceptable WOPI hosts foundให้เพิ่มหรือแก้ไขชื่อโฮสต์จัดเก็บข้อมูลที่ถูกต้องในการตั้งค่าโฮสต์ WOPI ของ Collabora จากนั้นตรวจสอบว่ารายการอนุญาตคำขอ WOPI ของแพลตฟอร์มจัดเก็บข้อมูลมีที่อยู่เซิร์ฟเวอร์ของ Collabora อยู่หรือไม่ Nextcloud แนะนำให้จำกัดคำขอ WOPI เฉพาะที่อยู่ IP ของ Collabora ที่คาดไว้ และกำหนดค่า Collabora ให้เชื่อถือโฮสต์ที่คาดไว้ในคำแนะนำการกำหนดค่า Office ของ Nextcloud

การเพิ่มโฮสต์ที่เชื่อถือได้เฉพาะเจาะจงนั้นปลอดภัยกว่าการปิดใช้งานการตรวจสอบโฮสต์หรืออนุญาตโดเมนแบบกว้างๆ บันทึกการตั้งค่าปัจจุบัน เปลี่ยนเฉพาะรายการที่เกี่ยวข้อง และรีสตาร์ทหรือโหลดบริการใหม่เฉพาะเมื่อจำเป็นสำหรับการใช้งานของคุณ หากคุณใช้ Docker ให้ตรวจสอบเอาต์พุต Collabora ล่าสุดด้วยคำสั่ง `docker run` docker logs --since=10m <collabora-container>; แทนที่ตัวยึดตำแหน่งด้วยชื่อคอนเทนเนอร์จริง สำหรับการติดตั้งแบบแพ็กเกจหรือ Kubernetes ให้ใช้บันทึกบริการหรือบันทึกพอดแทน

4. ตรวจสอบตัวแก้ไข ไม่ใช่แค่ตรวจสอบจุดสิ้นสุดด้านสุขภาพ

โหลดเอกสารเดิมอีกครั้ง ตรวจสอบว่าไฟล์ต่างๆ โหลดเสร็จสมบูรณ์ การเชื่อมต่อสดเปิดอยู่ เนื้อหาปรากฏ และข้อผิดพลาดในคอนโซลหายไป ทดสอบกับเอกสารฉบับที่สองและผู้ใช้รายอื่นหากพบปัญหาเดียวกัน บันทึกการแก้ไขทดสอบที่ไม่เป็นอันตรายและเปิดใหม่อีกครั้งเพื่อตรวจสอบการอ่านและการบันทึก

หากหน้าจอยังคงว่างเปล่า แต่การร้องขอสำเร็จแล้ว ให้ตรวจสอบบันทึกของเซิร์ฟเวอร์เพื่อหาข้อผิดพลาดในการแปลงเอกสารหรือข้อผิดพลาดเฉพาะไฟล์ และเปรียบเทียบกับไฟล์อื่นที่มีรูปแบบเดียวกัน หากปัญหาเริ่มเกิดขึ้นทันทีหลังจากอัปเดต Collabora, เบราว์เซอร์ หรือพร็อกซี ให้ทดสอบการย้อนกลับอย่างเป็นระบบหรือการเปลี่ยนพร็อกซีเฉพาะเวอร์ชันในระหว่างช่วงเวลาการบำรุงรักษา แทนที่จะเปลี่ยนตัวแปรหลายตัวพร้อมกัน การล้างแคชของเบราว์เซอร์จะมีประโยชน์เฉพาะเมื่อมีหลักฐานชี้ไปที่สินทรัพย์ไคลเอ็นต์ที่ล้าสมัยเท่านั้น ไม่สามารถแก้ไขเส้นทางที่ถูกบล็อกหรือคำขอ WOPI ที่ถูกปฏิเสธได้