แก้ไขปัญหาหน้าจอดำหรือเอกสารว่างเปล่าขณะโหลด Collabora Online

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

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

วินิจฉัยโรคอย่างรวดเร็วโดยพิจารณาจากอาการ

1. ตรวจสอบว่าปัญหาเกิดจากฝั่งเบราว์เซอร์หรือฝั่งเซิร์ฟเวอร์

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

สำหรับการตรวจสอบฝั่งเบราว์เซอร์ ให้เปิดเครื่องมือสำหรับนักพัฒนา (Developer Tools) ก่อนที่จะโหลดเอกสารเปล่าใหม่ ในเบราว์เซอร์ที่ใช้ Chromium ให้กดปุ่ม Ctrl F12หรือCtrl+Shift+ICtrl+C เลือกNetworkเปิดใช้งานPreserve logแล้วโหลดใหม่ กรองหาws, cool, หรือbrowserนอกจากนี้ ตรวจสอบแท็บ Console เพื่อดูสคริปต์ที่ถูกบล็อก คำเตือนเกี่ยวกับใบรับรอง หรือข้อผิดพลาดเกี่ยวกับนโยบายความปลอดภัยของเนื้อหา (Content Security Policy)

คำขอที่ล้มเหลวภายใต้/cool/…/wsบ่งชี้ถึงปัญหาการเชื่อมต่อ WebSocket หรือพร็อกซี502โดยปกติแล้ว หมายความว่าพร็อกซีไม่สามารถรับการตอบสนองที่ใช้งานได้จากเซิร์ฟเวอร์ต้นทาง404อาจหมายความว่าเส้นทางไม่ได้รับการกำหนดเส้นทาง และ403อาจบ่งชี้ถึงโฮสต์หรือกฎการเข้าถึงที่ถูกปฏิเสธ รหัสสถานะเหล่านี้ช่วยจำกัดขอบเขตการค้นหา แต่จำเป็นต้องมีบันทึกพร็อกซีและบันทึก Collabora ที่ตรงกันเพื่อระบุสาเหตุที่แท้จริง หากคำขอที่ล้มเหลวเป็นไฟล์ JavaScript หรือ CSS ภายใต้/browserให้ตรวจสอบว่าพร็อกซีส่งต่อสินทรัพย์คงที่เหล่านั้นไปยังบริการ Collabora หรือไม่

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

2. ยืนยัน URL ของ Collabora และจุดเชื่อมต่อการค้นหา

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

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

จากนั้นให้ทดสอบจากโฮสต์ Nextcloud เพราะการทดสอบผ่านเบราว์เซอร์เพียงอย่างเดียวไม่สามารถพิสูจน์ได้ว่าเซิร์ฟเวอร์สามารถสื่อสารกันได้:

curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/discovery
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/capabilities

แทนที่office.example.comด้วยชื่อโฮสต์ Collabora ที่กำหนดค่าไว้ การตอบสนอง HTTP ที่สำเร็จเป็นการตรวจสอบการเข้าถึงที่มีประโยชน์ ในขณะที่การหมดเวลา ความล้มเหลวของ DNS ข้อผิดพลาด TLS หรือการตอบสนอง 5xx จำเป็นต้องได้รับการแก้ไขที่เครือข่าย ใบรับรอง DNS หรือพร็อกซีที่เกี่ยวข้อง สำหรับการติดตั้งที่เซิร์ฟเวอร์ Collabora ต้องเรียกกลับไปยัง Nextcloud ให้ทดสอบ URL สถานะของ Nextcloud จากโฮสต์ Collabora ด้วย:

curl -fsS https://cloud.example.com/status.php

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

3. ตรวจสอบเส้นทาง WebSocket และพร็อกซีแบบย้อนกลับ

Collabora ให้บริการไฟล์ข้อมูลสำหรับเบราว์เซอร์และเซสชันเอกสารผ่านเส้นทางหลายเส้นทาง พร็อกซีแบบย้อนกลับจะต้องส่งต่อเส้นทางที่คาดหวังโดยเวอร์ชันที่ติดตั้ง รวมถึงไฟล์ข้อมูลสำหรับตัวแก้ไข จุดสิ้นสุดการค้นหาและความสามารถ และเส้นทาง WebSocket ของเอกสาร เอกสาร Collabora ในปัจจุบันใช้/cool/…/ws; การติดตั้งเวอร์ชันเก่าอาจยังคงมีการกำหนดค่าสำหรับเส้นทางแบบเดิม/loolเอกสารการย้ายข้อมูลของ Nextcloud ระบุถึงการเปลี่ยนแปลงเส้นทางในอดีตจากloleafletเป็นbrowserและจากloolเป็น ไว้coolอย่าง ชัดเจน

ในการกำหนดค่าพร็อกซีของคุณ ตรวจสอบให้แน่ใจว่าตำแหน่ง WebSocket ตรงกับกฎ catch-all ที่กว้างกว่า พร็อกซีส่งต่อส่วนหัวการอัปเกรดที่จำเป็นสำหรับซอฟต์แวร์พร็อกซีของคุณ และอัปสตรีมชี้ไปยังบริการและพอร์ต Collabora จริง นอกจากนี้ ยืนยันว่าพร็อกซีเก็บรักษาข้อมูลโฮสต์และรูปแบบที่คาดหวังไว้ และอนุญาตให้การเชื่อมต่อที่มีอายุการใช้งานนานเปิดอยู่ หาก TLS สิ้นสุดที่พร็อกซี ตรวจสอบให้แน่ใจว่าการตั้งค่าการยุติ SSL ของ Collabora ตรงกับการออกแบบนั้น

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

4. ตรวจสอบการยืนยันโฮสต์ WOPI และบันทึกเซิร์ฟเวอร์

Collabora ใช้ WOPI (Web Application Open Platform Interface) เพื่อขอเอกสารจากบริการจัดเก็บข้อมูลที่เชื่อมต่ออยู่ เช่น Nextcloud เซิร์ฟเวอร์ Collabora ต้องยอมรับโฮสต์ WOPI และเซิร์ฟเวอร์จัดเก็บข้อมูลต้องสามารถเข้าถึงบริการ Collabora ได้ ใน Nextcloud ให้ตรวจสอบการตั้งค่า Office และรายการที่อนุญาตสำหรับการร้องขอ WOPI เพิ่มเฉพาะที่อยู่เซิร์ฟเวอร์ Collabora ที่คาดไว้เท่านั้น อย่าปิดใช้งานการตรวจสอบโฮสต์หรืออนุญาตโฮสต์ที่ไม่ถูกต้อง มิฉะนั้นหน้าจอจะว่างเปล่า

อ่านบันทึก (log) ในขณะที่เกิดปัญหาขึ้น สำหรับการใช้งาน Docker คู่มือการแก้ไขปัญหาของ Nextcloud ระบุถึงการตรวจสอบบันทึกของคอนเทนเนอร์ โปรดใช้ชื่อหรือรหัสคอนเทนเนอร์จริง:

docker logs --tail 100 collabora

สำหรับการติดตั้งแบบใช้แพ็กเกจ ชื่อบริการและปลายทางของไฟล์บันทึกจะขึ้นอยู่กับระบบปฏิบัติการและเวอร์ชันของแพ็กเกจ การตรวจสอบทั่วไปของ systemd มีดังนี้:

sudo journalctl -u coolwsd -n 100 --no-pager

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

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

5. ทดสอบเอกสารอีกครั้งและทำการแก้ไขเฉพาะส่วนที่ต้องการเท่านั้น

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

• การค้นหาใช้งานได้ แต่ WebSocket ล้มเหลว:ให้เน้นที่เส้นทาง WebSocket ของพร็อกซี การจัดการการอัปเกรด ที่อยู่อัปสตรีม และการหมดเวลาของการเชื่อมต่อ
• เบราว์เซอร์สามารถเข้าถึง Collabora ได้ แต่ Nextcloud ไม่สามารถเข้าถึงได้:โปรดตรวจสอบ DNS, ไฟร์วอลล์, ความน่าเชื่อถือของ TLS และการกำหนดเส้นทางจากโฮสต์ Nextcloud
• Collabora รายงานว่าพบโฮสต์ WOPI ที่ไม่ได้รับอนุญาต:โปรดเปรียบเทียบชื่อโฮสต์จัดเก็บข้อมูลที่แน่นอนในการตั้งค่าการผสานรวมกับรายการโฮสต์ WOPI ที่อนุญาต
• เฉพาะการติดตั้งเวอร์ชันเก่าเท่านั้นที่จะล้มเหลวหลังจากการอัปเกรด:เปรียบเทียบเส้นทางพร็อกซีกับเอกสารประกอบเวอร์ชันที่ติดตั้งไว้ และอัปเดตเส้นทางเดิม/loolหรือ/loleafletเส้นทางอื่นๆ ตามความจำเป็น
• หลังจากตรวจสอบการเชื่อมต่อแล้ว จะมีไฟล์เพียงไฟล์เดียวที่ล้มเหลว:โปรดตรวจสอบการเข้าถึงไฟล์และทดสอบไฟล์สำเนาหรือรูปแบบอื่นที่รองรับก่อนที่จะเปลี่ยนแปลงการตั้งค่าโดยรวม

ลักษณะของการแก้ไขที่ประสบความสำเร็จเป็นอย่างไร

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

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