เชื่อมต่อ 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; โปรดแทนที่ทั้งสองด้วยชื่อโฮสต์จริงของคุณ

หน้าต่างเทอร์มินัล Linux แสดงคำสั่ง docker pull collabora/code
ข้อความแจ้งในเทอร์มินัลพร้อมคำสั่งที่ใช้ดาวน์โหลดอิมเมจ Collabora CODE

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

คุณต้องมีการติดตั้ง 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 ปัจจุบัน และเลือกนโยบายการอัปเดตเวอร์ชัน/แท็กที่เหมาะสมกับกระบวนการบำรุงรักษาของคุณ การอ้างอิงอิมเมจเริ่มต้นอาจเปลี่ยนแปลงได้เมื่อมีการเผยแพร่เวอร์ชันใหม่ โปรดวางแผนการอัปเดต ตรวจสอบคอนเทนเนอร์ และทดสอบการแก้ไขเอกสารอีกครั้งหลังจากการอัปเกรด

หน้าแอปพลิเคชันการจัดการ Nextcloud โดยแสดงว่าแอป Nextcloud Office เปิดใช้งานอยู่
มุมมองการจัดการแอปแสดงว่า Nextcloud Office เปิดใช้งานอยู่ก่อนการกำหนดค่าเซิร์ฟเวอร์

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 Office โดยเลือกเซิร์ฟเวอร์ภายนอกและ URL https://office.example.com
เลือกตัวเลือกเซิร์ฟเวอร์ภายนอกและป้อน URL HTTPS สาธารณะสำหรับ Collabora

ใน 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 เห็นในบันทึกแทนการคาดเดา

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

สำหรับการตรวจสอบการทำงาน ให้ลงชื่อเข้าใช้ในฐานะผู้ใช้ 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

ฝากความเห็น

ล้างคำเตือนหน่วยความจำ PHP ของ Nextcloud บนเว็บเซิร์ฟเวอร์

ตั้งค่าขีดจำกัดหน่วยความจำ PHP ที่ Nextcloud ใช้จริง รีสตาร์ทบริการที่ถูกต้อง และยืนยันการตั้งค่า 512 MB ในภาพรวมผู้ดูแลระบบ

เชื่อมต่อ Bucket ที่เข้ากันได้กับ S3 กับพื้นที่จัดเก็บข้อมูลภายนอกของ Nextcloud

เชื่อมต่อบัคเก็ตจัดเก็บข้อมูลแบบอ็อบเจ็กต์ที่เข้ากันได้ใน Nextcloud โดยใช้แบ็กเอนด์ S3 พร้อมด้วยเอนด์พอยต์ ข้อมูลรับรอง ขอบเขตการเข้าถึง และขั้นตอนการตรวจสอบที่ถูกต้อง

ย้ายข้อมูล Nextcloud ไปยังไดรฟ์ภายนอกโดยไม่ทำให้พื้นที่จัดเก็บข้อมูลเสียหาย

ย้ายข้อมูล Nextcloud ไปยังไดรฟ์ภายนอกโดยไม่ทำให้พื้นที่จัดเก็บข้อมูลเสียหาย

ย้ายไดเร็กทอรีข้อมูล Nextcloud บน Linux ไปยังไดรฟ์ภายนอกอย่างปลอดภัย โดยใช้การเมานต์ UUID แบบถาวร โหมดบำรุงรักษา สำเนาที่ตรวจสอบแล้ว และซิมลิงก์เส้นทางเดิม

ข้อผิดพลาดฐานข้อมูล Nextcloud หลังจากการอัปเดต: ควรตรวจสอบอะไรก่อน

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

รีเซ็ตรหัสผ่านผู้ดูแลระบบ Nextcloud ที่ลืมไปโดยใช้ OCC

ใช้คำสั่ง OCC ของ Nextcloud เพื่อรีเซ็ตรหัสผ่านผู้ดูแลระบบจากเชลล์เซิร์ฟเวอร์ พร้อมคำแนะนำสำหรับชื่อผู้ใช้ สิทธิ์ และผู้ให้บริการเข้าสู่ระบบภายนอก

เพิ่มส่วนหัว HSTS ที่ปลายทาง HTTPS ที่ให้บริการ Nextcloud

ล้างคำเตือน HSTS ของ Nextcloud โดยการตั้งค่าส่วนหัวที่ Apache, NGINX หรือพร็อกซี TLS ของคุณ จากนั้นตรวจสอบการตอบสนอง HTTPS สาธารณะอย่างปลอดภัย

แก้ไขปัญหาการติดตั้งแอป Nextcloud ที่แจ้งว่าไม่มีการเชื่อมต่ออินเทอร์เน็ต

แก้ไขปัญหาการติดตั้งแอป Nextcloud ที่แจ้งว่าไม่มีการเชื่อมต่ออินเทอร์เน็ต

ตรวจสอบหาสาเหตุของการติดตั้งแอปจาก App Store ที่ล้มเหลว ไม่ว่าจะเป็นปัญหาจาก DNS, HTTPS, พร็อกซี, TLS หรือปัญหาการตั้งค่าจากเซิร์ฟเวอร์ Nextcloud เอง

แก้ปัญหา CPU กระชากเร็วใน Nextcloud Preview ด้วยคิวที่กำหนดเวลาไว้

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

รับการซิงค์ข้อมูลบนเดสก์ท็อป Nextcloud โดยไม่ต้องแสดงสถานะ “กำลังประมวลผลไฟล์” อีกต่อไป

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

ล้างคำเตือน Nextcloud OPcache โดยการปรับขีดจำกัดให้ถูกต้อง

ค้นหาข้อจำกัดของ PHP OPcache ที่ทำให้เกิดคำเตือนของ Nextcloud อัปเดตการตั้งค่า PHP สำหรับเว็บให้ถูกต้อง รีสตาร์ทอย่างปลอดภัย และตรวจสอบผลลัพธ์