แก้ไขปัญหา ONLYOFFICE Document Server หน่วยความจำไม่เพียงพอ บน VPS

เริ่มต้นด้วยการตรวจสอบว่าโฮสต์ Linux หรือคอนเทนเนอร์ ONLYOFFICE กำลังใช้งานหน่วยความจำถึงขีดจำกัดหรือไม่ เอกสารแนะนำ ONLYOFFICE Docs Community Edition ฉบับปัจจุบันระบุว่า RAM 4 GB และ swap อย่างน้อย 4 GB เป็นข้อกำหนดพื้นฐาน หน้าการแก้ไขปัญหา Docker ระบุว่าการใช้ RAM 2–4 GB ถือเป็นเรื่องปกติสำหรับผู้ใช้งานที่ใช้งานอยู่หลายสิบคน เนื่องจากปริมาณการใช้หน่วยความจำจะเพิ่มขึ้นตามจำนวนเอกสารที่เปิดและผู้ใช้งานพร้อมกัน ตารางฮาร์ดแวร์แนะนำให้ใช้ Kubernetes สำหรับการใช้งานที่มีผู้ใช้งานพร้อมกันมากกว่า 400 คน ตัวเลขเหล่านี้เป็นเพียงตัวเลขอ้างอิง ไม่ใช่การรับประกันว่า VPS ทุกเครื่องจะสามารถรองรับภาระงานได้เท่ากัน ระบบปฏิบัติการโฮสต์ คอนเทนเนอร์อื่นๆ ขนาดเอกสาร และข้อจำกัดของผู้ให้บริการ VPS ก็มีผลเช่นกัน

คู่มือนี้เน้นการติดตั้ง Docker บน Linux VPS ทั่วไป ทำตามสี่ขั้นตอนตามลำดับ: วัดภาระของโฮสต์และคอนเทนเนอร์ ตรวจสอบบันทึกและแคชไฟล์ที่ถูกลืม ลดภาระที่ไม่จำเป็นหรือแก้ไขขีดจำกัดคอนเทนเนอร์ที่ต่ำเกินไป จากนั้นรีสตาร์ทเฉพาะเมื่อจำเป็นและตรวจสอบภายใต้การใช้งานปกติ ตัวอย่างคำสั่งใช้<CONTAINER_ID>เป็นตัวแทน โปรดแทนที่ด้วย ID หรือชื่อจากdocker psทำการสำรองข้อมูลและกำหนดเวลาการบำรุงรักษาก่อนหยุดโปรแกรมแก้ไขที่มีผู้ใช้งานอยู่

1. ตรวจสอบว่าปัญหาเรื่องหน่วยความจำเกิดขึ้นที่จุดใด

รันคำสั่งแรกบนโฮสต์ VPS ไม่ใช่ภายในคอนเทนเนอร์ ONLYOFFICE:

free -h
swapon --show
docker stats --no-stream

free -hแสดงหน่วยความจำโฮสต์และพื้นที่สวอปที่ใช้งานได้swapon --showตรวจสอบว่าสวอปทำงานอยู่หรือไม่ ในส่วนนี้docker statsให้เปรียบเทียบการใช้หน่วยความจำของ ONLYOFFICE กับขีดจำกัดที่แสดง หากโฮสต์มีหน่วยความจำเหลือน้อยมากและมีหลายบริการที่ใช้ RAM แสดงว่า VPS อาจมีขนาดเล็กเกินไป หากโฮสต์ยังมีพื้นที่เหลือ แต่คอนเทนเนอร์ ONLYOFFICE ใกล้ถึงขีดจำกัดที่น้อยกว่ามาก ขีดจำกัดของคอนเทนเนอร์อาจเป็นสาเหตุโดยตรง สวอปที่เกือบเต็ม การสวอปอย่างต่อเนื่อง หรือกิจกรรมดิสก์ที่หนักหน่วง อาจทำให้การแก้ไขช้าลงแม้ก่อนที่โฮสต์จะยุติกระบวนการ

ตรวจสอบข้อจำกัดของ Docker ที่ตั้งค่าไว้ด้วยเช่นกัน:

docker inspect --format '{{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' <CONTAINER_ID>
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}}' <CONTAINER_ID>

คำสั่งแรกจะแสดงการตั้งค่าหน่วยความจำและหน่วยความจำรวมกับสวอปในหน่วยไบต์ โดยทั่วไปแล้ว การจำกัดหน่วยความจำเป็นศูนย์หมายความว่าไม่มีการกำหนดขีดจำกัดหน่วยความจำของคอนเทนเนอร์อย่างชัดเจน ไม่ได้หมายความว่า VPS มี RAM ไม่จำกัด การตั้งค่าหน่วยความจำสวอปของ Docker เป็นการจำกัดหน่วยความจำและสวอปแบบรวมกัน ดังนั้นอย่าตีความว่าเป็นสวอปเพียงอย่างเดียว คำสั่งที่สองจะรายงานว่า Docker บันทึกการฆ่าคอนเทนเนอร์เนื่องจากหน่วยความจำไม่เพียงพอ (OOM kill) และรหัสการออกครั้งสุดท้ายหรือไม่ Docker ระบุข้อจำกัดเหล่านี้ว่าเป็นมาตรการควบคุมที่บังคับใช้โดยโฮสต์ Linux และแรงกดดัน OOM ทั่วทั้งโฮสต์อาจส่งผลกระทบต่อคอนเทนเนอร์มากกว่าหนึ่งตัว

2. ตรวจสอบบันทึกคอนเทนเนอร์และกรณีการใช้งานสูงที่ทราบกันดีของ ONLYOFFICE

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

docker logs --since 1h <CONTAINER_ID>

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

sudo dmesg -T | grep -Ei 'out of memory|killed process|oom' | tail -n 30

หน้าการแก้ไขปัญหา Docker ของ ONLYOFFICE แนะนำเป็นพิเศษให้ตรวจสอบเอกสารที่ค้างอยู่หรือถูกลืม/var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/เมื่อการใช้งานหน่วยความจำสูงผิดปกติ ขั้นแรกให้ตรวจสอบขนาดและเนื้อหาของไดเร็กทอรี อย่าลบไฟล์โดยไม่ตรวจสอบ เพราะไฟล์เหล่านั้นอาจเกี่ยวข้องกับการกู้คืนหรือการแก้ไขปัญหา หากไดเร็กทอรีมีขนาดใหญ่หรือยังคงเติบโตต่อไป ให้เก็บรักษาไฟล์และบันทึกต่างๆ ไว้ จากนั้นทำตามคำแนะนำการแก้ไขปัญหาอย่างเป็นทางการหรือสอบถามฝ่ายสนับสนุนของ ONLYOFFICE ว่าสิ่งใดปลอดภัยที่จะล้างในเวอร์ชันของคุณ

3. ลดความต้องการที่ไม่จำเป็นและแก้ไขข้อจำกัดของ Docker ที่เล็กเกินไป

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

หาก VPS ปิดใช้งาน Swap ไว้ การเพิ่ม Swap สามารถช่วยลดภาระการใช้งานชั่วคราวได้ คู่มือการติดตั้ง Docker ของ ONLYOFFICE ในปัจจุบันระบุว่าควรใช้ Swap อย่างน้อย 4 GB และระบุว่าปริมาณขึ้นอยู่กับระบบปฏิบัติการของโฮสต์ Swap ใช้ดิสก์เป็นตัวสำรองข้อมูลและทำงานช้ากว่า RAM มาก ดังนั้นจึงไม่สามารถใช้ทดแทนหน่วยความจำทางกายภาพที่เพียงพอได้ ก่อนที่จะสร้างไฟล์ Swap ให้ตรวจสอบว่าไม่มีไฟล์ดังกล่าวอยู่แล้ว ตรวจสอบพื้นที่ว่างในดิสก์ และยืนยันว่าระบบไฟล์และผู้ให้บริการ VPS ของคุณรองรับวิธีการนี้ ตัวอย่างเช่น ในระบบไฟล์ Linux ทั่วไปที่รองรับไฟล์ Swap จะมีรูปแบบดังนี้:

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --show

ห้ามรันคำสั่งเหล่านี้ทับไฟล์ swap ที่มีอยู่แล้ว/swapfileหากต้องการเก็บไฟล์ swap ที่สร้างขึ้นใหม่หลังจากรีบูต ให้เพิ่มรายการที่ตรงกันหนึ่งรายการลงในไฟล์ swap /etc/fstabหลังจากตรวจสอบรายการที่มีอยู่แล้วเท่านั้น:

/swapfile none swap sw 0 0

หาก Docker แสดงขีดจำกัดหน่วยความจำคอนเทนเนอร์ต่ำ ให้ตรวจสอบไฟล์ Compose หรือแผงการปรับใช้ที่สร้างคอนเทนเนอร์นั้น เพิ่มหรือลบขีดจำกัดหลังจากตรวจสอบ RAM ทั้งหมดของ VPS และหน่วยความจำที่ใช้โดยระบบปฏิบัติการ ฐานข้อมูล แพลตฟอร์มการรวมระบบ และบริการอื่นๆ แล้วเท่านั้น อย่าจัดสรร RAM ของโฮสต์ทั้งหมดให้กับ ONLYOFFICE หากโฮสต์มีหน่วยความจำไม่เพียงพอ การเปลี่ยนขีดจำกัดของ Docker จะไม่สร้างหน่วยความจำทางกายภาพเพิ่มเติม ให้ปรับขนาด VPS หรือย้ายบริการอื่นๆ ไปยังโฮสต์อื่น Compose รองรับการจำกัดหน่วยความจำ แต่ขีดจำกัดที่กำหนดค่าไว้ต้องตรงกับโหมดการปรับใช้จริงและหน่วยความจำโฮสต์ที่มีอยู่

VPS ขนาด 2 GB ที่ใช้งาน ONLYOFFICE ควบคู่ไปกับ Nextcloud หรือบริการอื่นๆ นั้น มี RAM ต่ำกว่าเกณฑ์มาตรฐาน 4 GB ที่ผู้ให้บริการระบุไว้ VPS ขนาด 4 GB ก็อาจมีหน่วยความจำไม่เพียงพอเช่นกัน เมื่อระบบปฏิบัติการหลักและส่วนเชื่อมต่อต่างๆ ใช้หน่วยความจำร่วมกัน ในกรณีเช่นนั้น VPS ที่มีขนาดใหญ่กว่า หรือโฮสต์ Document Server โดยเฉพาะ จะมีความน่าเชื่อถือมากกว่าการรีสตาร์ทคอนเทนเนอร์ซ้ำๆ สำหรับผู้ใช้งานพร้อมกันมากกว่า 400 คน ตาราง ONLYOFFICE ปัจจุบันแนะนำให้ใช้การใช้งาน Kubernetes และติดต่อ ONLYOFFICE เพื่อขอคำแนะนำเรื่องขนาด นี่ไม่ใช่ปริมาณงานที่จะแก้ไขได้ด้วยการเพิ่มไฟล์ swap ขนาดเล็กใน VPS เพียงเครื่องเดียว

4. เริ่มการทำงานใหม่อย่างปลอดภัย จากนั้นตรวจสอบผลลัพธ์

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

sudo docker exec <CONTAINER_ID> documentserver-prepare4shutdown.sh
sudo docker restart <CONTAINER_ID>

หากคุณใช้ Docker Compose ให้ทำการเปลี่ยนแปลงแบบถาวรในการตั้งค่า Compose หรือแผงควบคุม และใช้ขั้นตอนการรีสตาร์ทตามปกติของโปรเจ็กต์ การเปลี่ยนแปลงเพียงครั้งเดียวในคอนเทนเนอร์ที่กำลังทำงานอยู่อาจหายไปเมื่อสร้างใหม่ อย่าใช้--oom-kill-disableลำดับความสำคัญ OOM ที่มากเกินไปเพื่อรักษา ONLYOFFICE ให้ทำงานต่อไป Docker เตือนว่าการใช้หน่วยความจำของโฮสต์จนหมดอาจทำให้ VPS และบริการอื่นๆ ตกอยู่ในความเสี่ยง

หลังจาก VPS หรือคอนเทนเนอร์กลับมาทำงานแล้ว ให้ตรวจสอบว่าคอนเทนเนอร์ยังคงทำงานได้ดี โปรแกรมแก้ไขเปิดและบันทึกเอกสารทดสอบได้ หน่วยความจำของโฮสต์ยังคงใช้งานได้ และคอนเทนเนอร์ไม่ได้รีสตาร์ทซ้ำๆ สังเกตหน่วยความจำทั้งของโฮสต์และคอนเทนเนอร์ในช่วงเวลาที่มีการใช้งานมาก หากหน่วยความจำเพิ่มขึ้นอย่างต่อเนื่องหลังจากปิดเอกสาร โฟลเดอร์ไฟล์ที่ถูกลืมมีขนาดใหญ่ขึ้น หรือเกิดเหตุการณ์ OOM ขึ้นอีกครั้ง ให้รวบรวมเอาต์พุตของfree -h, swapon --show, docker stats, docker inspect, และบันทึกข้อมูลล่าสุดเพื่อขอความช่วยเหลือ อย่าถือว่าการรีสตาร์ทที่สำเร็จเพียงครั้งเดียวเป็นหลักฐานว่าความจุได้รับการแก้ไขแล้ว

คู่มือการตัดสินใจฉบับย่อ

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

• ข้อกำหนดของระบบ Docker และคำแนะนำเกี่ยวกับการใช้งานพร้อมกันของ ONLYOFFICE Docs Community Edition
• การแก้ไขปัญหา ONLYOFFICE Docs Docker: การใช้งานหน่วยความจำ เอกสารที่ลืมไว้ บันทึก และการปิดระบบอย่างปลอดภัย
• คู่มือการติดตั้ง ONLYOFFICE Docs Community Edition บน Docker
• เอกสารประกอบการใช้งาน Docker: ข้อจำกัดด้านหน่วยความจำและพื้นที่สวอปของคอนเทนเนอร์
• การตั้งค่าทรัพยากรบริการ Docker Compose