วิธีปิดใช้งานการส่งข้อมูลทางไกลและการเชื่อมต่อภายนอกใน Collabora CODE

คำตอบสั้นๆ: Collabora Online Development Edition (CODE) ไม่มีสวิตช์สำหรับการส่งข้อมูลทางไกลทั่วไปที่ผู้ดูแลระบบต้องปิดใช้งานสำหรับการวิเคราะห์ตามปกติ Collabora ระบุว่า Online ที่ติดตั้งเองไม่จำเป็นต้องใช้การส่งข้อมูลทางไกลหรือการเรียกใช้ฟังก์ชันวิเคราะห์ กิจกรรมขาออกที่ควรควบคุมนั้นแยกต่างหาก ได้แก่ การตรวจสอบการอัปเดตเป็นระยะ การผสานรวมเพิ่มเติม จุดตรวจสอบ และคุณสมบัติเอกสารที่ดึงข้อมูลจากระยะไกล ปิดใช้งานคุณสมบัติเสริมที่คุณไม่ได้ใช้ จากนั้นบังคับใช้รายการที่อนุญาตการส่งออกในขณะที่ยังคงรักษาการเชื่อมต่อ WOPI กับเซิร์ฟเวอร์จัดเก็บข้อมูลของคุณไว้

ข้อความนี้ใช้กับ CODE ที่ติดตั้งเอง เช่น อินสแตนซ์ที่ผสานรวมกับ Nextcloud หรือ ownCloud การบล็อกการรับส่งข้อมูลขาออกทั้งหมดอาจทำให้การโหลดและการบันทึกเอกสารล้มเหลว เนื่องจาก CODE จำเป็นต้องติดต่อกับโฮสต์ WOPI ของตน ชื่อการกำหนดค่าด้านล่างได้รับการตรวจสอบกับเทมเพลตต้นทางของ Collabora เมื่อวันที่ 6 ตุลาคม 2026 การจัดแพ็กเกจและค่าเริ่มต้นอาจแตกต่างกันไปในแต่ละเวอร์ชัน

อะไรคือสิ่งที่เรียกว่าข้อมูลการวัดระยะทางหรือการเชื่อมต่อภายนอก?

โดยทั่วไปแล้ว Telemetry หมายถึงข้อมูลการใช้งานผลิตภัณฑ์หรือข้อมูลการวินิจฉัยที่ส่งไปยังผู้จำหน่าย Collabora ระบุว่าผลิตภัณฑ์ออนไลน์แบบโฮสต์เองของตนไม่จำเป็นต้องใช้ Telemetry, การเรียกกลับเพื่อวิเคราะห์ หรือการเชื่อมต่อกับบริการภายนอกcoolwsd.xmlเทมเพลตอัปสตรีมไม่ได้แสดงตัวเก็บรวบรวม Telemetry ทั่วโลกหรือสวิตช์ "ติดต่อกลับ"

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

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

ขั้นตอนที่ 1: ระบุจุดหมายปลายทางที่จำเป็นและจุดหมายปลายทางเสริม

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

จากนั้นตรวจสอบรายการบริการเสริมในโครงสร้างการกำหนดค่าที่มีผลบังคับใช้ของคุณ มองหา<monitors>ที่อยู่การตรวจสอบที่กำหนดค่าไว้อย่างชัดเจน ตรวจสอบการตรวจสอบการสะกดคำระยะไกล DeepL AI การกำหนดค่าฟอนต์ระยะไกล และ URL การกำหนดค่าระยะไกล ลบปลายทางที่กำหนดเองซึ่งไม่ได้เป็นส่วนหนึ่งของเวิร์กโฟลว์ที่ได้รับอนุมัติ หากจำเป็น ให้บันทึกชื่อโฮสต์และวัตถุประสงค์ก่อนที่จะสร้างข้อยกเว้นเครือข่ายที่เกี่ยวข้อง

ตรวจสอบเพิ่มเติมด้วย ส่วนlok_allowนี้จะควบคุมว่าเอกสารที่แก้ไขแล้วสามารถใช้โฮสต์ใดเป็นแหล่งข้อมูลภายนอกได้บ้าง รวมถึง URL ที่ใช้สำหรับกราฟิกที่แทรกหรือฟังก์ชันสเปรดชีต เช่น นี่WEBSERVICE()ไม่ใช่ไฟร์วอลล์แบบครอบคลุม หมายเหตุการกำหนดค่าต้นทางที่อนุญาตโฮสต์ WOPI และ POST อาจถูกพิจารณาว่าเป็นแหล่งข้อมูลที่ได้รับอนุญาตเช่นกัน ดังนั้นควรแยกนโยบายนี้ออกจากส่วนควบคุมการส่งออกเครือข่าย

ขั้นตอนที่ 2: ปิดใช้งานการตรวจสอบการอัปเดตเป็นระยะ

สำหรับคอนเทนเนอร์ Collabora CODE ให้ตั้งค่าตัวเลือกผ่านextra_paramsตัวแปรสภาพแวดล้อม ผสานค่าเหล่านั้นเข้ากับค่าที่มีอยู่เดิม โดยคงการตั้งค่าการยุติ TLS, รีเวิร์สพร็อกซี หรือการตั้งค่าโฮสต์ใดๆ ที่การติดตั้งของคุณใช้งานอยู่ ตรึงแท็กรูปภาพ CODE ที่ได้รับการอนุมัติสำหรับสภาพแวดล้อมของคุณแทนที่จะพึ่งพาlatestแท็ก ที่เปลี่ยนแปลงไปเรื่อยๆ

services:
  collabora:
    image: collabora/code:<approved-tag>
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

นี่เป็นเพียงตัวอย่างส่วนหนึ่งของการใช้งาน Docker Compose ไม่ใช่การติดตั้งใช้งานที่สมบูรณ์ โปรดคงข้อจำกัดของโดเมน ข้อมูลรับรองผู้ดูแลระบบ การตั้งค่า TLS และการกำหนดค่าพร็อกซีที่มีอยู่เดิมไว้ ใน Kubernetes นั้น Helm chart ต้นทางจะเปิดเผยcollabora.extra_paramsและรองรับcoolwsd.xmlเนื้อหาที่กำหนดเอง โปรดใช้ไฟล์ค่าและคำแนะนำสำหรับเวอร์ชัน chart ที่คุณติดตั้ง

หากคุณจัดการไฟล์ XML โดยตรง ให้ใส่ค่าต่างๆ ไว้ภายใน<config>องค์ประกอบหลักของไฟล์นั้น:

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

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

ขั้นตอนที่ 3: ปิดการใช้งานการเชื่อมต่อที่ไม่ใช้งาน และจำกัดการดึงเอกสาร

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

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

สำหรับเนื้อหาจากระยะไกลที่เอกสารร้องขอ ให้ลบโฮสต์สาธารณะออก<lok_allow>และคงไว้เฉพาะปลายทางที่ผู้ใช้ของคุณต้องการเท่านั้น อย่าลบเส้นทาง WOPI เพื่อให้ได้ผลลัพธ์นี้ WOPI คือการเชื่อมต่อพื้นที่จัดเก็บข้อมูลที่จำเป็นสำหรับการแก้ไขตามปกติ โปรดทราบด้วยว่า รายการเครือข่ายส่วนตัวที่กว้างเกินไปอาจอนุญาตให้ดึงเอกสารไปยังโฮสต์ภายในมากกว่าที่ตั้งใจไว้ ให้จำกัดขอบเขตให้แคบลงตามที่โครงสร้างเครือข่ายและเวอร์ชัน CODE ของคุณอนุญาต

ขั้นตอนที่ 4: บังคับใช้กฎการส่งออกภายนอกโค้ด

การตั้งค่าแอปพลิเคชันจะปิดใช้งานพฤติกรรมบางอย่างเท่านั้น ไม่รับประกันว่าระบบปฏิบัติการหรือกระบวนการจะไม่สามารถเปิดการเชื่อมต่ออื่นได้ เพื่อเพิ่มความปลอดภัยให้มากขึ้น ให้ใช้กฎขาออกที่ไฟร์วอลล์ของโฮสต์ เครือข่ายคอนเทนเนอร์ นโยบายเครือข่ายของ Kubernetes หรือไฟร์วอลล์ภายนอก ใช้การปฏิเสธโดยค่าเริ่มต้นสำหรับ CODE จากนั้นอนุญาตเฉพาะปลายทาง WOPI และการพึ่งพาที่ได้รับอนุมัติอย่างชัดเจนเท่านั้น อนุญาต DNS ผ่านบริการเครือข่ายที่แพลตฟอร์มของคุณใช้

ในตัวอย่างข้างต้น CODE อาจได้รับอนุญาตให้เข้าถึงcloud.example.comโปรโตคอลและพอร์ตที่กำหนดค่าไว้สำหรับ WOPI ในขณะที่ปลายทางสาธารณะที่ไม่เกี่ยวข้องจะถูกปฏิเสธ หลีกเลี่ยงการใช้ IP ที่กำหนดไว้ตายตัวเมื่อโฮสต์จัดเก็บข้อมูลอยู่หลังโหลดบาลานเซอร์หรือมีที่อยู่เปลี่ยนแปลง กลุ่มปลายทางที่ได้รับการดูแลรักษาหรือพร็อกซีขาออกที่ควบคุมได้จะจัดการได้ง่ายกว่า ตรวจสอบให้แน่ใจว่าได้กำหนดค่าพร็อกซีอย่างสม่ำเสมอสำหรับคอนเทนเนอร์

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

ขั้นตอนที่ 5: รีสตาร์ทและตรวจสอบนโยบาย

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

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

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

การปิดใช้งานการเชื่อมต่อเหล่านี้สามารถรับประกันอะไรได้บ้าง และรับประกันอะไรไม่ได้บ้าง

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

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