Cách cài đặt ONLYOFFICE Docs trên Ubuntu 24.04

[theanh]

ONLYOFFICE Docs hoặc Document Server là một bộ ứng dụng văn phòng trực tuyến có thể được cài đặt trên máy chủ cục bộ của bạn. Nó hỗ trợ nền tảng ONLYOFFICE Collaboration và các hệ thống phổ biến như Nextcloud, OwnCloud, WordPress, Drupal, Odoo, SuiteCRM và nhiều hệ thống khác nữa. ONLYOFFICE Document Server có thể được sử dụng như một trình soạn thảo tài liệu, trình soạn thảo bảng tính, trình soạn thảo bản trình bày và trình soạn thảo cộng tác. Nó hỗ trợ tất cả các định dạng phổ biến: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX và HTML.

Hướng dẫn này chỉ cho bạn cách triển khai ONLYOFFICE Document Server trên máy chủ Ubuntu 24.04, với PostgreSQL làm cơ sở dữ liệu và Nginx làm proxy ngược. Bạn cũng sẽ bảo mật ONLYOFFICE Docs bằng HTTPS thông qua Certbot và Letsencrypt.

Điều kiện tiên quyết​

Trước khi bắt đầu, hãy đảm bảo bạn có những điều sau:

• Máy chủ Ubuntu 24.04
• Người dùng không phải root có quyền quản trị viên
• Tên miền được trỏ đến địa chỉ IP của máy chủ

Cài đặt PostgreSQL và RabbitMQ​

Máy chủ tài liệu ONLYOFFICE yêu cầu PostgreSQL và RabbitMQ được cài đặt trên máy chủ Ubuntu của bạn. Bây giờ bạn sẽ cài đặt cả máy chủ PostgreSQL và RabbitMQ thông qua kho lưu trữ Ubuntu chính thức.

Trước tiên, hãy chạy lệnh sau để cập nhật chỉ mục gói của bạn.

sudo apt update

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22682%22%20height=%22196%22%3E%3C/svg%3E


Bây giờ, hãy cài đặt máy chủ PostgreSQL và RabbitMQ thông qua kho lưu trữ Ubuntu chính thức bằng lệnh bên dưới. Nhập 'Y' để xác nhận cài đặt.

sudo apt install postgresql rabbitmq-server

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22497%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, hãy kiểm tra máy chủ PostgreSQL bằng lệnh 'systemctl' bên dưới.

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

Bạn có thể thấy PostgreSQL bên dưới với trạng thái hoạt động và thoát.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22167%22%3E%3C/svg%3E


Cuối cùng, hãy kiểm tra máy chủ RabbitMQ bằng lệnh sau lệnh.

sudo systemctl is-enabled rabbitmq-server
sudo systemctl status rabbitmq-server

Như đã thấy trong hình sau, máy chủ RabbitMQ cũng đang chạy.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22219%22%3E%3C/svg%3E

Tạo cơ sở dữ liệu PostgreSQL và người dùng​

Sau PostgreSQL và Rabbit đã hoạt động, bạn sẽ tạo một cơ sở dữ liệu PostgreSQL và người dùng mới mà ONLYOFFICE Docs sẽ sử dụng. Trong ví dụ này, bạn sẽ sử dụng dòng lệnh để tạo cơ sở dữ liệu PostgreSQL và người dùng.

Chạy lệnh bên dưới để tạo người dùng PostgreSQL mới 'onlyoffice' với mật khẩu 'onlyoffice'.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"

Bây giờ hãy tạo một cơ sở dữ liệu mới 'onlyoffice' với chủ sở hữu mặc định là 'onlyoffice' với sau đây:

sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22128%22%3E%3C/svg%3E


Cuối cùng, hãy kiểm tra danh sách người dùng và cơ sở dữ liệu trong máy chủ PostgreSQL bằng lệnh bên dưới.

sudo -i -u postgres psql -c "\du"
sudo -i -u postgres psql -c "\l"

Bạn có thể thấy bên dưới người dùng 'onlyoffice' và cơ sở dữ liệu 'onlyoffice' có sẵn.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22153%22%3E%3C/svg%3E



data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22132%22%3E%3C/svg%3E

Cài đặt ONLYOFFICEDocument Server​

Bây giờ cơ sở dữ liệu PostgreSQL và máy chủ RabbitMQ đã sẵn sàng, bạn có thể bắt đầu cài đặt ONLYOFFICE Document Server. Tại đây, bạn sẽ thêm khóa GPG và kho lưu trữ ONLYOFFICE, sau đó cài đặt Document Server thông qua trình quản lý gói APT.

Tải xuống khóa GPG cho ONLYOFFICE vào hệ thống Ubuntu của bạn bằng cách sau:

curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/onlyoffice.gpg

Bây giờ hãy chạy lệnh bên dưới để thêm kho lưu trữ ONLYOFFICE cho hệ thống Debian/Ubuntu.

echo "deb [signed-by=/etc/apt/trusted.gpg.d/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22293%22%3E%3C/svg%3E


Tiếp theo, hãy cập nhật và làm mới chỉ mục gói Ubuntu của bạn, sau đó cài đặt gói 'onlyoffice-documentserver' bằng lệnh sau. Theo mặc định, ONLYOFFICE cũng sẽ cài đặt máy chủ web Nginx, được sử dụng như một proxy ngược.

sudo apt update && sudo apt install onlyoffice-documentserver

Nhập 'Y' để tiếp tục cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22449%22%3E%3C/svg%3E


Nhập mật khẩu cơ sở dữ liệu postgreSQL 'onlyoffice'.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22603%22%20height=%22297%22%3E%3C/svg%3E


Chọn OK để chấp nhận giấy phép TTF mscorefont.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22585%22%3E%3C/svg%3E


Chọn Yes để chấp nhận Điều khoản cấp phép EULA.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22164%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, ONLYOFFICE Document Server sẽ chạy trên cổng HTTP mặc định 80 với máy chủ web Nginx.

Kiểm tra trạng thái máy chủ web Nginx bằng lệnh bên dưới.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Bạn sẽ thấy máy chủ web Nginx đang chạy.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22248%22%3E%3C/svg%3E

Thiết lập UFW (Tường lửa đơn giản)​

Trong phần này, bạn sẽ bật UFW (Tường lửa đơn giản) và mở các cổng cho các giao thức SSH, HTTP và HTTPS.

Trước khi bật UFW, hãy chạy lệnh bên dưới để thêm cấu hình cho 'OpenSSH' và 'Nginx Full'. Lệnh này sẽ mở cổng 22 cho SSH, HTTP và HTTPS cho máy chủ web Nginx.

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'

Bây giờ hãy chạy lệnh sau để bật UFW. Nhập 'y' để tiếp tục và bạn sẽ nhận được thông báo Tường lửa đang hoạt động và được bật khi khởi động hệ thống.

sudo ufw enable

Cuối cùng, hãy kiểm tra trạng thái UFW bằng lệnh sau.

sudo ufw status

Bạn có thể thấy UFW bên dưới có trạng thái hoạt động và Cấu hình 'OpenSSH' và 'Nginx Full' đã được bật.

Bảo mật ONLYOFFICE Document Server bằng HTTPS​

Với UFW đã được cấu hình, hãy bảo mật ONLYOFFICE Document Server bằng HTTPS thông qua Certbot và Letsencrypt. Đảm bảo tên miền của bạn đã sẵn sàng và được trỏ đến địa chỉ IP máy chủ Ubuntu của bạn. Nếu bạn đang cài đặt ONLYOFFICE Document Server cục bộ, bạn có thể sử dụng chứng chỉ Tự ký.

Trước tiên, hãy chạy lệnh 'systemctl' bên dưới để dừng máy chủ web Nginx.

sudo systemctl stop nginx

Bây giờ hãy cài đặt Certbot bằng lệnh 'apt' bên dưới. Certbot sẽ được sử dụng để tạo chứng chỉ SSL/TLS miễn phí từ Letsencrypt.

sudo apt install certbot -y

Sau khi cài đặt hoàn tất, hãy chạy lệnh 'certbot' bên dưới để tạo chứng chỉ SSL mới cho cài đặt ONLYOFFICE Document Server của bạn. Hãy đảm bảo thay đổi tên miền và địa chỉ email bằng thông tin của bạn.

sudo certbot certonly --standalone -m [emailprotected] --agree-tos --no-eff-email -d office.howtoforge.local

Khi quá trình hoàn tất, chứng chỉ của bạn sẽ có trong thư mục '/etc/letsencrypt/live/domain.com'. 'fullchain.pem' cho khóa công khai, 'privkey.pem' là khóa riêng của bạn.

Tiếp theo, sao chép mẫu Nginx mặc định cho ONLYOFFICE vào tệp '/etc/onlyoffice/documentserver/nginx/ds.conf'.

sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

Chỉnh sửa '/etc/onlyoffice/documentserver/nginx/ds.conf' bằng trình chỉnh sửa 'nano' sau lệnh.

sudo nano /etc/onlyoffice/documentserver/nginx/ds.conf

Thay đổi 'ssl_certificate' bằng đường dẫn của chứng chỉ 'fullchain.pem' và 'ssl_certificate_key' bằng đường dẫn của chứng chỉ 'privkey.pem'.

ssl_certificate /etc/letsencrypt/live/office.howtoforge.local/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/office.howtoforge.local/privkey.pem;

Khi hoàn tất, hãy lưu tệp và thoát khỏi trình chỉnh sửa.

Bây giờ hãy chạy lệnh bên dưới để xác minh cú pháp Nginx của bạn và đảm bảo rằng bạn không gặp lỗi. Sau đó, khởi động lại máy chủ web Nginx bằng lệnh 'systemctl'.

sudo nginx -t
sudo systemctl start nginx

Nếu bạn có cú pháp Nginx phù hợp, bạn sẽ thấy đầu ra như 'test is successful - syntax is OK'.

Cuối cùng, hãy chạy tập lệnh bên dưới để áp dụng HTTPS trên ONLYOFFICE Document Server. Với điều này, ONLYOFFICE của bạn sẽ chạy trên các kết nối HTTPS an toàn.

sudo bash /usr/bin/documentserver-update-securelink.sh

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22199%22%3E%3C/svg%3E

Xác minh cài đặt máy chủ tài liệu ONLYOFFICE​

Truy cập tên miền của bạn như ashttps://office.howtoforge.local/ để truy cập cài đặt ONLYOFFICE Document Server của bạn. Nếu thành công, bạn sẽ thấy xác nhận như ONLYOFFICE Docs Community Edition đã được cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22382%22%3E%3C/svg%3E


Từ đây, bạn có thể tích hợp ONLYOFFICE Document Server vào máy chủ tệp của mình như Nextcloud và ownCloud, CMS như WordPress và Drupal hoặc CRM như Odoo và SuiteCRM.

Kết luận​

Xin chúc mừng! Bạn đã hoàn tất cài đặt ONLYOFFICE Document Server trên máy chủ Ubuntu 24.04. Máy chủ tài liệu ONLYOFFICE của bạn đang chạy với cơ sở dữ liệu PostgreSQL và máy chủ web Nginx. Cuối cùng, bạn cũng đã bảo mật ONLYOFFICE bằng HTTPS thông qua Certbot và Letsencrypt.