Hướng dẫn cài đặt và cấu hình Onlyffice

1. Giới thiệu về ONLYOFFICE Docs Community Edition

ONLYOFFICE Docs Community Edition là một bộ công cụ văn phòng mã nguồn mở, cho phép chỉnh sửa tài liệu trực tuyến và hỗ trợ làm việc nhóm trên nhiều nền tảng khác nhau. Bộ công cụ này có thể tích hợp vào các ứng dụng lưu trữ và chia sẻ dữ liệu như Nextcloud, ownCloud, Seafile, cũng như hỗ trợ API tích hợp cho các nhà phát triển.

Bài viết này sẽ hướng dẫn chi tiết cách cài đặt ONLYOFFICE Docs Community Edition bằng Docker, cũng như cách kiểm tra hoạt động của nó trước khi tích hợp vào hệ thống.

2. Cài đặt ONLYOFFICE Docs bằng Docker

Trước tiên, bạn cần đảm bảo server của mình đã cài đặt Docker. Nếu chưa có, bạn có thể cài đặt Docker theo hướng dẫn chính thức từ trang chủ Docker.

2.1. Kéo và chạy container ONLYOFFICE Docs

Sử dụng lệnh sau để tải về và chạy container:

sudo docker run -i -t -d --name onlyoffice-docs \
    -p 80:80 \
    -e JWT_ENABLED=true \
    -e JWT_SECRET=your_secret_key \
    onlyoffice/documentserver

Giải thích các tham số:

• --name onlyoffice-docs: Đặt tên container là onlyoffice-docs.
• -p 80:80: Chuyển tiếp cổng 80 trên server đến container.
• -e JWT_ENABLED=true: Bật tính năng bảo mật JWT (JSON Web Token).
• -e JWT_SECRET=your_secret_key: Thiết lập private key để xác thực các yêu cầu.
• onlyoffice/documentserver: Image của ONLYOFFICE Docs.

Sau khi chạy lệnh trên, container sẽ tự động tải về và khởi động dịch vụ ONLYOFFICE Docs.

2.2. Kiểm tra hoạt động của ONLYOFFICE Docs

Sau khi cài đặt xong, bạn có thể kiểm tra xem ONLYOFFICE Docs đã hoạt động đúng chưa bằng cách truy cập trình duyệt với địa chỉ IP của server hoặc http://localhost.

Nếu bạn thấy interface thông báo ONLYOFFICE Docs Community Edition installed, nghĩa là cài đặt đã thành công.

3. Lấy khóa JWT mặc định

Từ phiên bản 7.2, ONLYOFFICE Docs sẽ tự động bật JWT để bảo vệ các yêu cầu API. Nếu bạn chưa đặt khóa JWT khi cài đặt, hệ thống sẽ tự tạo một khóa ngẫu nhiên. Để lấy khóa mặc định, sử dụng lệnh sau:

docker exec onlyoffice-docs \
    /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

Lệnh này sẽ trả về chuỗi khóa JWT mặc định mà ONLYOFFICE Docs đã tạo.

Lưu ý: Bạn có thể thay thế khóa mặc định bằng một khóa tùy chỉnh bằng cách đặt biến môi trường JWT_SECRET khi khởi động container.

4. Kiểm tra Onlyoffice

ONLYOFFICE Docs có sẵn một công cụ kiểm tra để bạn có thể thử nghiệm Onlyoffice trước khi tích hợp vào hệ thống thực tế. Để kích hoạt trình kiểm tra, chạy lệnh sau:

docker exec onlyoffice-docs \
    sudo supervisorctl start ds:example

Sau đó, bạn có thể truy cập trang thử nghiệm bằng cách mở trình duyệt và nhập địa chỉ IP của server.

Hãy bấm vào GO TO TEST EXAMPLE.

Và chúng ta có kết quả.

Bấm vào Document.

Nếu muốn bật tự động khởi động công cụ thử nghiệm sau mỗi lần khởi động container, sử dụng lệnh:

sudo docker exec onlyoffice-docs \
    sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Lưu ý quan trọng:

• Trình kiểm tra này chỉ dành cho mục đích thử nghiệm, không nên sử dụng trong môi trường production.
• Hãy tắt nó trước khi triển khai thực tế để đảm bảo bảo mật.

Có thể gộp vào một file docker-compose.yml để dễ quản lý. Dưới đây là cách triển khai tương đương bằng Docker Compose:

📌 Tạo file docker-compose.yml

version: "3.8"

services:
  onlyoffice-docs:
    container_name: onlyoffice-docs
    image: onlyoffice/documentserver
    restart: unless-stopped
    ports:
      - "80:80"
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your_secret_key
    volumes:
      - onlyoffice_data:/var/www/onlyoffice
      - onlyoffice_logs:/var/log/onlyoffice
      - onlyoffice_lib:/var/lib/onlyoffice
      - onlyoffice_db:/var/lib/postgresql

volumes:
  onlyoffice_data:
  onlyoffice_logs:
  onlyoffice_lib:
  onlyoffice_db:

📌 Chạy dịch vụ

shell> docker-compose up -d
[+] Running 2/2
 ⠿ Network hoanghd3_default   Created                                                                                                                  0.1s
 ⠿ Container onlyoffice-docs  Started

Xác minh lại container đã chạy.

shell> docker ps
CONTAINER ID   IMAGE                       COMMAND                  CREATED         STATUS         PORTS                         NAMES
b87caa7427a8   onlyoffice/documentserver   "/app/ds/run-documen…"   4 seconds ago   Up 2 seconds   0.0.0.0:80->80/tcp, 443/tcp   onlyoffice-docs                                                                                                            0.7s

Sau khi container chạy, bạn cần thực hiện các lệnh này bên trong container:

docker exec onlyoffice-docs \
    /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

docker exec onlyoffice-docs \
    sed -i 's,autostart=false,autostart=true,' /etc/supervisor/conf.d/ds-example.conf

docker exec onlyoffice-docs supervisorctl reload

Bạn có thể đưa các lệnh này vào một script init.sh và chạy tự động khi container khởi động bằng cách thêm vào entrypoint.sh hoặc command.

5. Tổng kết

Trong bài viết này, chúng ta đã:

✅ Cài đặt ONLYOFFICE Docs Community Edition bằng Docker.

✅ Kiểm tra hoạt động của ONLYOFFICE Docs.

✅ Lấy khóa JWT để bảo mật API.

✅ Sử dụng công cụ kiểm tra Onlyoffice.

Sau khi xác nhận rằng ONLYOFFICE Docs đang hoạt động tốt, bạn có thể tiến hành tích hợp với các nền tảng như Nextcloud, ownCloud, hoặc triển khai theo nhu cầu riêng của mình.

Nếu bạn có bất kỳ câu hỏi hoặc gặp lỗi khi cài đặt, hãy để lại bình luận bên dưới để cùng nhau trao đổi nhé! 🚀