วิธีเชื่อมต่อ Collabora Online กับ ownCloud Infinite Scale

การผสานรวม Collabora Online กับ ownCloud Infinite Scale (oCIS) เป็นการผสานรวมแบบ WOPI ซึ่งไม่เหมือนกับการตั้งค่าที่ใช้ใน ownCloud Classic WOPI หรือ Web Application Open Platform Interface คือโปรโตคอลที่ช่วยให้ชุดโปรแกรมสำนักงานออนไลน์สามารถร้องขอไฟล์จากแพลตฟอร์มจัดเก็บข้อมูล แก้ไขไฟล์ในเบราว์เซอร์ และเขียนผลลัพธ์กลับไปได้

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

ณ เดือนตุลาคม 2026 การเผยแพร่เวอร์ชันอย่างเป็นทางการของ ownCloud บน GitHub รวมถึง Infinite Scale 8.2.0 ซึ่งเผยแพร่เมื่อวันที่ 10 สิงหาคม 2026 ตัวอย่างการปรับใช้ของโครงการอาจมีการเปลี่ยนแปลงอย่างอิสระ ดังนั้นควรใช้แท็กเวอร์ชันที่ใช้งานจริงที่ผ่านการทดสอบแล้ว แทนที่จะสันนิษฐานว่าอิมเมจที่มีการเปลี่ยนแปลงอย่างต่อเนื่องนั้นเหมาะสม ตัวอย่างการปรับใช้แบบเต็มรูปแบบของ oCIS อย่างเป็นทางการในปัจจุบันแนะนำให้ใช้แท็ก Collabora CODE 26.04.3.1.1ในไฟล์สภาพแวดล้อม ตรวจสอบการเผยแพร่ Infinite Scale อย่างเป็นทางการและไฟล์สภาพแวดล้อมตัวอย่างการปรับใช้อย่างเป็นทางการก่อนที่จะกำหนดเวอร์ชัน

ขั้นแรก ทำความเข้าใจจุดปลายทั้งสาม

โดยปกติแล้ว การบูรณาการการผลิตจะเกี่ยวข้องกับจุดสิ้นสุดเชิงตรรกะสามจุด:

ยืนยันแล้ว: COLLABORATION_APP_ADDRคือ URL ของ Collabora และCOLLABORATION_WOPI_SRCระบุแหล่งที่มาของ WOPI ที่แอปพลิเคชันสำนักงานใช้ ขึ้นอยู่กับสภาพแวดล้อม:แหล่งที่มาของ WOPI ไม่จำเป็นต้องเป็นชื่อโฮสต์สาธารณะแยกต่างหาก เมื่อ Collabora และบริการการทำงานร่วมกันใช้เครือข่ายคอนเทนเนอร์ที่เชื่อถือได้ร่วมกัน ตัวอย่าง Compose อย่างเป็นทางการในปัจจุบันใช้http://collaboration:9300ภายใน การปรับใช้แบบแยกส่วนอาจต้องใช้ชื่อโฮสต์ WOPI HTTPS ที่กำหนดเส้นทางไว้

ข้อควรปฏิบัติ:ตัดสินใจเกี่ยวกับโครงสร้างเครือข่ายของคุณก่อนที่จะคัดลอกค่าการกำหนดค่า หากส่วนประกอบทั้งหมดทำงานอยู่ใน Compose stack เดียวกัน ให้เริ่มต้นจากตัวอย่างนั้น หาก Collabora อยู่บนโฮสต์อื่นหรือคลัสเตอร์ Kubernetes อื่น ให้ตรวจสอบว่าแต่ละฝ่ายสามารถแก้ไขและเข้าถึงชื่อ DNS ใดได้บ้าง

ขั้นตอนที่ 1: ตรวจสอบ DNS, HTTPS และ Collabora Discovery

ก่อนที่จะแก้ไขการตั้งค่า oCIS โปรดตรวจสอบให้แน่ใจว่าชื่อ ownCloud และ Collabora สามารถใช้งานได้อย่างถูกต้อง และ Collabora ได้เปิดเผยเอนด์พอยต์การค้นหาแล้ว Collabora เผยแพร่ความสามารถของ WOPI ผ่านทาง/hosting/discoveryการตรวจสอบเบื้องต้นมีดังนี้:

dig +short cloud.example.com
dig +short office.example.com

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

คุณควรได้รับข้อมูล XML จากเอนด์พอยต์การค้นหา หาก TLS สิ้นสุดที่รีเวิร์สพร็อกซี โปรดยืนยันว่าใบรับรองที่แสดงนั้นoffice.example.comถูกต้องจากมุมมองของโฮสต์ oCIS หรือเครือข่ายคอนเทนเนอร์

คำบรรยายภาพ: ตรวจสอบการแก้ไขชื่อและปลายทาง Collabora /hosting/discoveryก่อนแก้ไขข้อผิดพลาดในการลงทะเบียน WOPI ภายใน Infinite Scale

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

คำแนะนำที่เป็นประโยชน์:เรียกใช้การทดสอบการเชื่อมต่อจากเน็ตเวิร์กเนมสเปซเดียวกันกับบริการที่เกี่ยวข้อง เช่น จากภายในคอนเทนเนอร์สำหรับการทำงานร่วมกันเมื่อใช้ Docker

ขั้นตอนที่ 2: กำหนดค่าบริการการทำงานร่วมกันแบบไร้ขีดจำกัด (Infinite Scale Collaboration Service)

บริการการทำงานร่วมกันจะไม่เริ่มต้นโดยอัตโนมัติด้วยocis serverการตั้งค่าโหมดควบคุมทั่วไป เอกสารของ ownCloud ระบุว่าต้องเริ่มต้นบริการนี้อย่างชัดเจน เนื่องจากผู้ดูแลระบบอาจใช้งานบริการการทำงานร่วมกันมากกว่าหนึ่งอินสแตนซ์สำหรับผลิตภัณฑ์ Office ต่างๆ

การตั้งค่าที่สำคัญสำหรับ Collabora มีดังนี้:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.com

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

บริการนี้ยังขึ้นอยู่กับโครงสร้างพื้นฐานเกตเวย์และแอปโพรวิเดนเซอร์ของ Infinite Scale ด้วย ในการใช้งานแบบแยกคอนเทนเนอร์ เอกสารของ ownCloud เตือนไว้อย่างชัดเจนว่าการกำหนดค่า oCIS ต้องแชร์กับคอนเทนเนอร์สำหรับการทำงานร่วมกัน เนื่องจากจำเป็นต้องใช้รหัสลับที่สร้างขึ้นระหว่างบริการต่างๆ ดู คำจำกัดความอย่างเป็นทางการ ของCollabora Compose ในปัจจุบัน

คำบรรยายภาพ: กระบวนการบริการการทำงานร่วมกันควรเริ่มต้นด้วยที่อยู่ Collabora และแหล่งที่มา WOPI ที่ต้องการ ใช้บันทึกบริการจริงเพื่อยืนยันค่าต่างๆ ในการใช้งานของคุณ

ข้อแนะนำที่เป็นประโยชน์:หากคุณสร้างการปรับใช้ด้วยตนเอง ให้เปรียบเทียบสภาพแวดล้อมของคุณกับสภาพแวดล้อมอย่างเป็นทางการcollabora.ymlแทนที่จะคัดลอกการตั้งค่าจากบทช่วยสอนเก่าๆ ของ cs3org/wopiserver

ขั้นตอนที่ 3: กำหนดค่า Collabora สำหรับโฮสต์ WOPI และการฝังในเบราว์เซอร์

Collabora ต้องเชื่อถือโฮสต์ WOPI และได้รับอนุญาตให้แสดงผลภายในหน้าเว็บ ownCloud ตัวอย่าง Compose อย่างเป็นทางการของ oCIS จะส่งผ่านตัวเลือก Collabora ที่ยุติ TLS ที่พร็อกซีแบบย้อนกลับและตั้งค่าnet.frame_ancestorsเป็นโดเมน oCIS นอกจากนี้ยังสร้างคีย์พิสูจน์ WOPI ก่อนเริ่ม Collabora ด้วย

ในตัวอย่างอย่างเป็นทางการ ค่าที่เกี่ยวข้องจากฝั่ง Collabora ได้แก่:

DONT_GEN_SSL_CERT=YES

extra_params:
  --o:ssl.enable=...
  --o:ssl.ssl_verification=...
  --o:ssl.termination=true
  --o:welcome.enable=false
  --o:net.frame_ancestors=cloud.example.com

การตั้งค่า SSL ที่แน่นอนจะขึ้นอยู่กับว่า TLS สิ้นสุดที่ใด การตั้งค่าที่แนะนำสำหรับการใช้งานบนอินเทอร์เน็ตคือ HTTPS โดยเปิดใช้งานการตรวจสอบใบรับรองINSECURE=trueตัวเลือกในตัวอย่างนี้มีไว้สำหรับการตั้งค่าภายในองค์กรโดยใช้ใบรับรองที่ลงนามด้วยตนเอง คู่มือการใช้งานของ ownCloud ระบุอย่างชัดเจนให้ผู้ดูแลระบบลบออกหรือตั้งค่าเป็น false สำหรับเซิร์ฟเวอร์สาธารณะ

คำบรรยายภาพ: การเข้าถึง Collabora endpoint เป็นสิ่งจำเป็นอย่างหนึ่ง ในการใช้งานจริง ควรเปิดเผย endpoint นั้นผ่าน HTTPS พร้อมใบรับรองที่ได้รับการยอมรับจากส่วนประกอบอื่นๆ

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

ขั้นตอนที่ 4: การลงทะเบียนประเภทไฟล์และการทดสอบการแก้ไข

บริการลงทะเบียนแอปพลิเคชันของ Infinite Scale จะตัดสินว่าแอปพลิเคชันใดสามารถเปิดไฟล์ประเภท MIME ใดได้บ้าง การตั้งค่าสามารถกำหนดประเภท MIME, นามสกุลไฟล์, ไอคอน, แอปพลิเคชันเริ่มต้น และอนุญาตให้ผู้ใช้สร้างไฟล์ใหม่ในประเภทนั้นได้หรือไม่เอกสารอย่างเป็นทางการของ App Registryอธิบายถึงฟิลด์เหล่านี้

รายละเอียดสำคัญคือ ชื่อแอปที่ใช้โดยระบบลงทะเบียนต้องตรงกับชื่อผู้ให้บริการการทำงานร่วมกันที่คุณลงทะเบียนไว้จริง ตัวอย่างการใช้งาน Collabora อย่างเป็นทางการในปัจจุบันใช้ ชื่อผลิตภัณฑ์ CollaboraOnlineเป็นCOLLABORATION_APP_NAMEและCollaboraอย่าคัดลอกชื่อจากตัวอย่างเก่าๆ โดยไม่ตรวจสอบเวอร์ชันการใช้งานก่อน

หลังจากเริ่มต้นระบบแล้ว ให้ล็อกอินเข้าสู่ ownCloud Web และเปิดเอกสาร Office ที่รองรับ ขั้นตอนที่สำเร็จจะมีลักษณะดังนี้:

• ownCloud Web จะเลือกแอปพลิเคชันสำนักงานจดทะเบียนสำหรับประเภท MIME ของเอกสาร
• บริการความร่วมมือจะสร้างข้อมูลการเปิดตัว WOPI ขึ้นมา
• Collabora จะโหลดในเบราว์เซอร์และร้องขอไฟล์ผ่าน WOPI
• การแก้ไขจะถูกส่งกลับไปยัง Infinite Scale ผ่านการเชื่อมต่อแบบเดียวกัน

คำบรรยายภาพ: การทดสอบขั้นสุดท้ายคือการเปิดเอกสารสำนักงานจริงจาก ownCloud Web แก้ไขใน Collabora ปิดเอกสาร และตรวจสอบว่าเวอร์ชันที่บันทึกไว้ปรากฏให้เห็นอีกครั้งใน Infinite Scale

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

ใช้ตัวอย่าง Compose อย่างเป็นทางการเมื่อคุณไม่ต้องการ Topology แบบกำหนดเอง

สำหรับการใช้งาน Docker แบบทั่วไป วิธีที่มีความเสี่ยงต่ำที่สุดคือocis_fullตัวอย่างที่ ownCloud ดูแลรักษา ซึ่งประกอบด้วย Infinite Scale, บริการสำหรับการทำงานร่วมกัน Collabora และ Traefik คู่มืออย่างเป็นทางการระบุว่าการใช้งานนี้ต้องการโดเมนสำหรับ oCIS และ Collabora และได้บันทึกส่วนประกอบ WOPI ไว้ในเอกสารว่าเป็นส่วนหนึ่งของสแต็ก ดูคู่มือการใช้งานฉบับเต็มอย่างเป็นทางการได้ ที่ นี่

ไฟล์สภาพแวดล้อมที่เน้นการใช้งานจริงโดยทั่วไปจะมีค่าต่างๆ ในเชิงแนวคิดดังนี้:

OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com

COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com

INSECURE=false

จากนั้นเริ่มสแต็กด้วย:

docker compose pull
docker compose up -d
docker compose ps

ตรวจสอบแล้ว:ตัวอย่าง reverse-proxy อย่างเป็นทางการในปัจจุบันอนุญาตให้เข้ารหัสเครื่องหมายทับ เครื่องหมายคำถาม และเครื่องหมายเปอร์เซ็นต์ในจุดเข้าใช้งาน HTTPS เนื่องจาก Collaboration/Collabora ต้องการเครื่องหมายเหล่านี้ขึ้นอยู่กับสภาพแวดล้อม:หากคุณใช้ Nginx, HAProxy, ingress controller หรือ cloud load balancer แทน Traefik คุณต้องจำลองการจัดการ URL พฤติกรรม WebSocket/proxy ใบรับรอง และการหมดเวลาที่จำเป็นในแพลตฟอร์มนั้นด้วย

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

คู่มือการแก้ไขปัญหา

สิ่งที่เรารู้ สิ่งที่ขึ้นอยู่กับการใช้งานของคุณ และสิ่งที่ไม่ควรคาดเดา

สิ่งที่ทราบ: Infinite Scale รองรับ Collabora ผ่าน WOPI โดยบริการการทำงานร่วมกันในตัวเป็นตัวเชื่อมต่อในปัจจุบัน และการใช้งานแบบเต็มรูปแบบอย่างเป็นทางการได้ให้สถาปัตยกรรมอ้างอิงที่ใช้งานได้จริง

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

อย่าเข้าใจผิด:คำแนะนำสำหรับ ownCloud Classic สามารถนำไปใช้กับ Infinite Scale ได้ เอกสารสำหรับ Classic ที่ระบุให้คุณติดตั้งแอป Collabora/richdocuments หรือกำหนดค่าผ่าน UI ผู้ดูแลระบบของ Classic นั้นอธิบายถึงสถาปัตยกรรมของผลิตภัณฑ์ที่แตกต่างกัน

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