เชื่อมต่อ Seafile และ Collabora ด้วย URL WOPI ที่ถูกต้อง

ในการเชื่อมต่อ Seafile กับ Collabora Online ให้เปิดใช้งาน HTTPS บน Seafile จากนั้นติดตั้ง Collabora และกำหนดให้การผสานรวม Office ของ Seafile ชี้ไปยังปลายทางการค้นหาของ Collabora หากทั้งสองบริการทำงานบนเครือข่าย Docker เดียวกัน คู่มือการผสานรวมปัจจุบันของ Seafile จะใช้ URL ภายในhttp://collabora:9980/hosting/discoveryหาก Collabora ทำงานบนโฮสต์ที่แยกต่างหาก ให้ใช้ URL HTTPS สาธารณะแทน

คู่มือผู้ดูแลระบบ Seafile ฉบับปัจจุบันได้บันทึกcollabora.ymlการผสานรวม Compose และการตั้งค่าไว้ในไฟล์seahub_settings.py.seafile.com โดยเฉพาะ ไฟล์การปรับใช้ที่แน่นอนอาจแตกต่างกันไปตามเวอร์ชันของ Seafile ดังนั้นโปรดใช้คู่มือที่ตรงกับเวอร์ชันที่คุณติดตั้งเมื่อปรับใช้ตัวอย่างเหล่านี้

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

• ใช้ที่อยู่เว็บ Seafile แบบ HTTPS ที่มีใบรับรอง TLS ที่ถูกต้อง Seafile ระบุว่า HTTPS เป็นข้อกำหนดที่จำเป็นสำหรับการผสานรวมกับ Collabora
• ตรวจสอบว่า Collabora จะทำงานเป็นคอนเทนเนอร์อีกตัวบนโฮสต์ Docker เดียวกัน หรือเป็นบริการที่โฮสต์แยกต่างหาก
• ต้องมีสิทธิ์ผู้ดูแลระบบในการเข้าถึงไดเร็กทอรีการปรับใช้ของ Seafile และseahub_settings.py.
• เลือกรูปแบบเอกสารที่ต้องการอนุญาตให้ดูตัวอย่างและแก้ไข การตั้งค่าของ Seafile จะควบคุมรายการนามสกุลไฟล์เหล่านี้

Seafile และ Collabora สื่อสารกันโดยใช้ WOPI โดย Seafile จะส่งข้อมูลการเข้าถึงเอกสาร และ Collabora จะร้องขอไฟล์จาก Seafile ส่วน URL สำหรับการค้นหาจะบอก Seafile ว่าควรใช้บริการใดของ Collabora และฟังก์ชันการแก้ไขใดที่บริการนั้นโฆษณาไว้

1. ยืนยันว่า Seafile ใช้ HTTPS

เปิด Seafile ในเบราว์เซอร์และตรวจสอบให้แน่ใจว่าที่อยู่ปกติของเว็บไซต์ขึ้นต้นด้วยhttps://และใบรับรองถูกต้อง สำหรับการใช้งาน Seafile บน Docker คู่มือปัจจุบันแสดงการตั้งค่าSEAFILE_SERVER_PROTOCOL=httpsใน.envไฟล์ จากนั้นจึงทำการตั้งค่า HTTPS ให้เสร็จสมบูรณ์ผ่านทางพร็อกซีแบบย้อนกลับที่กำหนดค่าไว้ อย่าดำเนินการต่อด้วยปลายทาง Seafile สาธารณะแบบ HTTP ธรรมดา

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

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

2. เพิ่ม Collabora ลงในการใช้งาน Docker ของ Seafile

สำหรับการตั้งค่า Docker บนโฮสต์เดียวกันตามเอกสาร ให้ใช้ไฟล์ Collabora Compose ที่ Seafile จัดหาให้ แทนที่จะสร้างคำจำกัดความคอนเทนเนอร์ที่ไม่เกี่ยวข้อง ในไดเร็กทอรีการปรับใช้ของ Seafile ให้ดาวน์โหลดไฟล์สำหรับเวอร์ชันคู่มือที่ตรงกัน และเพิ่มลงcollabora.ymlในCOMPOSE_FILEรายการที่มีอยู่แล้วใน.env. เก็บรักษาไฟล์ Compose ที่ใช้แล้วในการติดตั้งของคุณไว้

# Example for a Seafile 14.0 deployment
wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

ตั้งค่าตัวแปร Collabora ตามที่ Seafile ได้ระบุไว้ในเอกสารดังนี้.env:

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=your_admin_username
COLLABORA_PASSWORD=use_a_long_unique_secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_ENABLE_FILE_LOGGING=false

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

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

3. ตั้งค่า Seafile ให้ชี้ไปยัง URL การค้นหาของ Collabora

แก้ไขseahub_settings.pyไฟล์ที่ใช้งานอยู่และเพิ่มการตั้งค่าการผสานรวม สำหรับการตั้งค่า 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_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

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

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

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

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

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

4. รีสตาร์ทและทดสอบการเชื่อมต่อ

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

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

แก้ไขปัญหาโดยตรวจสอบการเชื่อมต่อแต่ละจุด

• Seahub รายงานข้อผิดพลาดในการค้นหา:ยืนยันว่าOFFICE_WEB_APP_BASE_URLสามารถเข้าถึงได้จากบริการ Seafile ใช้ชื่อบริการ Docker ภายในเฉพาะเมื่อคอนเทนเนอร์ทั้งสองใช้เครือข่ายเดียวกันเท่านั้น
• โปรแกรมแก้ไขโหลดขึ้นมา แต่ไม่สามารถดึงไฟล์ได้:ตรวจสอบบันทึกของ Collabora และบันทึกของ Seafile ยืนยันว่า Collabora อนุญาตให้โฮสต์ WOPI ของ Seafile ใช้งานได้ และใบรับรอง HTTPS ของ Seafile เชื่อถือได้
• ใช้งานได้บนโฮสต์เดียวกัน แต่ใช้งานไม่ได้จากระยะไกล:แทนที่ URL ภายในด้วย URL การค้นหา HTTPS สาธารณะ ยืนยัน DNS และ TLS และตรวจสอบว่าพร็อกซีส่งต่อคำขอ Collabora ไปยังพอร์ต 9980
• เปิดใช้งานเฉพาะบางรูปแบบเท่านั้น:ตรวจสอบOFFICE_WEB_APP_FILE_EXTENSIONและOFFICE_WEB_APP_EDIT_FILE_EXTENSION. จำกัดรายการเหล่านี้ให้เหลือเฉพาะรูปแบบที่ผู้ใช้ของคุณต้องการและที่การใช้งาน Collabora ของคุณรองรับ
• การตั้งค่าดูเหมือนจะไม่เปลี่ยนแปลงหลังจากรีสตาร์ท:โปรดยืนยันว่าคุณได้แก้ไขseahub_settings.pyและรีสตาร์ทบริการ Seafile ที่ถูกต้องแล้ว

สำหรับโหนด Collabora แบบสแตนด์อโลน Seafile แนะนำให้ผู้ดูแลระบบศึกษาเอกสารการติดตั้งใช้งานของ Collabora แทนที่จะใช้ ไฟล์ที่มาพร้อมกับแพ็กเก collabora.ymlจ ไฟล์ที่มาพร้อมกับแพ็กเกจนั้นมีไว้สำหรับใช้งานบนโฮสต์/เครือข่าย Docker แบบเดียวกับที่อธิบายไว้ข้างต้น

ข้อมูลอ้างอิงอย่างเป็นทางการ

• คู่มือผู้ดูแลระบบ Seafile: การผสานรวม Collabora Online
• Seafile 14.0 ไฟล์เขียน Collabora
• เอกสารประกอบการใช้งานอิมเมจ Docker ของ Collabora CODE