เชื่อมต่อ Nextcloud กับคอนเทนเนอร์ Collabora CODE ที่ติดตั้งเอง

ในการเชื่อมต่อ Nextcloud กับคอนเทนเนอร์ Collabora Online Development Edition (CODE) ที่ติดตั้งเอง ให้รัน CODE บนชื่อโฮสต์ที่แยกต่างหาก ตั้งค่าให้อยู่หลัง HTTPS และป้อน URL สาธารณะใน Nextcloud Office คอนเทนเนอร์ CODE ต้องอนุญาตให้ไซต์ Nextcloud มีต้นทางเป็นโฮสต์ WOPI ด้วย ในตัวอย่างด้านล่าง Nextcloud คือcloud.example.comและ Collabora คือoffice.example.com; โปรดแทนที่ทั้งสองด้วยชื่อโฮสต์จริงของคุณ

ควรเตรียมอะไรบ้างก่อนเริ่ม?

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

คู่มือนี้สมมติว่ามีการใช้งาน Reverse Proxy บนโฮสต์ Docker และส่งต่อทราฟฟิก HTTPS ไปoffice.example.comยังพอร์ตภายในของคอนเทนเนอร์ หาก Proxy ของคุณทำงานอยู่ในคอนเทนเนอร์อื่นหรือบนเครื่องอื่น อย่าคัดลอกการแมปพอร์ต Loopback โดยไม่เปลี่ยนแปลง: ให้ใช้เครือข่าย Docker ส่วนตัวหรือที่อยู่โฮสต์ส่วนตัวที่ Proxy สามารถเข้าถึงได้ และตั้งค่าไฟร์วอลล์ให้กับแบ็กเอนด์เพื่อไม่ให้เปิดเผยต่อสาธารณะ

1. เริ่มคอนเทนเนอร์ CODE

ขั้นแรก ดึงอิมเมจและเริ่มคอนเทนเนอร์ ในการตั้งค่านามแฝง ให้ใช้ที่อยู่สาธารณะของ Nextcloud รวมถึงโปรโตคอลและพอร์ต อย่าใส่ URL ของ Collabora ลงไป ตัวอย่างการติดตั้ง Docker ของ Nextcloud ใช้รูปแบบนี้:

docker pull collabora/code
docker run -t -d -p 127.0.0.1:9980:9980 \
  -e 'aliasgroup1=https://cloud.example.com:443' \
  --restart always \
  --cap-add MKNOD \
  collabora/code

การผูกลูปแบ็ก (loopback binding) หมายความว่าพอร์ต 9980 สามารถเข้าถึงได้จากโฮสต์ Docker เท่านั้น เช่น ผ่านพร็อกซีแบบย้อนกลับ (reverse proxy) บนโฮสต์เดียวกันนั้น พร็อกซีจะให้ปลายทาง HTTPS สาธารณะแก่เบราว์เซอร์และ Nextcloud ในขณะที่รักษาพอร์ตของคอนเทนเนอร์ให้เป็นส่วนตัว หาก Nextcloud ให้บริการบนพอร์ตที่ไม่ใช่มาตรฐานหรือผ่านชื่อโฮสต์สาธารณะที่แตกต่างกัน ให้ตั้งค่านามแฝงให้ตรงกับต้นทางที่ผู้ใช้ใช้งานจริง หากคุณมีอินสแตนซ์ Nextcloud หลายตัว ให้กำหนดค่าโฮสต์ WOPI ที่อนุญาตแต่ละตัวโดยใช้ไวยากรณ์ที่ Collabora ได้บันทึกไว้ แทนที่จะอนุญาตโดเมนแบบสุ่ม

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

2. วางคอนเทนเนอร์ไว้หลังพร็อกซีแบบ HTTPS

กำหนดค่าพร็อกซีที่มีอยู่ของคุณให้ทำหน้าที่ให้บริการhttps://office.example.comและส่งต่อคำขอไปยังบริการ CODE บน127.0.0.1:9980. ใช้การกำหนดค่ารีเวิร์สพร็อกซีปัจจุบันของ Collabora สำหรับซอฟต์แวร์พร็อกซีของคุณ พร็อกซีต้องรักษาเส้นทางที่จำเป็นและรองรับการอัปเกรด WebSocket เนื่องจากเซสชันเบราว์เซอร์ของตัวแก้ไขขึ้นอยู่กับสิ่งเหล่านี้ ตัวอย่าง Nextcloud Docker มีเส้นทางสำหรับ/browser, /hosting/discovery, /hosting/capabilities, และ รวมถึงปลายทาง WebSocket การผสานรวมบางอย่างยังใช้ เส้นทาง/coolความเข้ากันได้ด้วย/lool

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

3. เปิดใช้งาน Nextcloud Office และป้อน URL ของเซิร์ฟเวอร์

ใน Nextcloud ให้เปิดแอปแล้วติดตั้งหรือเปิดใช้งาน Nextcloud Office ( richdocumentsการผสานรวม) จากนั้นเปิดการตั้งค่าการดูแลระบบ → Officeเลือกตัวเลือกเซิร์ฟเวอร์ Collabora ภายนอก แล้วป้อนhttps://office.example.comบันทึกการตั้งค่า ใช้ URL สาธารณะ ไม่ใช่localhost:9980: เซิร์ฟเวอร์ Nextcloud และเบราว์เซอร์ของผู้ใช้ต้องระบุปลายทาง Collabora ภายนอกเดียวกัน

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

4. ตรวจสอบเส้นทาง WOPI และเปิดเอกสารทดสอบ

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

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

หากโปรแกรมแก้ไขข้อความไม่เปิด คุณควรตรวจสอบอะไรบ้าง?

• ข้อผิดพลาดในการค้นหาหรือการเชื่อมต่อ:โปรดตรวจสอบว่าoffice.example.comสามารถระบุที่อยู่ได้จากเซิร์ฟเวอร์ Nextcloud และเบราว์เซอร์ ใบรับรองถูกต้อง และพร็อกซีส่งข้อมูล/hosting/discoveryไปยัง CODE
• โหลดไม่สิ้นสุดหรือตัวแก้ไขตัดการเชื่อมต่อ:ตรวจสอบการจัดการการอัปเกรด WebSocket ของพร็อกซีแบบย้อนกลับและ/coolเส้นทางต่างๆ ตรวจสอบบันทึกของพร็อกซีและคอนเทนเนอร์สำหรับคำขอที่ถูกปฏิเสธ
• โฮสต์ WOPI ถูกปฏิเสธ:เปรียบเทียบการตั้งค่าaliasgroup1กับต้นทางสาธารณะของ Nextcloud อย่างถูกต้อง รวมถึงรูปแบบและพอร์ต ตรวจสอบรายการอนุญาต WOPI ของ Nextcloud กับที่อยู่ IP ต้นทางของ Collabora ที่ Nextcloud มองเห็นได้
• ใช้งานได้บนโฮสต์ แต่ใช้งานไม่ได้ใน Nextcloud:ทดสอบการเชื่อมต่อจากเซิร์ฟเวอร์ Nextcloud ไปยัง URL สาธารณะของ Collabora ชื่อโฮสต์ภายในของคอนเทนเนอร์หรือที่อยู่ localhost ของโฮสต์ Docker ไม่สามารถเข้าถึงได้โดยอัตโนมัติจากทุกคอนเทนเนอร์อื่น
• คำเตือนเกี่ยวกับใบรับรอง:แก้ไขความไม่ตรงกันของห่วงโซ่ใบรับรองหรือชื่อโฮสต์ การปิดใช้งานการตรวจสอบใบรับรองอาจซ่อนสาเหตุและทำให้การเชื่อมต่ออ่อนแอลง

สำหรับการวินิจฉัย ให้เปรียบเทียบการกำหนดค่าของคุณกับตัวอย่างการติดตั้ง Nextcloud Docker อย่างเป็นทางการ คำแนะนำการกำหนดค่า Office และ WOPIและ เอกสารประกอบ อิมเมจ Docker CODEและรีเวิร์สพร็อกซี ของ Collabora เอกสารอ้างอิงเหล่านั้นมีการกำหนดเวอร์ชันและอาจมีการเปลี่ยนแปลง คำสั่งในที่นี้สะท้อนถึงตัวอย่างการดูแลระบบ Nextcloud 35 ที่มีให้ใช้งานในวันที่ 10 ตุลาคม 2026