แก้ไขข้อผิดพลาด “นี่มันน่าอายจัง” ของ Collabora

เริ่มต้นด้วยการตรวจสอบว่าเบราว์เซอร์ Nextcloud และ Collabora สามารถเข้าถึง URL เซิร์ฟเวอร์ที่ถูกต้องผ่านโปรโตคอล HTTP หรือ HTTPS เดียวกันได้หรือไม่ ใน Nextcloud ให้ทดสอบ/hosting/capabilitiesปลายทาง ของ Collabora /hosting/discoveryหากปลายทางเหล่านั้นตอบสนอง แต่เอกสารยังคงส่งไม่สำเร็จ ให้ตรวจสอบเส้นทาง WebSocket ของพร็อกซีแบบย้อนกลับและรายการอนุญาต WOPI

ข้อความ “นี่มันน่าอายจัง” เป็นเพียงข้อความแสดงความล้มเหลวในการเปิดเอกสารทั่วไป ไม่ใช่การวินิจฉัยปัญหาโดยตรง สาเหตุอาจเกิดจาก URL ที่เข้าถึงไม่ได้ ความไม่ตรงกันของ TLS หรือ DNS พร็อกซีที่บล็อกการอัปเกรด WebSocket หรือโฮสต์ WOPI ที่ Collabora หรือ Nextcloud ไม่เชื่อถือ การตรวจสอบด้านล่างใช้ตัวอย่างทั่วไปที่มี Nextcloud อยู่ที่https://cloud.example.comและ Collabora อยู่ที่https://office.example.com; โปรดแทนที่ชื่อทั้งสองด้วยชื่อโฮสต์จริงของคุณ

1. ปลายทางของ Collabora โหลดได้หรือไม่?

จากเบราว์เซอร์บนเครือข่ายเดียวกันกับผู้ใช้ ให้เปิด URL เหล่านี้ โดยเปลี่ยนชื่อโฮสต์ของ Collabora:

• https://office.example.com/hosting/capabilities
• https://office.example.com/hosting/discovery

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

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

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

2. บริการทั้งสองตกลงกันเรื่องชื่อโฮสต์และโปรโตคอลหรือไม่?

ใน Nextcloud ให้เปิดการตั้งค่า → การจัดการ → สำนักงานและตรวจสอบให้แน่ใจว่าช่องเซิร์ฟเวอร์ Collabora Online มี URL ของ Collabora ที่สามารถเข้าถึงได้จากภายนอก ใช้ URL นี้https://หากบริการได้รับการกำหนดค่าสำหรับ HTTPS เอกสารของ Nextcloud ระบุว่า URL ที่กำหนดค่าควรใช้โปรโตคอลเดียวกันกับการติดตั้ง Collabora และแนะนำให้ใช้ HTTPS

ตอนนี้ตรวจสอบเส้นทางการส่งข้อมูลกลับ จากโฮสต์หรือคอนเทนเนอร์ของ Collabora ให้ร้องขอเอนด์พอยต์สถานะของ Nextcloud:

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

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

3. โปรแกรมพร็อกซีแบบย้อนกลับของคุณส่งผ่านทราฟฟิก WebSocket หรือไม่?

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

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

ตรวจสอบบันทึกการเข้าถึงและข้อผิดพลาดในช่วงเวลาเดียวกันกับการพยายามที่ล้มเหลว ข้อผิดพลาด 404 บ่ง ชี้ /browserถึง/coolปัญหาการกำหนดเส้นทาง การอัปเกรด WebSocket ที่ล้มเหลวบ่งชี้ว่าการจัดการการอัปเกรดหายไปหรือหมดเวลา ข้อผิดพลาด 502 โดยทั่วไปหมายความว่าพร็อกซีไม่สามารถเชื่อมต่อกับเซิร์ฟเวอร์ต้นทางของ Collabora ได้ สิ่งเหล่านี้เป็นเพียงเบาะแส ไม่ใช่การวินิจฉัยที่แน่ชัด ดังนั้นควรเปรียบเทียบกับบันทึกของ Collabora เองด้วย

4. โฮสต์ WOPI ได้รับอนุญาตหรือไม่?

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

docker ps
 docker logs --tail=100 CONTAINER_NAME

แทนที่CONTAINER_NAMEด้วยชื่อจริงของคอนเทนเนอร์ Collabora สำหรับการติดตั้งแพ็กเกจแบบเนทีฟ ให้ตรวจสอบบันทึกบริการด้วยsudo journalctl -u coolwsd --since "15 minutes ago"คำสั่ง `npm run run` ปฏิบัติตามคำแนะนำในการกำหนดค่าโฮสต์ WOPI สำหรับวิธีการติดตั้งของคุณ หลีกเลี่ยงกฎการอนุญาตไวด์การ์ดแบบกว้างๆ

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

ตรวจสอบการแก้ไข

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

ข้อมูลอ้างอิงอย่างเป็นทางการ

• การตรวจสอบการแก้ไขปัญหาและข้อผิดพลาดในการเชื่อมต่อของ Nextcloud Office
• การกำหนดค่า URL ของ Nextcloud Office และ WOPI
• คำแนะนำจาก Nextcloud เกี่ยวกับการเปลี่ยนแปลงเส้นทางปลายทางของ Collabora
• การตั้งค่าพร็อกซีแบบย้อนกลับของ Collabora Online