วิธีการติดตั้ง ONLYOFFICE Docs Enterprise ด้วย Docker Compose

ONLYOFFICE Docs Enterprise สามารถใช้งานได้โดยใช้ Docker Compose จากDocker-DocumentServerrepository อย่างเป็นทางการ สิ่งสำคัญคือต้องเริ่มต้นด้วยไฟล์ Compose เฉพาะสำหรับ Enterprise จากนั้นตั้งค่าพื้นที่จัดเก็บข้อมูลถาวร รหัสลับ JWT ที่เสถียร และไฟล์ใบอนุญาต ก่อนที่จะใช้งานเซิร์ฟเวอร์ในสภาพแวดล้อมการผลิต ขั้นตอนนี้จะติดตั้ง Docs ซึ่งเป็นบริการแก้ไขเอกสารออนไลน์ แต่ไม่ได้ติดตั้งพอร์ทัล ONLYOFFICE Workspace ทั้งหมด

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

รายการตรวจสอบความต้องการอย่างรวดเร็ว

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

1. ติดตั้ง Docker Compose และดาวน์โหลดไฟล์การปรับใช้ (deployment files) อย่างเป็นทางการ

หากติดตั้ง Docker Engine บน Debian หรือ Ubuntu จากคลังแพ็กเกจของ Docker แล้ว ให้ติดตั้งปลั๊กอิน Compose โดยใช้คำสั่ง:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

สำหรับระบบปฏิบัติการ Linux อื่นๆ โปรดปฏิบัติตามคำแนะนำการติดตั้ง Docker สำหรับระบบปฏิบัติการนั้นๆ ปลั๊กอินปัจจุบันใช้คำสั่งแบบมีช่องว่างdocker composeคำสั่งแบบสแตนด์อโลนรุ่นเก่าdocker-composeถูกเก็บรักษาไว้เพื่อความเข้ากันได้กับเวอร์ชันก่อนหน้า และไม่ใช่เส้นทางที่ใช้โดยคำสั่ง Enterprise ของ ONLYOFFICE ที่แสดงไว้ที่นี่

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

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git
cd Docker-DocumentServer
# Optional: select the approved release tag for your deployment
git checkout <release-tag>

ตรวจสอบให้แน่ใจว่าเวอร์ชันที่ดึงออกมานั้นมีไฟล์docker-compose.enterprise.yml. ห้ามแทนที่ด้วยdocker-compose.ymlไฟล์ ซึ่งเป็นไฟล์ Compose รุ่น Community Edition ในที่เก็บนี้

2. เตรียมข้อมูลลับ พื้นที่จัดเก็บข้อมูล และใบอนุญาต

ก่อนเริ่มต้นใช้งานครั้งแรก โปรดตรวจสอบไฟล์docker-compose.enterprise.yml.js ในไฟล์ทางการปัจจุบัน แอปพลิเคชันและบริการ PostgreSQL ใช้รหัสผ่านฐานข้อมูลตัวอย่าง และบรรทัด JWT ถูกคอมเมนต์ไว้ โปรดแทนที่รหัสผ่านฐานข้อมูลตัวอย่างด้วยค่าที่ปลอดภัยทั้งในDB_PWDการตั้งค่าของแอปพลิเคชันและ PostgreSQL ทั้งสอง POSTGRES_PASSWORDค่าต้องตรงกัน ยกเลิกการคอมเมนต์หรือเพิ่มJWT_ENABLED=trueและตั้งค่า JWT secret ที่ยาวและไม่ซ้ำกันJWT_SECRETเก็บ JWT secret เดียวกันนี้ไว้สำหรับแอปพลิเคชันหรือตัวเชื่อมต่อที่จะทำงานร่วมกับ Docs

สร้างรหัสลับแทนการใช้รหัสผ่านเข้าสู่ระบบซ้ำ ตัวอย่างเช่น รันคำสั่งopenssl rand -hex 32และบันทึกผลลัพธ์ลงในไฟล์สภาพแวดล้อมส่วนตัว จากนั้นอ้างอิงไฟล์นั้นจากไฟล์ Compose เป็น `<privacy_file>` ${JWT_SECRET}และ${DB_PASSWORD}`<privacy_file>` ป้องกันไฟล์สภาพแวดล้อมจากผู้ใช้โฮสต์รายอื่น และอย่าคอมมิตไฟล์นั้นลงใน Git หลักการตั้งค่าที่สำคัญคือ:

# In a private .env file beside the Compose file
JWT_SECRET=replace_with_a_long_random_value
DB_PASSWORD=replace_with_a_different_long_random_value

อัปเดตข้อมูลรหัสผ่านฐานข้อมูลทั้งสองรายการให้ชี้ไปยัง${DB_PASSWORD}และตั้งค่าข้อมูลสภาพแวดล้อมเซิร์ฟเวอร์เป็นJWT_ENABLED=trueและJWT_SECRET=${JWT_SECRET}ไฟล์ Compose ต้นทางได้กำหนดบริการ PostgreSQL, RabbitMQ และ Redis ภายในไว้แล้ว หากคุณต้องการปรับแต่งเพิ่มเติม ให้เก็บชื่อบริการและส่วนประกอบที่เกี่ยวข้องไว้ด้วยกัน

ทำให้ข้อมูลแอปพลิเคชันที่สำคัญคงอยู่บนโฮสต์ ในonlyoffice-documentserverบริการ ให้แทนที่รายการวอลุ่มที่ไม่ระบุชื่อสำหรับ/var/www/onlyoffice/Dataและ/var/log/onlyofficeด้วยการเมานต์แบบผูก เช่น:

volumes:
  - ./data:/var/www/onlyoffice/Data
  - ./logs:/var/log/onlyoffice

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

mkdir -p data logs
cp /secure/path/license.lic data/license.lic

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

3. ตรวจสอบและเริ่มต้นใช้งานบริการระดับองค์กร

จากไดเร็กทอรีของที่เก็บข้อมูล ให้ตรวจสอบความถูกต้องของการกำหนดค่า Compose จากนั้นเรียกใช้ Enterprise stack:

docker compose -f docker-compose.enterprise.yml config
docker compose -f docker-compose.enterprise.yml up -d

คำสั่งแรกจะตรวจสอบว่า Compose สามารถแยกวิเคราะห์ไฟล์และแก้ไขตัวแปรได้หรือไม่ คำสั่งนี้สามารถแสดงข้อมูลลับที่แก้ไขแล้วได้ ดังนั้นควรเรียกใช้ในเทอร์มินัลส่วนตัวและอย่าคัดลอกผลลัพธ์ไปวางในบันทึกสาธารณะหรือกระทู้สนับสนุน คำสั่งที่สองจะสร้างหรือเริ่มต้นบริการต่างๆ ที่อธิบายไว้ในไฟล์ Enterprise คำจำกัดความอย่างเป็นทางการนั้นรวมถึง Document Server พร้อมด้วย PostgreSQL, RabbitMQ และ Redis ที่เป็นส่วนประกอบสำคัญ

ตรวจสอบสถานะการให้บริการและข้อความล่าสุด:

docker compose -f docker-compose.enterprise.yml ps
docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

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

4. ตั้งค่าบริการให้อยู่หลังโปรโตคอล HTTPS และจำกัดการเข้าถึง

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

ไฟล์ Enterprise Compose อย่างเป็นทางการได้กำหนดพอร์ต 80 และ 443 สำหรับ Document Server ไว้แล้ว ฐานข้อมูล, Redis และ RabbitMQ เป็นส่วนประกอบภายในและไม่ควรเปิดเผยสู่เครือข่ายสาธารณะ โปรดตรวจสอบไฟร์วอลล์และกลุ่มความปลอดภัยบนคลาวด์เพื่อให้แน่ใจว่ามีเฉพาะทราฟฟิกขาเข้าที่จำเป็นเท่านั้นที่เข้าถึงโฮสต์ได้ หากมี Reverse Proxy อื่นครอบครองพอร์ต 80 และ 443 อยู่แล้ว ให้เปลี่ยนการแมปพอร์ตของ Compose เป็นพอร์ตเฉพาะโฮสต์หรือพอร์ตที่ไม่ได้ใช้งาน และกำหนดค่า Proxy ให้ส่งต่อไปยังปลายทางภายในเครื่องนั้น Proxy ต้องรองรับทราฟฟิก WebSocket ที่ใช้ในการแก้ไขเอกสาร

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

5. ตรวจสอบบริการ จากนั้นทดสอบการเชื่อมต่อ

ไฟล์ Compose อย่างเป็นทางการกำหนดการตรวจสอบสถานะการทำงานhttp://localhost:8000/info/info.jsonภายในคอนเทนเนอร์ Document Server ตรวจสอบว่าบริการทำงานได้อย่างปกติหรือไม่โดยใช้docker compose ... psคำสั่ง `sudo apt check` นอกจากนี้ คุณยังสามารถใช้เบราว์เซอร์เพื่อเปิดโฮสต์เนม HTTPS สาธารณะได้ หน้าต้อนรับ Docs ที่ทำงานได้แสดงว่าเว็บเซอร์วิสตอบสนอง แต่ไม่ได้ทดสอบการเรียกกลับเอกสารจากแพลตฟอร์มจัดเก็บข้อมูลของคุณ

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

หมายเหตุเกี่ยวกับการใช้งานและการแก้ไขปัญหา

• ไม่พบใบอนุญาต:โปรดยืนยันว่า ใบอนุญาต license.licอยู่ในไดเร็กทอรีโฮสต์ที่เมานต์ไว้จริง/var/www/onlyoffice/Dataจากนั้นตรวจสอบบันทึกของคอนเทนเนอร์
• ข้อผิดพลาดของ JWT:เปรียบเทียบค่าลับ ส่วนหัว และ URL ของเซิร์ฟเวอร์และตัวเชื่อมต่อ รักษาค่าลับให้คงที่แม้หลังจากรีสตาร์ท
• ความล้มเหลวในการเริ่มต้นฐานข้อมูล:โปรดตรวจสอบให้แน่ใจว่ารหัสผ่านฐานข้อมูลตรงกันทั้งในสภาพแวดล้อม PostgreSQL และ Document Server
• ข้อมูลหายไปหลังจากสร้างใหม่:ตรวจสอบให้แน่ใจว่าไฟล์ Enterprise Compose ยังคงใช้ bind mount สำหรับข้อมูลและยังคงชื่อวอลุ่ม PostgreSQL ไว้ สำรองข้อมูลทั้งสองอย่างก่อนทำการอัปเกรด
• โปรแกรมแก้ไขเปิดขึ้นแต่ไม่สามารถบันทึกได้:ตรวจสอบว่า URL การเรียกกลับของแพลตฟอร์มสามารถเข้าถึงได้จากคอนเทนเนอร์ Docs และพร็อกซีส่งผ่านการเชื่อมต่อ WebSocket หรือไม่

ใช้เส้นทางการอัปเดตเฉพาะสำหรับองค์กร และตรวจสอบบันทึกการเผยแพร่ก่อนเปลี่ยนเวอร์ชันอิมเมจ หลีกเลี่ยงตัวdocker compose down -vเลือกนี้เว้นแต่คุณตั้งใจจะลบวอลุ่มที่จัดการโดย Compose เนื่องจากตัวเลือกดังกล่าวอาจลบวอลุ่มข้อมูล PostgreSQL ที่ระบุชื่อไว้ สำรองข้อมูลไดเร็กทอรีข้อมูล บันทึก (ถ้าจำเป็น) และฐานข้อมูลก่อนทำการอัปเกรด

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

สำหรับรายละเอียดเฉพาะเวอร์ชัน โปรดดูคู่มือการติดตั้ง Enterprise Docker ของ ONLYOFFICE คำแนะนำในการเปิดใช้งานใบอนุญาตและไฟล์Enterprise Compose อย่างเป็นทางการเอกสาร READMEใน ที่เก็บข้อมูล จะอธิบายคำสั่ง Compose และพารามิเตอร์ของคอนเทนเนอร์คู่มือการติดตั้งปลั๊กอิน Compose ของ Docker ครอบคลุมการติดตั้งบน Linux หากไม่ได้ติดตั้ง Docker โปรดปฏิบัติตามคำแนะนำของ Docker Engine สำหรับระบบปฏิบัติการของคุณ