วิธีการสำรองข้อมูลและกู้คืนไฟล์การกำหนดค่า Collabora CODE อย่างปลอดภัย

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

ส่วนหลักที่ได้รับการตรวจสอบแล้วนั้นตรงไปตรงมา: ไฟล์การกำหนดค่าเซิร์ฟเวอร์หลักของ Collabora คือ `<div class="document.js">` /etc/coolwsd/coolwsd.xmlซึ่งรวมถึงภายในคอนเทนเนอร์ CODE อย่างเป็นทางการด้วย เอกสาร Docker อย่างเป็นทางการยังรองรับการคัดลอกไฟล์นั้นออกจากคอนเทนเนอร์ คัดลอกกลับเข้าไป หรือเชื่อมต่อ (bind-mount) จากโฮสต์ ส่วนที่แตกต่างกันคือทุกอย่างรอบข้าง: ตัวแปรสภาพแวดล้อมของ Docker, การเชื่อมต่อ (bind mounts), คีย์ตรวจสอบ WOPI, การยุติ TLS และการกำหนดค่าพร็อกซีแบบย้อนกลับ

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

การสำรองข้อมูล Collabora CODE ควรประกอบด้วยอะไรบ้าง?

ยืนยันแล้ว: /etc/coolwsd/coolwsd.xmlไฟล์นี้เป็นไฟล์การกำหนดค่าหลักของ Collabora Online Collabora ระบุเส้นทางนี้ไว้โดยตรงและอธิบายว่าไฟล์นี้มีข้อมูลครบถ้วนในตัวเองสำหรับตัวเลือกเซิร์ฟเวอร์ที่มีอยู่ ดู คู่มือ SDK อย่างเป็นทางการ ของCollabora Online

ขึ้นอยู่กับการใช้งาน:การกู้คืนอย่างสมบูรณ์อาจต้องใช้การกำหนดค่าที่ใช้ในการเริ่มต้นบริการด้วย สำหรับ Docker นั้น อาจรวมถึงไฟล์ Compose YAML, ตัวแปรสภาพแวดล้อม, bind mount, ข้อมูลลับ และไฟล์ที่เชื่อมต่อจากโฮสต์ สำหรับการติดตั้งแบบดั้งเดิม อาจรวมถึง virtual host แบบ reverse-proxy และใบรับรอง หากมีการจัดการสิ่งเหล่านั้นบนเซิร์ฟเวอร์เดียวกัน

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

ความเข้าใจผิดทั่วไปก่อนเริ่มต้น

การสำรองข้อมูล coolwsd.xml จะไม่สำรองข้อมูลเอกสารของผู้ใช้

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

ขั้นตอนการดำเนินการ:สำรองข้อมูลโฮสต์ WOPI และที่เก็บข้อมูลโดยใช้ขั้นตอนการสำรองข้อมูลของผลิตภัณฑ์นั้นๆ ถือว่าการสำรองข้อมูล CODE นี้เป็นการสำรองข้อมูลการกำหนดค่าบริการ

คอนเทนเนอร์ Docker ไม่ใช่ระบบสำรองข้อมูล

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

ขั้นตอนการดำเนินการ:บันทึกคำจำกัดความการปรับใช้และไฟล์ที่เชื่อมต่อกับโฮสต์ ไม่ใช่แค่ระบบไฟล์ของคอนเทนเนอร์เท่านั้น

การคัดลอกไฟล์ coolwsd.xml เวอร์ชันเก่าทับเวอร์ชันใหม่กว่านั้น ไม่ใช่วิธีการกู้คืนที่ปลอดภัยเสมอไป

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

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

ขั้นตอนที่ 1: บันทึกเวอร์ชันที่ติดตั้งและประเภทการปรับใช้

เริ่มต้นด้วยการบันทึกข้อมูลให้เพียงพอเพื่อจำลองสภาพแวดล้อม สำหรับการใช้งานคอนเทนเนอร์ ให้ตรวจสอบคอนเทนเนอร์ที่กำลังทำงานอยู่และอิมเมจของคอนเทนเนอร์นั้น:

docker ps --filter name=collabora
docker inspect collabora --format '{{.Config.Image}}'
docker inspect collabora --format '{{json .Mounts}}'

หากคอนเทนเนอร์ของคุณใช้ชื่ออื่น โปรดเปลี่ยนcollaboraให้เหมาะสม อิมเมจอย่างเป็นทางการเผยแพร่ในชื่อcollabora/code; ปัจจุบัน Docker Hub ระบุอิมเมจ 26.04.4.2 ในเวอร์ชันล่าสุด ดูอิมเมจ Collabora CODE อย่างเป็นทางการบน Docker Hub

สำหรับการติดตั้งแพ็กเกจแบบเนทีฟ ให้บันทึกเวอร์ชันของแพ็กเกจด้วยตัวจัดการแพ็กเกจที่คุณใช้งานจริง ตัวอย่างเช่น ใน Debian หรือ Ubuntu:

dpkg-query -W 'coolwsd*' 'collaboraoffice*' 2>/dev/null

ขั้นตอน:บันทึกผลลัพธ์เวอร์ชันลงในไดเร็กทอรีสำรองข้อมูลที่ได้รับการป้องกันเดียวกันกับไฟล์เก็บถาวรการกำหนดค่า

ขั้นตอนที่ 2: สำรองข้อมูลการกำหนดค่าหลักและข้อมูลเมตาการปรับใช้

การติดตั้งแพ็กเกจดั้งเดิม

สร้างไดเร็กทอรีสำรองที่เข้าถึงได้เฉพาะผู้ใช้ root เท่านั้น และเก็บถาวร/etc/coolwsdไดเร็กทอรีทั้งหมดแทนที่จะเลือกเฉพาะไฟล์ XML หลัก วิธีนี้จะช่วยรักษาไฟล์เพิ่มเติมใดๆ ที่แพ็กเกจที่ติดตั้งหรือการปรับแต่งในเครื่องของคุณได้วางไว้ที่นั่น

sudo install -d -m 700 /var/backups/collabora
sudo tar -C /etc -czpf \
  /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  coolwsd

คำสั่งนี้จงใจเปลี่ยนไปใช้/etcก่อนการจัดเก็บ เพื่อให้ไฟล์เก็บถาวรมีcoolwsd/เส้นทางสัมพัทธ์แทนที่จะเป็นเส้นทางสัมบูรณ์ของระบบไฟล์

Docker หรือ Docker Compose

เอกสารของ Collabora ระบุว่าอิมเมจอย่างเป็นทางการนั้นมีข้อมูลอยู่/etc/coolwsd/coolwsd.xmlและผู้ดูแลระบบสามารถคัดลอก แก้ไข คัดลอกกลับ หรือติดตั้งจากภายนอกคอนเทนเนอร์ได้

หากไฟล์ยังไม่ได้ถูกเชื่อมต่อ (bind-mount) จากเครื่องโฮสต์ ให้คัดลอกไฟล์นั้นออกมา:

sudo install -d -m 700 /var/backups/collabora
docker cp collabora:/etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/coolwsd.xml

ขั้นตอนต่อไป ให้บันทึกวิธีการตั้งค่าคอนเทนเนอร์:

docker inspect collabora --format '{{json .Config.Env}}' \
  > /var/backups/collabora/container-env.json

docker inspect collabora --format '{{json .Mounts}}' \
  > /var/backups/collabora/container-mounts.json

ข้อสำคัญ:ข้อมูลที่ได้จากคำสั่ง environment อาจมีรหัสผ่าน ข้อมูลประจำตัวของผู้ดูแลระบบ ชื่อโฮสต์ หรือข้อมูลลับอื่นๆ โปรดเก็บไฟล์เหล่านี้ให้สามารถเข้าถึงได้โดยผู้ใช้ root เท่านั้น และเข้ารหัสหรือปกป้องสำเนาที่เก็บไว้ภายนอกเครื่อง

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

ขั้นตอนการดำเนินการ:ตรวจสอบให้แน่ใจว่าการสำรองข้อมูลของคุณรวมถึงแหล่งข้อมูลที่ถูกต้อง หากcoolwsd.xmlมีการเมานต์แบบ bind-mount ให้สำรองไฟล์ host หากมีการกำหนดค่าผ่านตัวแปรสภาพแวดล้อม ให้เก็บรักษาการกำหนดค่า Compose/run ที่กำหนดตัวแปรเหล่านั้นไว้

ขั้นตอนที่ 3: ใส่ข้อมูล Proof Keys, Proxy Configuration และ TLS เฉพาะเมื่อจำเป็นเท่านั้น

ส่วนประกอบเหล่านี้มีความสำคัญอย่างยิ่ง เนื่องจากในแต่ละการติดตั้ง ส่วนประกอบเหล่านี้จะไม่เหมือนกันทุกประการ

คีย์พิสูจน์ WOPI:เอกสารของ Collabora ระบุว่าการติดตั้งแบบ RPM และ DEB จะสร้างคู่คีย์พิสูจน์ WOPI โดยอัตโนมัติ สำหรับ Docker คู่คีย์ไม่ได้รวมอยู่ในอิมเมจสาธารณะ เมื่อใช้งาน จะต้องสร้างและส่งไปยังคอนเทนเนอร์ โดยทั่วไปผ่านทางวอลุ่ม คู่มือcoolconfig generate-proof-keyจะอธิบายวิธีการสร้างคีย์ เนื่องจากคีย์ Docker อยู่ภายนอกอิมเมจที่ไม่สามารถเปลี่ยนแปลงได้ การสูญเสียคีย์ที่ติดตั้งไว้ฝั่งโฮสต์อาจเปลี่ยนแปลงข้อมูลประจำตัวที่ใช้สำหรับการลงนามพิสูจน์ WOPI ได้

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

พร็อกซีแบบย้อนกลับ: Apache, Nginx, HAProxy, Traefik หรือพร็อกซีอื่นๆ อาจเก็บชื่อโฮสต์สาธารณะ การยุติ TLS การกำหนดเส้นทาง WebSocket และกฎการส่งต่อคำขอ ใน CODE 26.04 Collabora ได้อัปเดตคำแนะนำเกี่ยวกับพร็อกซีสำหรับ URL WebSocket แบบใหม่ที่มีขนาดกะทัดรัดกว่า ในขณะที่ยังคงรักษาตัวเลือกสำรองแบบเดิมไว้ในบางกรณี

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

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

ขั้นตอนที่ 4: ตรวจสอบข้อมูลสำรองก่อนใช้งานจริง

คำสั่ง ที่สำเร็จเพียงtarอย่างเดียวไม่เพียงพอ ต้องทดสอบว่าสามารถแสดงรายการไฟล์เก็บถาวรได้ และมีไฟล์การกำหนดค่าหลักที่คาดหวังอยู่หรือไม่

sudo tar -tzf /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  | grep 'coolwsd/coolwsd.xml'

สร้างค่าตรวจสอบความถูกต้อง (checksum) สำหรับการตรวจสอบจากภายนอก:

cd /var/backups/collabora
sha256sum * > SHA256SUMS

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

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

ขั้นตอนที่ 5: กู้คืนอย่างระมัดระวัง จากนั้นตรวจสอบความถูกต้องของบริการที่กำลังทำงานอยู่

กู้คืนการติดตั้งดั้งเดิม

ควรติดตั้ง CODE เวอร์ชันเดียวกันก่อน หยุดบริการ แตกไฟล์เก็บถาวรไปยังไดเร็กทอรีชั่วคราว และเปรียบเทียบการกำหนดค่าที่บันทึกไว้กับค่าเริ่มต้นที่ติดตั้งใหม่:

sudo systemctl stop coolwsd
sudo mkdir -p /root/collabora-restore
sudo tar -xzf /var/backups/collabora/coolwsd-etc-YYYY-MM-DD.tar.gz \
  -C /root/collabora-restore

sudo diff -u \
  /etc/coolwsd/coolwsd.xml \
  /root/collabora-restore/coolwsd/coolwsd.xml

หากเวอร์ชันตรงกันและคุณตั้งใจจะแทนที่ทั้งหมด ให้เก็บไดเร็กทอรีใหม่ไว้เป็นสำเนาสำหรับการย้อนกลับก่อน:

sudo cp -a /etc/coolwsd /etc/coolwsd.pre-restore
sudo cp -a /root/collabora-restore/coolwsd/. /etc/coolwsd/
sudo systemctl start coolwsd

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

กู้คืนการใช้งาน Docker

สร้างคอนเทนเนอร์ขึ้นใหม่จากเวอร์ชันอิมเมจที่บันทึกไว้และไฟล์ Docker Compose หรือdocker runคำจำกัดความดั้งเดิม กู้คืนการกำหนดค่าการเชื่อมต่อแบบ bind-mount ของโฮสต์ คีย์ตรวจสอบ และไฟล์ภายนอกอื่นๆ กลับไปยังเส้นทางโฮสต์ดั้งเดิมก่อนเริ่มคอนเทนเนอร์

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

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

วิธีตรวจสอบว่าการกู้คืนสำเร็จหรือไม่

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

สำหรับการติดตั้งแบบเนทีฟ:

sudo systemctl status coolwsd --no-pager
sudo journalctl -u coolwsd -n 100 --no-pager

สำหรับ Docker:

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

Collabora ระบุว่า/hosting/capabilitiesเอนด์พอยต์นี้เป็นวิธีการดึงข้อมูลต่างๆ รวมถึงชื่อผลิตภัณฑ์และเวอร์ชันที่กำลังทำงานอยู่ ทดสอบโดยใช้ URL สาธารณะของ Collabora ด้วยคำสั่งต่อไปนี้:

curl -fsS https://office.example.com/hosting/capabilities

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

การดำเนินการ:ถือว่าการกู้คืนเสร็จสมบูรณ์ก็ต่อเมื่อปลายทางความสามารถตอบสนองแล้ว และสามารถเปิดและบันทึกเอกสารจริงได้

รายการตรวจสอบการสำรองข้อมูลเชิงปฏิบัติ

คำแนะนำสุดท้าย

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

ณ วันที่ 6 ตุลาคม 2569 เวอร์ชันปัจจุบันที่แสดงในบันทึกการเผยแพร่เวอร์ชัน 26.04 อย่างเป็นทางการของ Collabora และข้อมูลเมตาของอิมเมจ Docker คือ CODE 26.04.4.2 โปรดตรวจสอบแหล่งข้อมูลอย่างเป็นทางการเหล่านั้นอีกครั้งก่อนการย้ายข้อมูลในอนาคต เนื่องจากเวอร์ชันของอิมเมจ คำแนะนำเกี่ยวกับพร็อกซี และตัวเลือกการกำหนดค่าต่างๆ ยังคงมีการเปลี่ยนแปลงอย่างต่อเนื่อง