แก้ไขข้อผิดพลาด “Unauthorized WOPI Host” ใน Collabora Online CODE

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

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

เลือกการเปลี่ยนแปลงที่ตรงกับการใช้งานของคุณ

ตัวอย่างด้านล่างนี้สมมติว่าใช้ Nextcloud ที่https://cloud.example.comและ Collabora ที่https://office.example.comโปรดแทนที่ชื่อทั้งสองและพอร์ตด้วยค่าที่ใช้ในการติดตั้งของคุณ คู่มือการตั้งค่า Docker ของ Nextcloud ใช้aliasgroup1สำหรับโฮสต์จัดเก็บข้อมูลเดียว และอธิบายวิธีการเพิ่มกลุ่มนามแฝงอีกกลุ่มสำหรับโฮสต์ Nextcloud ตัวที่สอง การกำหนดค่า WOPI ของ Collabora กำหนดการจับคู่โฮสต์โดยใช้ชื่อโฮสต์และพอร์ต โดยนามแฝงใช้สำหรับชื่ออื่นของโฮสต์จัดเก็บข้อมูลเดียวกัน

1. ตรวจสอบว่า Collabora ปฏิเสธโฮสต์ใด

เริ่มต้นด้วยการตรวจสอบบันทึกของคอนเทนเนอร์ CODE ในการใช้งาน Docker Compose ให้รันคำสั่งต่อไปนี้:

docker compose logs --since=10m collabora

แทนที่collaboraด้วยชื่อบริการในไฟล์ Compose ของคุณ สำหรับ Docker ทั่วไป ให้ใช้docker logs --since 10m CONTAINER_NAMEมองหาข้อความใกล้กับความพยายามเปิดเอกสารที่ล้มเหลว เช่นNo acceptable WOPI hosts found matching the target host [cloud.example.com] in configชื่อโฮสต์ในวงเล็บคือเบาะแส: เพิ่มโฮสต์จัดเก็บข้อมูลที่แสดงอยู่ตรงนั้น ไม่ใช่ชื่อโฮสต์สาธารณะของเซิร์ฟเวอร์ Collabora

นอกจากนี้ ให้บันทึกชื่อโฮสต์และพอร์ตใน URL ของ WOPI ด้วย หากปรากฏในบันทึก เปรียบเทียบกับรายการที่กำหนดค่าไว้ คำขอcloud.example.com:443อาจไม่ตรงกับรายการสำหรับชื่อคอนเทนเนอร์ภายใน เช่นnextcloudแม้ว่าทั้งสองชื่อจะชี้ไปยังเครื่องเดียวกันก็ตาม พร็อกซีแบบย้อนกลับ, DNS แบบแยกขอบเขต และ URL สาธารณะหลายรายการ อาจทำให้มองข้ามความไม่ตรงกันนี้ได้ง่าย

หากบันทึกแสดงข้อผิดพลาดอื่น เช่น ความล้มเหลวในการค้นหา DNS การปฏิเสธการเชื่อมต่อ หรือข้อผิดพลาดเกี่ยวกับใบรับรอง ให้แก้ไขปัญหานั้นแทนที่จะขยายรายการโฮสต์ WOPI

2. อัปเดตการตั้งค่าโฮสต์ WOPI ที่เชื่อถือได้ของ CODE

สำหรับการติดตั้ง Docker Compose ที่ให้บริการโฮสต์ Nextcloud เพียงเครื่องเดียว ส่วนที่เกี่ยวข้องของบริการจะมีลักษณะดังนี้:

services:
  collabora:
    image: collabora/code
    environment:
      - aliasgroup1=https://cloud.example.com:443

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

สำหรับโฮสต์เดียว การระบุชื่อโฮสต์อย่างแม่นยำจะตรวจสอบได้ง่ายกว่าการใช้ regular expression แบบกว้างๆ หากการติดตั้งของคุณใช้domainตัวแปรสภาพแวดล้อมแทน โปรดตรวจสอบกฎการหลีกเลี่ยงอักขระที่ระบุไว้สำหรับอิมเมจของคุณ และตรวจสอบให้แน่ใจว่านิพจน์ตรงกับชื่อโฮสต์จัดเก็บข้อมูลที่ต้องการเท่านั้น อย่าคัดลอก wildcard ที่ไม่ได้หลีกเลี่ยงอักขระ หรือรูปแบบโดเมนหลักที่จะตรงกับโดเมนย่อยที่ไม่เกี่ยวข้อง

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

3. สร้างคอนเทนเนอร์ขึ้นใหม่และตรวจสอบรายการอนุญาต (allow-list) แยกต่างหากของ Nextcloud

หลังจากแก้ไขไฟล์ Compose แล้ว ให้สร้างบริการขึ้นใหม่เพื่อให้สภาพแวดล้อมใหม่มีผลใช้งาน:

docker compose up -d --force-recreate collabora

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

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

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

4. ตรวจสอบการเชื่อมต่อทั้งหมดให้เรียบร้อย

ขั้นแรก ตรวจสอบเอนด์พอยต์บริการ Collabora จากเบราว์เซอร์และจากเซิร์ฟเวอร์ Nextcloud แทนที่ชื่อโฮสต์ตัวอย่างด้วย URL ของ Office ของคุณ:

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

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

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

สุดท้ายนี้ ให้เปิดเอกสารทดสอบและตรวจสอบบันทึก CODE และ Nextcloud พร้อมกัน ผลลัพธ์ที่ประสบความสำเร็จคือ โปรแกรมแก้ไขโหลดขึ้น ข้อความ "No acceptable WOPI hosts" หายไป และการบันทึกการเปลี่ยนแปลงเล็กน้อยใช้งานได้ ทดสอบจากบัญชีผู้ใช้ทั่วไปที่มีสิทธิ์ในการแชร์และแก้ไขเหมือนกับผู้ใช้ที่ได้รับผลกระทบ

การเปรียบเทียบตัวเลือกหลักๆ

โฮสต์ที่แน่นอนเทียบกับนิพจน์ปกติ

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

อินสแตนซ์ CODE เดียว เทียบกับอินสแตนซ์ที่แยกกัน

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

การตั้งค่าสภาพแวดล้อมคอนเทนเนอร์เทียบกับการแก้ไขไฟล์ XML

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

ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

• อนุญาตoffice.example.comเมื่อโฮสต์จัดเก็บข้อมูล WOPI ที่ถูกปฏิเสธคือcloud.example.com.
• การป้อนชื่อคอนเทนเนอร์ส่วนตัวเมื่อ URL ของ WOPI มีชื่อ DNS สาธารณะ หรือในทางกลับกัน
• โดยถือว่ารายการอนุญาต IP ของ Nextcloud WOPI ที่ว่างเปล่าและการกำหนดค่าโฮสต์ของ CODE เป็นการควบคุมแบบเดียวกัน
• การเพิ่มสัญลักษณ์ตัวแทนแบบกว้างๆ หรือการปิดใช้งานการตรวจสอบโฮสต์เพียงเพื่อให้โปรแกรมแก้ไขโหลดได้
• การเปลี่ยนกฎพร็อกซี, TLS และ WOPI พร้อมกัน จะทำให้การวิเคราะห์ผลลัพธ์ทำได้ยากขึ้น
• ทดสอบเฉพาะจุดเชื่อมต่อการค้นหาและถือว่าผลลัพธ์นี้เป็นหลักฐานว่าการตรวจสอบสิทธิ์เอกสารใช้งานได้

เมื่อใดควรใช้การแก้ไขแบบอื่น

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

ขั้นตอนเหล่านี้เป็นไปตามคู่มือการดูแลระบบ Nextcloud 35 ที่เผยแพร่เมื่อวันที่ 6 ตุลาคม 2026 และแผนผังการกำหนดค่า WOPI ที่ Collabora เผยแพร่ไว้ คีย์การกำหนดค่าเฉพาะอาจแตกต่างกันไปตามวิธีการปรับใช้และเวอร์ชันของอิมเมจ ดังนั้นโปรดตรวจสอบกับเอกสารประกอบสำหรับเวอร์ชันที่คุณติดตั้งก่อนทำการเปลี่ยนแปลง

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

• การแก้ไขปัญหาและการตรวจสอบการเชื่อมต่อของ Nextcloud Office
• ตัวอย่างการใช้งาน Docker ของ Nextcloud สำหรับ Collabora รวมถึงการตั้งค่าโฮสต์ WOPI
• คำแนะนำเกี่ยวกับการตั้งค่า Nextcloud Office และรายการอนุญาต IP ของ WOPI
• Collabora Online ได้เผยแพร่โครงสร้างการกำหนดค่า coolwsd.xml แล้ว
• เอกสารประกอบการตั้งค่าพร็อกซีของ Collabora Online