O3O Office Online

Soạn thảo văn bản, bảng tính và trình chiếu ngay trên trình duyệt, chạy trên máy chủ của chính bạn. Đấu vào Nextcloud, nhúng trình soạn thảo vào phần mềm riêng bằng vài dòng JavaScript, và dùng API DocBuilder để chuyển đổi, dựng, điền mẫu tài liệu từ máy chủ.

Tài liệu APIBảng giá
Bản cộng đồng miễn phí 50 kết nối đồng thời · Bản doanh nghiệp tính theo số kết nối · Triển khai bằng Docker
<!-- trang của bạn -->
<div id="editor" style="height:720px"></div>
<script src="https://may-chu-cua-ban/o3o/api.js"></script>
<script>
new O3O.Editor("editor", {
  document: { url: "https://app.vd/hop-dong.docx",
              title: "Hợp đồng.docx",
              fileType: "docx", key: "hd-42-v7" },
  editor: { mode: "edit", lang: "vi",
            user: { id: "u-1001", name: "Nguyễn Văn A" },
            callbackUrl: "https://app.vd/o3o/callback" },
  events: { onSaved: e => console.log("đã lưu", e.version) }
});
</script>
Trạng thái v1. O3O Office Online v1 là bản Docker để đội phát triển tự dựng, đấu nối và thử trên máy của mình. Ở chế độ DEV, máy chủ soạn thảo chạy image mã nguồn mở của thượng nguồn, ghim theo digest, chỉ dùng để thử nội bộ; giao diện của image này mang tên và logo của thượng nguồn. Image DEV có trần riêng 20 kết nối và 10 tài liệu, nên trên máy DEV số phiên soạn thảo dừng ở khoảng 20 dù /o3o/status báo trần 50 của bản cộng đồng; trên image này bản cộng đồng chưa đạt tới 50 kết nối. Dùng đủ số kết nối của gói, kể cả mọi đơn doanh nghiệp, cần image O3O dựng từ nguồn; đơn trên 50 kết nối còn cần dựng image đó với trần đủ lớn. Image O3O Office Online dựng từ mã nguồn, mang thương hiệu O3O: sắp có. Số đo hiệu năng: chưa đo.

Bốn cách dùng

Một bản Docker, một cổng vào duy nhất. Chọn cách dùng hợp với hệ thống của bạn, hoặc dùng cả bốn.

Soạn thảo trên trình duyệt

Mở và sửa văn bản, bảng tính, trình chiếu (.docx, .xlsx, .pptx, .odt, .ods, .odp và các định dạng quen thuộc khác) ngay trong trình duyệt; nhiều người cùng sửa một tài liệu. Tệp nằm trên máy chủ của bạn.

Đấu vào Nextcloud

Hồ sơ nextcloud trong tệp compose dựng sẵn Nextcloud 30, MariaDB và Redis để thử; scripts/setup-nextcloud.sh đấu nối tự động. Với Nextcloud đang chạy: cài ứng dụng richdocuments, chạy occ richdocuments:activate-config -w <địa chỉ máy chủ soạn thảo> -c <địa chỉ Nextcloud>, rồi bấm vào tệp để soạn.

Nhúng vào phần mềm riêng

Nạp /o3o/api.js, gọi new O3O.Editor(...). Không cần Nextcloud: gate tải tệp từ URL bạn đưa, đóng vai WOPI host nội bộ và gửi bản đã lưu về callbackUrl kèm chữ ký HMAC. 7 sự kiện, 5 phương thức, cấu hình ký JWT HS256.

DocBuilder

API REST /v1/ với 11 endpoint: chuyển đổi định dạng, dựng tài liệu từ kịch bản JSON o3oscript, điền mẫu {{truong}} và lặp hàng bảng, trích văn bản, siêu dữ liệu, ảnh thu nhỏ. Chạy đồng bộ hoặc theo job.

Ai nên dùng

Phù hợp với

  • Doanh nghiệp, cơ quan đang dùng Nextcloud: soạn thảo trực tiếp trên kho tệp nội bộ, tài liệu không rời máy chủ của đơn vị.
  • Đơn vị làm phần mềm quản lý văn bản, hồ sơ, hợp đồng, nhân sự, ERP: nhúng trình soạn thảo vào sản phẩm và nhận bản đã lưu qua callback.
  • Hệ thống cần sinh tài liệu tự động: báo giá, hợp đồng, bảng lương, báo cáo, gọi DocBuilder từ máy chủ mà không mở giao diện.
  • Đội kỹ thuật muốn tự vận hành tại chỗ, kiểm soát dữ liệu và dựng thử bằng Docker trên máy của mình.

Chưa phù hợp nếu bạn cần

  • Dịch vụ đám mây do o3o.vn vận hành sẵn: v1 chỉ phát hành bản tự dựng.
  • Giao diện mang thương hiệu riêng ngay bây giờ: nhãn trắng sắp có.
  • Số liệu hiệu năng cam kết: chưa đo, sẽ công bố khi có phép đo thật.
  • Kích hoạt bản quyền trực tuyến: v1 xác minh token ngoại tuyến; kích hoạt trực tuyến sắp có.

Kiến trúc

Mọi yêu cầu đi qua proxy ở cổng 8080. Trước khi mở một phiên soạn thảo, proxy hỏi gate: còn trong trần kết nối của gói thì cho vào, hết chỗ thì hiện trang thông báo, phiên đang mở không bao giờ bị ngắt và thao tác lưu không bao giờ bị chặn.

Trình duyệt của người dùngmở tài liệu từ Nextcloud hoặc từ trang có nhúng O3O.Editor
Máy chủ của hệ thống tích hợptạo phiên nhúng, nhận callback, gọi API DocBuilder
HTTP và WebSocket qua một cổng duy nhất
o3o-proxynginx · cổng 8080/browser /cool /hosting → o3o-online · /o3o/ → o3o-gate · /v1/ → o3o-docbuilder · mở phiên soạn thảo phải hỏi gate trước
/browser /cool /hosting/o3o//v1/
o3o-onlinecổng 9980máy chủ soạn thảo cộng tác trên trình duyệt
o3o-gatecổng 8070đếm kết nối và áp trần theo gói, token bản quyền, lớp nhúng O3O.Editor, WOPI host nội bộ, callback
o3o-docbuildercổng 8060API REST: chuyển đổi, dựng từ o3oscript, điền mẫu, trích xuất; hồ chứa tiến trình xử lý không giao diện
WOPI: CheckFileInfo, GetFile, PutFile (máy chủ soạn thảo đọc và lưu tệp)
Hồ sơ "nextcloud" (tuỳ chọn)cổng 8081nextcloud:30-apache · mariadb:11 · redis:7-alpine · hoặc Nextcloud sẵn có của bạn; phiên nhúng thì o3o-gate đóng vai WOPI host

Phạm vi của v1

có trong v1 Đã có trong v1

  • Tệp compose dựng proxy, máy chủ soạn thảo, gate và DocBuilder; hồ sơ nextcloud tuỳ chọn; script sinh bí mật và kiểm khói.
  • Đếm phiên soạn thảo và áp trần theo gói; trang báo chạm trần tiếng Việt; không ngắt phiên đang mở, không chặn lưu; cho qua khi bộ đếm lỗi.
  • Token bản quyền ký Ed25519, xác minh ngoại tuyến; nhật ký đối soát số kết nối mỗi 5 phút (CSV).
  • O3O.Editor: 7 sự kiện, 5 phương thức, phiên nhúng, WOPI host nội bộ, callback ký HMAC, JWT HS256, chống SSRF; trang thử /o3o/demo ở chế độ DEV.
  • DocBuilder: 11 endpoint, khoá API và JWT, hạn mức theo gói, o3oscript v1 cho văn bản, bảng tính, trình chiếu; điền mẫu và lặp hàng bảng; trích văn bản, siêu dữ liệu, ảnh thu nhỏ.

sắp có Chưa có, sẽ làm tiếp

  • Image O3O Office Online dựng từ nguồn, dùng đủ số kết nối của gói; kho công bố phần O3O sửa trong mã MPL; nhãn trắng (logo, tên sản phẩm, màu) cho bản doanh nghiệp.
  • Mua, kích hoạt trực tuyến, báo nhịp và thu hồi bản quyền qua office.o3o.vn.
  • Vượt mềm cho bản doanh nghiệp; thống kê P95 theo 30 ngày; biểu đồ sử dụng; chỉ số Prometheus.
  • Nhiều máy chủ soạn thảo sau một gate; kết nối oCIS.
  • Lớp nhúng: giao diện tối, thuỷ vân, ẩn hiện từng nút, lưu thành tệp khác, lịch sử phiên bản.
  • DocBuilder: điền mẫu hàng loạt, so sánh tài liệu, biểu đồ trong o3oscript, SDK npm, PyPI, NuGet, Go, hàng đợi bền vững, lõi O3O 26.8.

Gói và giá

Một kết nối là một phiên soạn thảo đồng thời, tính theo quyền sửa của phiên chứ không theo việc có đang gõ hay không. Phiên mở với quyền chỉ đọc và việc của DocBuilder không tính. Bảng giá chi tiết và máy tính giá

Bản cộng đồng

0 USD
  • 50 kết nối đồng thời
  • Image DEV thử nội bộ dừng ở 20 kết nối
  • Không cần token bản quyền
  • Nhúng trình soạn thảo, đấu Nextcloud
  • API DocBuilder giới hạn
Dựng thử

Bản doanh nghiệp, thuê bao năm

3,5–5 USD

mỗi kết nối mỗi năm, tuỳ số lượng

  • Tối thiểu 50 kết nối mỗi đơn
  • Dùng đủ số kết nối đã mua cần image O3O dựng từ nguồn: sắp có
  • API DocBuilder đầy đủ, callback của job
  • Hạn mức DocBuilder theo số kết nối
Tính giá

Bản doanh nghiệp, vĩnh viễn

8–10 USD

mỗi kết nối, trả một lần, kèm 3 năm cập nhật

  • Tối thiểu 50 kết nối mỗi đơn
  • Dùng đủ số kết nối đã mua cần image O3O dựng từ nguồn: sắp có
  • Cùng quyền lợi bản doanh nghiệp
  • Dùng không thời hạn, cập nhật 3 năm
Xem bảng giá

Bắt đầu

  1. Nhận bản Docker (thư mục online/) bằng cách gửi yêu cầu tới office@o3o.vn. Kho mã công khai: sắp có.
  2. Trong thư mục online/, tạo .env cho máy thử bằng bash scripts/gen-secrets.sh --dev (PowerShell: scripts\gen-secrets.ps1 -Dev). Script chép .env.example thành .env và thay mọi giá trị CHANGE_ME bằng chuỗi ngẫu nhiên (mật khẩu quản trị máy chủ soạn thảo, khoá JWT, khoá callback, khoá API DocBuilder). Máy chạy thật chạy lệnh này không có --dev.
  3. Dựng và chạy:
docker compose --env-file .env -f docker/compose.dev.yml up -d
# thêm Nextcloud để thử đấu nối
docker compose --env-file .env -f docker/compose.dev.yml --profile nextcloud up -d
  1. Kiểm tra: http://localhost:8080/o3o/status (trạng thái, gói, số kết nối), http://localhost:8080/v1/status (DocBuilder), và trang thử nhúng http://localhost:8080/o3o/demo khi O3O_DEV_MODE=1 (tuỳ chọn --dev đặt sẵn).
  2. Có token bản quyền doanh nghiệp: đặt vào biến O3O_LICENSE_TOKEN hoặc tệp O3O_LICENSE_FILE; gate đọc lại mỗi 60 giây, không cần khởi động lại.

Hướng dẫn đầy đủ, biến môi trường và cách xử lý sự cố nằm trong online/README.md và tại tài liệu API.

Giấy phép và mã nguồn

Máy chủ soạn thảo là mã nguồn mở theo giấy phép MPL 2.0. Ở v1, chế độ DEV dùng nguyên bản image của thượng nguồn (ghim theo digest, chỉ cấu hình bằng biến môi trường); O3O không sửa mã trong image đó. Khi phát hành image O3O dựng từ nguồn, phần O3O sửa trong mã MPL sẽ được công bố cho người nhận image theo đúng giấy phép; image này và kho công bố mã hiện sắp có. Gate và api.js là mã của O3O, giao tiếp với máy chủ soạn thảo qua HTTP và WebSocket.

Mã riêng của O3O DocBuilder do O3O sở hữu. DocBuilder không sửa mã LibreOffice, nhưng image DocBuilder được phân phối KÈM LibreOffice cài nguyên bản từ kho gói Debian (giấy phép MPL 2.0, một phần mã theo LGPL v3+ và các giấy phép khác). Vì vậy khi phân phối image DocBuilder phải kèm thông báo giấy phép của LibreOffice và các gói Debian, và chỉ rõ nơi lấy mã nguồn tương ứng (kho gói nguồn của Debian). Lõi này khác phiên bản lõi của O3O Office cài trên máy; phiên bản lõi đang chạy được báo ở GET /v1/status. Chuyển DocBuilder sang lõi O3O 26.8: sắp có.

Yêu cầu mã nguồnTài liệu API

Cần triển khai cho đơn vị của bạn?

Dựng thử bản cộng đồng, hoặc liên hệ để nhận báo giá bản doanh nghiệp. Hotline 0888 787 980.

Bảng giáLiên hệ