ตรวจสอบความล้มเหลวในการเชื่อมต่อ Collabora ด้วยไฟล์บันทึก coolwsd

สำหรับคอนเทนเนอร์ Collabora Online Development Edition (CODE) ให้เพิ่มcoolwsdระดับการบันทึกเป็นระดับสูงสุด ตรวจสอบdebugให้แน่ใจว่า พื้นที่ SocketและWebSocketไม่ได้ถูกปิดใช้งาน จากนั้นลองทำซ้ำการเปิดเอกสารที่ล้มเหลวหนึ่งครั้งในขณะที่ติดตามบันทึกของคอนเทนเนอร์ ใน Docker Compose ให้ส่งการตั้งค่าผ่านextra_paramsตัวแปรสภาพแวดล้อมของอิมเมจ CODE และสร้างบริการขึ้นใหม่ ใช้traceเฉพาะเมื่อเอาต์พุตการดีบักไม่แสดงจุดที่การเชื่อมต่อหยุดลง และกลับไปยังระดับก่อนหน้าเมื่อคุณทำเสร็จแล้ว

วิธีนี้เหมาะสำหรับการใช้งาน Docker หรือ Compose ที่คุณสามารถอัปเดตการกำหนดค่าคอนเทนเนอร์ได้ การติดตั้งแพ็กเกจแบบเนทีฟจะใช้/etc/coolwsd/coolwsd.xmlและตัวจัดการบริการแทน การตั้งค่านี้จะเพิ่มรายละเอียดการวินิจฉัย แต่จะไม่แก้ไขปัญหาพร็อกซี โฮสต์ WOPI ใบรับรอง หรือปัญหาเครือข่ายโดยอัตโนมัติ

1. เริ่มต้นด้วยการสืบพันธุ์แบบควบคุมเพียงครั้งเดียว

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

ตรวจสอบว่าคอนเทนเนอร์ทำงานอยู่หรือไม่ และระบุชื่อของคอนเทนเนอร์นั้น:

docker ps --format 'table {.Names}	{.Status}	{.Ports}'

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

docker logs --since 2m --follow --timestamps collabora

--followสตรีมเอาต์พุตใหม่--sinceจำกัดประวัติเริ่มต้น และ--timestampsเพิ่มการประทับเวลาของ Docker เอกสารของ Docker อธิบายตัวเลือกเหล่านี้ไว้ในเอกสารอ้างอิงบันทึกคอนเทนเนอร์ใน Compose คุณสามารถใช้ <service key> docker compose logs --since=2m --follow collaboraโดยที่ < collaboraservice key> คือคีย์บริการ

2. ตั้งค่า coolwsd เป็นโหมดดีบักสำหรับการทดสอบ

โครงสร้างการกำหนดค่า Collabora รองรับระดับที่มีชื่อ ได้แก่warning, notice, information, debug, และtraceนอกจากนี้ยังกำหนดdisabled_areas; ค่าเริ่มต้นที่ระบุไว้ในเอกสารจะปิดใช้งานเอาต์พุตที่มีรายละเอียดสูงจากSocketและWebSocketรวมถึงส่วนอื่นๆ สิ่งนี้มีความสำคัญสำหรับการแก้ไขปัญหาการเชื่อมต่อ: การเปลี่ยนระดับเพียงอย่างเดียวอาจทำให้รายละเอียดการจับมือที่สำคัญที่สุดยังคงถูกระงับ ตัวเลือกเหล่านี้มีเอกสารอยู่ในเทมเพลตการกำหนดค่า coolwsd ของ Collaboraและคู่มือ SDK ออนไลน์ของ Collabora (ส่วนการกำหนดค่า Docker; ตรวจสอบเมื่อตุลาคม 2026)

สำหรับcollabora/codeอิมเมจอย่างเป็นทางการ ให้เพิ่มตัวเลือกทั้งสองลงในค่าที่มีอยู่ของบริการ คงไว้extra_paramsซึ่งตัวเลือกใดๆ ที่การติดตั้งของคุณกำหนดไว้แล้ว เช่น การยุติ SSL หรือชื่อเซิร์ฟเวอร์:

services:
  collabora:
    environment:
      extra_params: "--o:logging.level=debug --o:logging.disabled_areas=Admin,Pixel"

ตัวเลือกที่สองจะคงไว้Socketซึ่งWebSocketการบันทึกข้อมูลที่มีรายละเอียดสูง ในขณะที่ยังคงปิดAdminใช้Pixelงานอยู่ อย่าเพิ่มพื้นที่ทั้งสองนี้กลับเข้าไปในรายการที่ปิดใช้งานในระหว่างการทดสอบนี้ เอกสารประกอบภาพ CODE อธิบายextra_paramsถึงวิธีการส่งตัวเลือกบรรทัดคำสั่งไปยัง coolwsd หากการปรับใช้ของคุณใช้ไฟล์การกำหนดค่าที่ติดตั้งหรือภาพที่จัดการโดยผู้จำหน่าย ให้ปฏิบัติตามวิธีการกำหนดค่าของการปรับใช้นั้นแทน

ใช้ฟังก์ชันแก้ไข Compose โดยการสร้างบริการขึ้นใหม่:

docker compose up -d --force-recreate collabora

ใช้ชื่อบริการ Compose จริงของคุณ สำหรับคอนเทนเนอร์ที่มีอายุสั้นซึ่งเริ่มต้นด้วย ให้docker runทำการอัปเดตการกำหนดค่าการทำงานและสร้างใหม่โดยใช้ volumes, networks, ports และตัวเลือกอื่นๆ เหมือนเดิม คู่มือ CODE ระบุว่าอิมเมจจะยอมรับextra_paramsเมื่อเริ่มต้นระบบ อย่าคิดว่าการเปลี่ยนแปลงสภาพแวดล้อมของคอนเทนเนอร์ที่สร้างไว้แล้วจะเปลี่ยนกระบวนการ coolwsd ที่กำลังทำงานอยู่

3. อ่านความเชื่อมโยงตามลำดับ

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

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

หาก Docker ไม่แสดงผลลัพธ์ใดๆ แม้ว่าบริการจะทำงานอยู่ ให้ตรวจสอบการตั้งค่าการบันทึกภายในคอนเทนเนอร์ คำสั่ง `log` ของ Docker จะอ่านสตรีมเอาต์พุตมาตรฐานและสตรีมข้อผิดพลาดของคอนเทนเนอร์ การติดตั้งที่กำหนดค่าให้เขียนลงไฟล์อาจใช้พาธเช่น `/ /var/log/coolwsd.logetc/document ...

docker exec collabora sh -c 'grep -n -A25 "<logging>" /etc/coolwsd/coolwsd.xml'

หากเปิดใช้งานการบันทึกไฟล์ ให้ใช้เส้นทางที่กำหนดค่าไว้ ตัวอย่างเช่น:

docker exec collabora sh -c 'tail -n 200 /var/log/coolwsd.log'

4. ตรวจสอบผลลัพธ์และคืนค่าการบันทึกข้อมูลตามปกติ

หลังจากทำการทดสอบแล้ว ให้ทำการอ่านข้อมูลแบบจำกัดขอบเขตเพื่อยืนยันว่าความพยายามที่ตั้งใจไว้ได้สร้างรายการใหม่:

docker logs --since 5m --timestamps collabora

คุณจะได้ผลลัพธ์ที่มีประโยชน์เมื่อคุณสามารถเชื่อมโยงการเปิดที่ล้มเหลวกับเหตุการณ์ coolwsd หรือตรวจสอบได้ว่าคำขอไม่เคยไปถึงคอนเทนเนอร์นี้ จากนั้นจึงระบุขั้นตอนการเชื่อมต่อที่ต้องติดตามผล หากคุณต้องการกรองผลลัพธ์ ให้ใช้ช่วงเวลาสั้นๆ ก่อน:

docker logs --since 5m collabora | grep -Ei 'coolwsd|WOPI|WebSocket|ERR|WRN'

คืนค่าก่อนหน้าlogging.levelและdisabled_areasค่าต่างๆ จากนั้นสร้างบริการขึ้นมาใหม่ ระดับการดีบักและการติดตามอาจสร้างเอาต์พุตได้มากกว่ามาก และอาจมีรายละเอียดการทำงานที่ละเอียดอ่อน ก่อนที่จะแชร์บันทึก ให้ลบโทเค็นการเข้าถึง ชื่อเอกสาร ตัวระบุผู้ใช้ ชื่อโฮสต์ และที่อยู่ภายในออก หากบริการนั้นไม่ใช่ภาพ CODE อย่างเป็นทางการ ให้ยืนยันเส้นทางการกำหนดค่าและพารามิเตอร์ที่รองรับกับผู้ดูแลภาพนั้น