วิธีการตั้งค่า ONLYOFFICE Workspace บน Ubuntu 24.04 LTS

ONLYOFFICE Workspace ผสานรวมการแก้ไขเอกสารออนไลน์เข้ากับพอร์ทัลการทำงานร่วมกันที่ครอบคลุมยิ่งขึ้น บน Ubuntu 24.04 LTS การตั้งค่าเซิร์ฟเวอร์ที่ง่ายที่สุดคือการใช้สคริปต์การติดตั้ง ONLYOFFICE Workspace Community อย่างเป็นทางการร่วมกับ Docker Docker จะรันส่วนประกอบของ Workspace ในคอนเทนเนอร์ที่แยกต่างหาก ซึ่งทำให้การปรับใช้ทำซ้ำและอัปเดตได้ง่ายกว่าการสร้างระบบด้วยตนเอง

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

ณ เดือนตุลาคม 2026 Docker รองรับ Ubuntu 24.04 LTS (Noble) อย่างเป็นทางการ เอกสารประกอบการใช้งาน OnlyOFFICE Workspace Community ในปัจจุบันระบุว่าควรใช้โฮสต์ Linux amd64 ที่มี CPU อย่างน้อย 4 คอร์, RAM 8 GB, พื้นที่ว่างในดิสก์ 40 GB และ swap 6 GB ผู้จำหน่ายแนะนำให้ใช้ CPU และ RAM ที่มากกว่านี้เพื่อการใช้งานที่ราบรื่นยิ่งขึ้น โปรดตรวจสอบคู่มือการติดตั้ง OnlyOFFICE Workspace Community Dockerและเอกสารการติดตั้ง Docker บน Ubuntuก่อนนำไปใช้งานบนเซิร์ฟเวอร์ จริง

สิ่งที่คุณต้องเตรียมก่อนเริ่มต้น

คุณต้องมีเซิร์ฟเวอร์ Ubuntu 24.04 LTS หรือเครื่องเสมือน, บัญชีผู้ใช้ที่sudoมีสิทธิ์, การเข้าถึงอินเทอร์เน็ตขาออกเพื่อดาวน์โหลดแพ็กเกจและอิมเมจคอนเทนเนอร์ และทรัพยากรว่างเพียงพอสำหรับบริการ Workspace หากคุณต้องการให้พอร์ทัลสามารถเข้าถึงได้จากคอมพิวเตอร์เครื่องอื่น เซิร์ฟเวอร์ก็จำเป็นต้องมีที่อยู่ LAN ที่เสถียรหรือที่อยู่ IP สาธารณะด้วย

amd64หมายถึงสถาปัตยกรรมเซิร์ฟเวอร์ x86 64 บิตทั่วไปที่ใช้โดยโปรเซสเซอร์ Intel และ AMD อย่าเข้าใจผิดว่าการที่ Docker รองรับสถาปัตยกรรมอื่นหมายความว่า ONLYOFFICE Workspace จะรองรับสถาปัตยกรรมนั้นด้วย ข้อกำหนดปัจจุบันของ Workspace ระบุถึง amd64 Linux อย่างชัดเจน

ขั้นตอนที่ 1: ตรวจสอบว่าโฮสต์ Ubuntu มีทรัพยากรเพียงพอหรือไม่

เปิดเทอร์มินัลหรือเชื่อมต่อกับเซิร์ฟเวอร์ผ่าน SSH แล้วรันคำสั่ง:

uname -m
free -h
df -h

uname -mรายงานสถาปัตยกรรมของโปรเซสเซอร์ บนโฮสต์ x86-64 ที่เข้ากันได้ คุณจะเห็นค่าx86_64. free -hแสดง RAM และพื้นที่สวอป ในขณะที่df -hแสดงพื้นที่ว่างในดิสก์ในหน่วยที่มนุษย์อ่านได้

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

ขั้นตอนที่ 2: ติดตั้ง Docker Engine จากคลังซอฟต์แวร์อย่างเป็นทางการของ Docker สำหรับ Ubuntu

Docker Engine คือบริการที่สร้างและเรียกใช้คอนเทนเนอร์ที่ใช้ในการติดตั้งใช้งาน Workspace คำแนะนำปัจจุบันของ Docker สำหรับ Ubuntu รองรับ Ubuntu 24.04 LTS และแนะนำให้ใช้ที่เก็บ APT ของ Docker เองสำหรับการติดตั้งเซิร์ฟเวอร์ตามปกติ

ขั้นแรก ติดตั้งเครื่องมือพื้นฐานสำหรับระบบจัดเก็บข้อมูล:

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

เพิ่มคีย์ลงนามและที่เก็บข้อมูลปัจจุบันของ Docker:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

จากนั้นติดตั้ง Docker Engine และปลั๊กอิน Compose:

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

ตรวจสอบว่าบริการกำลังทำงานอยู่หรือไม่:

sudo systemctl status docker --no-pager

ขั้นตอนที่ 3: ตรวจสอบ Docker ก่อนที่จะให้ ONLYOFFICE เข้ามาเกี่ยวข้อง

การตรวจสอบเล็กๆ นี้จะแยกปัญหาของ Docker ออกจากปัญหาของ Workspace เรียกใช้คำสั่ง:

sudo docker run --rm hello-world

Docker จะดาวน์โหลดอิมเมจทดสอบขนาดเล็ก เริ่มคอนเทนเนอร์ พิมพ์ข้อความยืนยัน และออกจากโปรแกรม หากขั้นตอนนี้ล้มเหลว ให้แก้ไขปัญหา Docker ก่อนที่จะดำเนินการต่อด้วยสคริปต์ Workspace

ข้อผิดพลาดทั่วไปของมือใหม่คือการเข้าใจผิดว่าข้อผิดพลาดเรื่องสิทธิ์การเข้าถึงเกิดจากdockerความล้มเหลวของ ONLYOFFICE คู่มือนี้จงใจใช้sudo dockerดังนั้นคุณจึงไม่จำเป็นต้องเพิ่มบัญชีของคุณลงในกลุ่ม Docker Docker เตือนว่าการเป็นสมาชิกในกลุ่มนั้นจะให้สิทธิ์การควบคุมระดับ root อย่างมีประสิทธิภาพ ดังนั้นอย่าเพิ่มผู้ใช้โดยไม่คิดให้รอบคอบเพียงเพื่อย่อคำสั่ง

ขั้นตอนที่ 4: ดาวน์โหลดโปรแกรมติดตั้ง ONLYOFFICE Workspace อย่างเป็นทางการ

ONLYOFFICE เผยแพร่สคริปต์การติดตั้งไว้ในโดเมนดาวน์โหลดของตนเอง ดาวน์โหลดได้โดยตรง:

curl -O https://download.onlyoffice.com/install/workspace-install.sh

ก่อนที่จะเรียกใช้สคริปต์การจัดการใดๆ ที่ดาวน์โหลดมา ควรตรวจสอบสคริปต์นั้นก่อนเสมอ:

less workspace-install.sh

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

ขั้นตอนที่ 5: ติดตั้ง Workspace โดยไม่ต้องติดตั้งเซิร์ฟเวอร์อีเมลก่อน

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

sudo bash workspace-install.sh -ims false

พารามิเตอร์นี้-ims falseหมายความว่า “อย่าติดตั้งส่วนประกอบเซิร์ฟเวอร์อีเมล” ซึ่งจะทำให้การตั้งค่าเริ่มต้นเน้นไปที่พอร์ทัล Workspace โปรแกรมแก้ไขเอกสาร และส่วนประกอบการดูแลระบบเท่านั้น เอกสาร ONLYOFFICE ระบุว่าสามารถติดตั้งอีเมลได้ในภายหลังจากแผงควบคุม

หากคุณมีโดเมนบริการอีเมลที่ตั้งค่าอย่างถูกต้องแล้ว และต้องการติดตั้งแบบเต็มรูปแบบโดยเฉพาะ เอกสาร ONLYOFFICE จะแสดงแบบฟอร์มนี้แทน:

sudo bash workspace-install.sh -md "mx1.example.com"

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

ขั้นตอนที่ 6: ตรวจสอบว่าคอนเทนเนอร์ทำงานอยู่จริงหรือไม่

เมื่อสคริปต์ทำงานเสร็จสิ้น ให้ตรวจสอบคอนเทนเนอร์ที่กำลังทำงานอยู่:

sudo docker ps

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

หากคอนเทนเนอร์รีสตาร์ทอยู่เรื่อยๆ ให้ตรวจสอบชื่อจริงdocker ps -aแล้วเรียกใช้คำสั่งต่อไปนี้:

sudo docker logs --tail 100 CONTAINER_NAME

แทนที่CONTAINER_NAMEด้วยชื่อที่แสดงโดย Docker วิธีนี้ปลอดภัยกว่าการคัดลอกชื่อคอนเทนเนอร์เก่าจากตัวอย่างการใช้งาน

ขั้นตอนที่ 7: เปิดพอร์ทัลโดยใช้ที่อยู่เครือข่ายจริงของเซิร์ฟเวอร์

ค้นหาที่อยู่เซิร์ฟเวอร์โดยใช้:

hostname -I

จากเบราว์เซอร์ที่สามารถเชื่อมต่อกับเซิร์ฟเวอร์ได้ ให้เปิด:

http://SERVER_IP

คู่มือการใช้งาน Docker ของ ONLYOFFICE แนะนำเป็นพิเศษให้ใช้ IP เครือข่ายของเครื่องแทนlocalhostหรือ127.0.0.1เมื่อตรวจสอบพอร์ทัล การเริ่มต้นใช้งานครั้งแรกอาจใช้เวลาสองสามนาทีหลังจากการติดตั้ง ดังนั้นความล่าช้าเล็กน้อยไม่ได้หมายความว่าการติดตั้งล้มเหลวโดยอัตโนมัติ

ขั้นตอนที่ 8: ดำเนินการตั้งค่าผู้ดูแลระบบให้เสร็จสมบูรณ์

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

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

รักษาความปลอดภัยของการติดตั้งก่อนเชิญผู้ใช้

หากจะใช้งานเซิร์ฟเวอร์นอกเหนือจากห้องปฏิบัติการชั่วคราว ควรเปลี่ยนจาก HTTP ธรรมดาเป็น HTTPS แผงควบคุมของ ONLYOFFICE สามารถสร้างและใช้งานใบรับรอง Let's Encrypt หรือยอมรับใบรับรองและคีย์ส่วนตัวที่มีอยู่แล้วได้ สำหรับเวิร์กโฟลว์ Let's Encrypt ในตัว พอร์ต 80 ต้องสามารถเข้าถึงได้ในระหว่างการออกใบรับรอง โปรดดูคู่มือการกำหนดค่า HTTPS อย่างเป็นทางการของONLYOFFICE

นอกจากนี้ ควรตรวจสอบว่าคุณต้องการใช้งานพอร์ตเครือข่ายใดบ้าง ONLYOFFICE ได้เผยแพร่เอกสารอ้างอิงพอร์ต Workspace Communityไว้ อย่าเปิดพอร์ตฐานข้อมูลหรือพอร์ตบริการภายในสู่ภายนอกเพียงเพราะปรากฏอยู่ในตารางนั้น

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

ปัญหาที่พบบ่อยและสิ่งที่ควรตรวจสอบก่อน

ผู้ติดตั้งแจ้งว่าพอร์ตที่ต้องการใช้งานนั้นถูกใช้งานอยู่แล้ว

ตรวจสอบผู้รับฟังก่อนหยุดบริการแบบสุ่ม:

sudo ss -ltnp | grep -E ':(80|443)\b'

หาก Apache, Nginx, คอนเทนเนอร์อื่น หรือแผงควบคุมการจัดการครอบครองพอร์ตอยู่แล้ว ให้ตัดสินใจว่าบริการใดควรได้ใช้งานพอร์ตนั้นต่อไป อย่าปิดเว็บเซิร์ฟเวอร์ที่ใช้งานจริงโดยไม่ไตร่ตรอง

หลังจากติดตั้งแล้ว เว็บไซต์ไม่โหลด

ตรวจสอบ Docker ก่อน:

sudo systemctl is-active docker
sudo docker ps -a

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

เซิร์ฟเวอร์เกิดปัญหาหน่วยความจำไม่เพียงพอระหว่างการติดตั้ง

ตรวจสอบอีกครั้งfree -hคู่มือที่ใช้สคริปต์ Workspace คาดหวังว่าจะมีพื้นที่ Swap อย่างน้อย 6 GB และระบุ RAM ขั้นต่ำไว้ที่ 8 GB VM ขนาดเล็กมากอาจไม่เสถียรในขณะที่อิมเมจหลายตัวกำลังเริ่มต้นพร้อมกัน การย้ายไปยัง VM ที่มีขนาดใหญ่กว่ามักจะดีกว่าการพยายามปรับแต่งบริการทุกอย่างให้เข้ากับหน่วยความจำที่ไม่เพียงพอ

คุณต้องใช้ ONLYOFFICE Mail ในภายหลัง

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

คุณเลือกใช้ Docker Compose แทนสคริปต์การติดตั้ง

นั่นเป็นทางเลือกที่เหมาะสมเมื่อคุณต้องการควบคุมการกำหนดค่าการใช้งานมากขึ้น คำแนะนำการใช้งาน Docker Compose ในปัจจุบันของ ONLYOFFICE กำหนดให้ใช้ Docker Compose เวอร์ชัน 2.16.0 หรือใหม่กว่าสำหรับ Ubuntu 22.04 และเวอร์ชันที่ใหม่กว่า และแนะนำให้ผู้ดูแลระบบเปิดใช้งานcgroupบรรทัดที่เกี่ยวข้องในไฟล์ Workspace YAML Ubuntu 24.04 จัดอยู่ในหมวดหมู่ "22.04 และใหม่กว่า" โปรดปฏิบัติตามคู่มือ Docker Compose อย่างเป็นทางการของ ONLYOFFICEแทนที่จะคัดลอกไฟล์ Compose เก่าจากคู่มือที่ไม่เกี่ยวข้อง

วิธีตรวจสอบว่าการตั้งค่าเสร็จสมบูรณ์แล้วจริง ๆ

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

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