วิธีเชื่อมต่อ Collabora Online กับ Seafile: ตัวเลือกและขั้นตอนการตั้งค่า

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

คู่มือนี้อ้างอิงตามคำแนะนำการผสานรวม Collabora ในคู่มือผู้ดูแลระบบ Seafile ฉบับปัจจุบัน (เอกสาร Seafile 14.0 ตรวจสอบเมื่อวันที่ 6 ตุลาคม 2026) ไฟล์ Docker Compose และแท็กรูปภาพอาจมีการเปลี่ยนแปลง ดังนั้นโปรดใช้ไฟล์สำหรับเวอร์ชัน Seafile ที่คุณติดตั้งไว้ แทนที่จะคัดลอกการกำหนดค่า Compose ทั้งหมดจากคู่มือฉบับเก่า

คุณควรเลือกวิธีการติดตั้งแบบใด?

สำหรับการติดตั้ง Docker แบบโหนดเดียวใหม่ ให้เริ่มต้นด้วยไฟล์ที่ Seafile จัดเตรียมไว้ให้collabora.ymlสำหรับเซิร์ฟเวอร์ Collabora แบบสแตนด์อโลนหรือคลัสเตอร์ที่มีอยู่แล้ว ให้ใช้คำแนะนำการติดตั้งของ Collabora เอง และตั้งค่า URL การค้นหาของ Seafile ไปยังที่อยู่ภายนอกของ Collabora คู่มือการรวมระบบของ Seafile กำหนดให้ใช้ HTTPS สำหรับ Seafile และระบุว่าโหนด Collabora แยกต่างหากควรใช้ HTTPS บนพอร์ตมาตรฐาน 443 โดยใช้ reverse-proxy ไปยังบริการของ Collabora บนพอร์ต 9980 ดูคู่มือการรวมระบบออนไลน์ของ Seafile กับ Collaboraและเอกสารการติดตั้ง Collabora

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

• ตรวจสอบให้แน่ใจว่าเซิร์ฟเวอร์ Seafile ของคุณสามารถเข้าถึงได้ผ่าน HTTPS โดยใช้ใบรับรองที่ถูกต้อง คู่มือของ Seafile ระบุไว้อย่างชัดเจนว่าต้องใช้ HTTPS สำหรับการผสานรวมนี้
• ระบุประเภทการใช้งานของคุณ: Docker แบบโหนดเดียวในปัจจุบัน การติดตั้งแบบไบนารี หรือการตั้งค่าแบบหลายโฮสต์/คลัสเตอร์ การตั้งชื่อไฟล์และการกำหนดเส้นทางพร็อกซีจะขึ้นอยู่กับตัวเลือกนั้น
• เลือกชื่อโฮสต์ของ Collabora เช่นoffice.example.comหากผู้ใช้จะเข้าถึง Collabora โดยตรงจากเบราว์เซอร์ ตรวจสอบให้แน่ใจว่า DNS และใบรับรอง TLS ทำงานได้ก่อนที่จะกำหนดค่า Seafile
• ควรมีสิทธิ์ผู้ดูแลระบบในการเข้าถึงไฟล์ Seafile seahub_settings.pyและไฟล์ Docker .env(ถ้ามี) เก็บรหัสผ่านผู้ดูแลระบบ Collabora ไว้ในไฟล์สภาพแวดล้อมที่ได้รับการป้องกัน และห้ามเผยแพร่ในภาพหน้าจอ บันทึก หรือที่เก็บข้อมูลสาธารณะ

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

ตัวเลือก A: เพิ่ม Collabora ลงในการใช้งาน Docker ของ Seafile

1. เพิ่มไฟล์ Collabora Compose อย่างเป็นทางการ

จากไดเร็กทอรีที่เก็บไฟล์การกำหนดค่า Seafile Compose ของคุณ ให้ดาวน์โหลดไฟล์ Collabora สำหรับเวอร์ชัน Seafile ที่คุณใช้งาน สำหรับเส้นทางของ Seafile 14.0 ในคู่มือฉบับปัจจุบัน:

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

เปิด.envและเพิ่มไฟล์ลงcollabora.ymlในCOMPOSE_FILEรายการที่มีอยู่แล้ว รักษาข้อมูลรายการปัจจุบันทั้งหมดไว้ ตัวอย่างเช่น การติดตั้งที่ระบุไฟล์ Seafile server, Caddy และ SeaDoc ไว้แล้ว จะเพิ่มไฟล์ Collabora เข้าไปแทนที่จะแทนที่รายการเดิม:

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

รายชื่อจริงของคุณอาจแตกต่างออกไป อย่าลบ reverse proxy หรือบริการอื่นๆ ที่มีอยู่เพียงเพื่อให้ตรงกับตัวอย่างนี้ ไฟล์ Compose จะกำหนดค่าคอนเทนเนอร์และการตั้งค่าเครือข่ายตามที่การติดตั้งแบบรวมของ Seafile ต้องการ

2. ตั้งค่าค่าสภาพแวดล้อมของ Collabora

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

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

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

3. ตั้งค่าการเชื่อมต่อ WOPI ของ Seafile

แก้ไขseahub_settings.pyและเพิ่มการตั้งค่าการผสานรวม Collabora สำหรับคอนเทนเนอร์ที่อยู่ในเครือข่าย Compose เดียวกัน ตัวอย่างปัจจุบันของ Seafile จะใช้ชื่อบริการภายในดังนี้collabora:

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60
OFFICE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

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

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

4. เริ่มหรืออัปเดตบริการ

ตรวจสอบความถูกต้องของการตั้งค่า Compose จากนั้นเริ่มใช้งาน Stack จากไดเร็กทอรีโปรเจ็กต์:

docker compose config
docker compose up -d

คู่มือของ Seafile ระบุว่าให้รีสตาร์ท Seafile หลังจากทำการเปลี่ยนแปลงแล้วseahub_settings.pyสำหรับการใช้งาน Docker docker compose up -dการตั้งค่า Compose ที่อัปเดตแล้วจะถูกนำไปใช้ หากการแก้ไขการตั้งค่าไม่มีผล ให้รีสตาร์ทบริการ Seafile โดยใช้วิธีการสำหรับเวอร์ชันของคุณ หลีกเลี่ยงการรีสตาร์ทแบบกว้างๆdocker compose downเว้นแต่คุณตั้งใจจะหยุดระบบทั้งหมด

ตัวเลือก B: ตั้งค่า Seafile ให้เชื่อมต่อกับ Collabora บนโฮสต์อื่น

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

คงค่าการตั้งค่า Seafile อื่นๆ จากส่วนก่อนหน้าไว้ แต่เปลี่ยนการตั้งค่าการค้นหาเป็นชื่อโฮสต์ Collabora จริง:

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

ใช้ชื่อโฮสต์และใบรับรองจริงของคุณ อย่าใส่ชื่อบริการภายในของ Docker เว้นแต่ว่า Seafile และ Collabora จะใช้เครือข่ายร่วมกันอย่างแท้จริงและชื่อนั้นสามารถใช้งานได้ การมีโฮสต์แยกต่างหากจะช่วยให้คุณควบคุมทรัพยากรและการบำรุงรักษาได้อย่างอิสระ แต่จะเพิ่มภาระงานด้าน DNS, ไฟร์วอลล์, ใบรับรอง และพร็อกซีแบบย้อนกลับ สำหรับคลัสเตอร์ Seafile ให้ปฏิบัติตามการออกแบบพร็อกซีและการค้นหาบริการของคลัสเตอร์แทนที่จะสันนิษฐานว่าเครือข่าย Compose แบบโหนดเดียวสามารถใช้งานได้

วิธีตรวจสอบว่าการเชื่อมต่อใช้งานได้หรือไม่

1. หากใช้โฮสต์แยกต่างหาก ให้เปิดhttps://office.example.com/hosting/discoveryจากเบราว์เซอร์ สำหรับการตั้งค่าบนโฮสต์เดียวกัน ให้ทดสอบเส้นทาง Collabora สาธารณะที่เผยแพร่โดยพร็อกซีของคุณ การตอบสนองที่สำเร็จจะยืนยันว่าสามารถเข้าถึงปลายทางการค้นหาได้ แต่ไม่ได้พิสูจน์ว่าการแก้ไข WOPI ทำงานได้โดยอัตโนมัติ
2. ลงชื่อเข้าใช้ Seafile และเปิดไฟล์ขนาดเล็กที่ไม่เป็นความลับ เช่น ไฟล์ .pdf .docxหรือ.xlsxไฟล์.odt.pdf ซึ่งอยู่ในรายการส่วนขยายที่คุณกำหนดค่าไว้
3. ตรวจสอบให้แน่ใจว่าไฟล์เปิดใน Collabora แล้ว ทำการเปลี่ยนแปลงที่ไม่ก่อให้เกิดอันตราย รอจนกว่าการบันทึกจะเสร็จสมบูรณ์ และปิดโปรแกรมแก้ไข
4. เปิดไฟล์นั้นอีกครั้งใน Seafile และตรวจสอบว่าการเปลี่ยนแปลงได้รับการบันทึกแล้วหรือไม่ เพื่อการตรวจสอบที่เข้มงวดมากขึ้น ให้ดาวน์โหลดสำเนาและยืนยันเนื้อหาที่คาดหวังไว้

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

ข้อผิดพลาดที่พบบ่อยและควรตรวจสอบด้านใด

สำหรับบันทึก Docker โปรดดูเอกสาร Seafile docker logs seafile-collaboraตรวจสอบบันทึก Seafile/Seahub ควบคู่ไปกับเอาต์พุต Collabora และเชื่อมโยงคำขอที่เกิดขึ้นที่พร็อกซี อย่าเปิดใช้งานการบันทึกแบบละเอียดหรือการบันทึกไฟล์อย่างไม่มีกำหนด หากการกระทำดังกล่าวเปิดเผย URL ของเอกสารหรือรายละเอียดการทำงานที่ละเอียดอ่อนอื่นๆคู่มือการแก้ไขปัญหาอย่างเป็นทางการของ Collaboraมีการตรวจสอบเพิ่มเติมสำหรับความล้มเหลวฝั่ง Collabora

ตัวเลือกไหนสมเหตุสมผลกว่ากัน?

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