วิธีการติดตั้ง Collabora Online CODE ด้วย Docker และ Nextcloud

ตัวอย่างประกอบ:ลองนึกภาพทีมเล็กๆ ทีมหนึ่งที่จัดเก็บไฟล์ Nextcloud ไว้ที่https://cloud.example.com. ผู้ดูแลระบบต้องการเซิร์ฟเวอร์ Collabora Online Development Edition (CODE) แยกต่างหากที่https://office.example.com. นี่เป็นเพียงตัวอย่างการตั้งค่าเพื่ออธิบายขั้นตอน ไม่ใช่รายงานการติดตั้งจริง โปรดแทนที่ชื่อโฮสต์ตัวอย่างทั้งสองด้วยโดเมนที่คุณควบคุม

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

ก่อนที่คุณจะเริ่มต้น

ในตัวอย่างนี้ สมมติว่าโฮสต์ Linux สามารถรัน Docker ได้ Nextcloud ก็ทำงานผ่าน HTTPS อยู่แล้ว และระเบียน DNS สำหรับชื่อโฮสต์ทั้งสองชี้ไปยังเซิร์ฟเวอร์ที่ถูกต้อง ขอใบรับรอง TLS ที่ถูกต้องสำหรับoffice.example.comชื่อโฮสต์นั้น วางแผนที่จะเปิดเผยบริการ Collabora ผ่านชื่อโฮสต์นั้น แทนที่จะเปิดพอร์ต Docker ไปยังอินเทอร์เน็ตสาธารณะโดยตรง

• ตรวจสอบให้แน่ใจว่าโฮสต์ CODE สามารถแก้ไขและเชื่อมต่อกับcloud.example.com.
• ตรวจสอบให้แน่ใจว่าเบราว์เซอร์สามารถเข้าถึงได้https://office.example.comผ่าน HTTPS
• เลือกได้ว่าจะให้ Reverse Proxy ทำงานบนโฮสต์ Docker หรือที่อื่น Proxy ที่อยู่บนโฮสต์เดียวกันสามารถใช้พอร์ตคอนเทนเนอร์ที่เผยแพร่ผ่าน Loopback ได้ ส่วน Proxy ในคอนเทนเนอร์อื่นจำเป็นต้องเข้าถึงเครือข่าย Docker ที่ใช้ร่วมกันได้ หรือเส้นทางส่วนตัวอื่น
• ตรวจสอบเอกสาร CODE และ Nextcloud ฉบับปัจจุบันเพื่อดูความเข้ากันได้และข้อกำหนดเกี่ยวกับพร็อกซี ก่อนนำไปใช้งานจริง CODE เป็นเวอร์ชันสำหรับการพัฒนา ทีมที่ต้องการความเสถียรหรือการสนับสนุนจากผู้จำหน่าย ควรพิจารณาเลือกใช้ Collabora Online เวอร์ชันที่มีการสนับสนุนอย่างเป็นทางการ

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

1. ชี้ชื่อโฮสต์ของสำนักงานไปยังเซิร์ฟเวอร์ของคุณ

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

อย่าคัดลอกโค้ดพร็อกซีทั่วไปโดยไม่คิดไตร่ตรอง พร็อกซีต้องรองรับการอัปเกรด WebSocket รักษาข้อมูลโฮสต์และโปรโตคอลที่ส่งต่อที่จำเป็น และส่งผ่านเส้นทาง Collabora เช่น/browser, /hosting/discovery, และ/coolคำสั่งที่แน่นอนจะแตกต่างกันไปตาม Apache, NGINX, Traefik และเกตเวย์อื่นๆ หากพร็อกซีทำงานบนโฮสต์ Docker การส่งต่อไปยัง127.0.0.1:9980เป็นเป้าหมายส่วนตัวทั่วไป หากเป็นคอนเทนเนอร์แยกต่างหาก ที่อยู่ลูปแบ็กนั้นจะหมายถึงคอนเทนเนอร์พร็อกซีเอง ไม่ใช่โฮสต์ CODE

2. เริ่มใช้งานคอนเทนเนอร์ Docker ของ CODE

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

docker pull collabora/code

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

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

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

3. ตั้งค่ารีเวิร์สพร็อกซีและตรวจสอบรหัส

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

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

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

docker ps --filter name=collabora
docker logs --tail=100 collabora

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

4. เชื่อมต่อ Nextcloud กับ Collabora

ใน Nextcloud ให้เปิดพื้นที่แอปพลิเคชัน แล้วติดตั้งหรือเปิดใช้งานการผสานรวม Office ที่มีให้สำหรับเวอร์ชันของคุณ ชื่อแอปอาจเป็น “Nextcloud Office” หรือ “Collabora Online” ขึ้นอยู่กับเวอร์ชันและแคตตาล็อกแอปที่ติดตั้ง จากนั้นเปิดการตั้งค่าการดูแลระบบสำหรับ Office แล้วป้อน:

https://office.example.com

บันทึกการตั้งค่าและตรวจสอบสถานะการเชื่อมต่อเอกสารการกำหนดค่า Office ของ Nextcloud ระบุว่าฟิลด์นี้คือ URL และพอร์ตของเซิร์ฟเวอร์ Collabora และแนะนำให้ใช้ HTTPS ใช้ URL สาธารณะของ Collabora ที่เบราว์เซอร์สามารถเข้าถึงได้ ในการติดตั้งแบบ split-DNS, NAT หรือเครือข่ายแบบแบ่งส่วน Nextcloud อาจต้องการเส้นทางภายในไปยังบริการนั้นด้วย โปรดดูตัวเลือกการเชื่อมต่อขั้นสูงสำหรับเวอร์ชันแอปที่ติดตั้งไว้ แทนที่จะสันนิษฐานว่า DNS สาธารณะใช้งานได้จากเซิร์ฟเวอร์

ตัวอย่างเช่น Nextcloud จะมองcloud.example.comเห็นโฮสต์ WOPI ที่ได้รับอนุญาตเป็น และเบราว์เซอร์ของผู้ใช้จะเปิดโปรแกรมแก้ไขจากoffice.example.comหากหน้าการจัดการ Nextcloud ของคุณมีรายการอนุญาตคำขอ WOPI ให้จำกัดรายการนั้นให้เหลือเฉพาะที่อยู่เซิร์ฟเวอร์ Collabora ที่คาดไว้หลังจากยืนยันที่อยู่เหล่านั้นในเครือข่ายของคุณแล้ว Nextcloud แนะนำให้จำกัดคำขอ WOPI ให้เหลือเฉพาะโฮสต์ Collabora ที่คาดไว้เท่านั้น อย่าเพิ่มช่วงกว้างๆ โดยไม่มีเหตุผลเฉพาะเจาะจงเกี่ยวกับเครือข่าย

5. ทดสอบด้วยเอกสารตัวอย่าง

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

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

ปัญหาที่พบได้บ่อยและสิ่งที่ควรตรวจสอบ

Nextcloud แจ้งว่าไม่สามารถเข้าถึงเซิร์ฟเวอร์ได้

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

หน้าเว็บเปิดขึ้น แต่โปรแกรมแก้ไขเอกสารค้างอยู่

ตรวจสอบบันทึกการเข้าถึงและข้อผิดพลาดของรีเวิร์สพร็อกซีเพื่อหาความล้มเหลวในการอัปเกรด WebSocket ยืนยันว่าพร็อกซีส่งต่อเส้นทาง Collabora ปัจจุบันและรักษาการเชื่อมต่อ WebSocket ที่ใช้งานมานานให้เปิดอยู่ เครื่องมือสำหรับนักพัฒนาเบราว์เซอร์สามารถแสดงได้ว่าคำขอ WebSocket ถูกปฏิเสธ ถูกเปลี่ยนเส้นทางไปยัง HTTP หรือถูกบล็อกโดยข้อผิดพลาดของใบรับรอง

Collabora ปฏิเสธโฮสต์ Nextcloud

เปรียบเทียบต้นทางของ Nextcloud ที่แท้จริง รวมถึง scheme, hostname และ port กับกลุ่ม alias ที่กำหนดค่าไว้ ความไม่ตรงกันระหว่าง URL สาธารณะ hostname ภายใน และ proxy rewrite อาจทำให้เกิดข้อผิดพลาดในการตรวจสอบสิทธิ์ host หรือ WOPI เพิ่มเฉพาะ hostname ของ Nextcloud ที่ต้องการลงในการกำหนดค่าที่อนุญาตเท่านั้น

โปรแกรม CODE เริ่มทำงานแล้วก็หยุดทำงาน หรือเกิดภาวะผิดปกติขึ้น

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

การอัปเดตและการดูแลการดำเนินงาน

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

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

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

• คู่มือการใช้งาน Nextcloud 35: การติดตั้งใน Office
• คู่มือการดูแลระบบ Nextcloud: ตัวอย่างการติดตั้ง Docker และเส้นทางพร็อกซีของ Apache
• คู่มือการใช้งาน Nextcloud 35: การกำหนดค่า Office และคำแนะนำเกี่ยวกับ WOPI
• Collabora Online: อิมเมจ Docker ของ CODE
• Collabora Online: การตั้งค่าพร็อกซีแบบย้อนกลับ

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