Nền tảng
Bản quyền và hai bản
Bản cộng đồng và bản doanh nghiệp khác gì, cách nạp token bản quyền, hoạt động ngoại tuyến, trạng thái token và giá.
Trong trang này
MORA Office Online tự cài có hai bản chạy trên cùng một bộ cài: bản cộng đồng miễn phí và bản doanh nghiệp. Không cần cài lại khi nâng cấp: chỉ cần nạp token bản quyền. Giá bản doanh nghiệp theo bảng giá MORA (mục Giá).
Hai bản khác nhau thế nào#
| Hạng mục | Bản cộng đồng | Bản doanh nghiệp |
|---|---|---|
| Giá | Miễn phí | Theo MORA Self-host (tính theo người dùng) hoặc báo giá tích hợp, xem mục Giá bên dưới |
| Token bản quyền | không | có |
| Kết nối soạn thảo đồng thời | 50 | Đúng bằng conns trong token, kể cả khi nhỏ hơn 50; đơn mua tối thiểu 50 |
| Nhúng trình soạn thảo và callback lưu | có | có |
| Endpoint DocBuilder | 10 endpoint, không có điền mẫu | Đủ 11 endpoint (token có api_full) |
| Tần suất DocBuilder | 10/phút, 200/ngày | 60–3.000/phút theo số kết nối, không giới hạn ngày |
| Cỡ tệp DocBuilder tối đa | 10 MB | 300 MB |
| Callback khi job xong | không | có (token có callback) |
| Nhãn trắng | không | Sắp có, chỉ với image MORA dựng từ nguồn |
| Vượt mềm | không | Sắp có |
Chi tiết từng hạn mức: Hạn mức theo gói. Cách đếm kết nối: Kết nối được đếm thế nào.
Nạp token bản quyền#
Gate và DocBuilder cùng đọc token theo thứ tự: biến O3O_LICENSE_TOKEN nếu khác rỗng, rồi tới tệp O3O_LICENSE_FILE (mặc định /etc/o3o/license.token) nếu tồn tại, cuối cùng là không có token (bản cộng đồng). Khoảng trắng và xuống dòng ở đầu và cuối bị cắt. Tệp được đọc lại mỗi 60 giây, nên thay tệp không cần khởi động lại; đổi biến môi trường thì cần tạo lại container.
Đặt token
Hoặc dán vàoO3O_LICENSE_TOKENtrongonline/.env, hoặc lưu thành tệp và gắn vào cảo3o-gatelẫno3o-docbuildertại/etc/o3o/license.token.Nạp
Với biến môi trường:docker compose ... up -d. Với tệp: chờ tối đa 60 giây.Kiểm
GET /o3o/statusphải báolicense.state = "valid",edition = "enterprise"vàconnections.limitbằng số kết nối đã mua;GET /v1/limitsphải báoedition = "enterprise".
# Cách 1: biến môi trường trong online/.env (token rút gọn cho dễ đọc)
O3O_LICENSE_TOKEN=eyJ2IjoxLCJrZXkiOiJPT1NZLTdLMk05LVE0WEJDLUQ4SEpOLVIzVFdaIiwicGxhbiI6InllYXIiLCJwcm9kIjoibzNvLW9ubGluZSIs...base64...==.W2m7...base64...==
# Cách 2: tệp; để trống O3O_LICENSE_TOKEN
O3O_LICENSE_TOKEN=
O3O_LICENSE_FILE=/etc/o3o/license.token
# Kiểm sau khi nạp
curl -s http://localhost:8080/o3o/status | jq '{edition, license: .license.state, limit: .connections.limit}'
curl -s http://localhost:8080/v1/limits -H "Authorization: Bearer O3O_DEMO_KEY" | jq .edition# docker/compose.license.yml, dùng kèm: -f docker/compose.dev.yml -f docker/compose.license.yml
# ./license.token tính từ thư mục của tệp compose đầu tiên (online/docker/)
services:
o3o-gate:
volumes:
- ./license.token:/etc/o3o/license.token:ro
o3o-docbuilder:
volumes:
- ./license.token:/etc/o3o/license.token:roĐịnh dạng token#
Token là base64(payload_json) + "." + base64(chữ_ký): Base64 chuẩn có đệm = (bảng chữ +/), đúng một dấu chấm, chữ ký Ed25519 trên đúng chuỗi byte của payload. Gate và DocBuilder kiểm bằng khoá công khai của máy chủ bản quyền MORA (O3O_LICENSE_PUBKEY). Trường lạ trong payload bị bỏ qua.
{
"v": 1,
"key": "OOSY-7K2M9-Q4XBC-D8HJN-R3TWZ",
"plan": "year",
"prod": "o3o-online",
"mid": "",
"cust": "Công ty TNHH An Phát",
"exp": "2027-09-30",
"upd": "2027-10-07",
"iat": 1790000000,
"lid": 123,
"kind": "enterprise",
"conns": 200,
"feat": [
"api_full",
"callback"
]
}Trường của payload
vnumberbắt buộcPhiên bản định dạng:1hoặc2.prodstringbắt buộcPhải lào3o-online.kindstringbắt buộcenterprisehoặccommunity; chỉenterprisemới nâng gói.connsintegerbắt buộcSố kết nối đã mua, từ 1 trở lên. Với token doanh nghiệp hợp lệ, trần kết nối đúng bằng số này, kể cả khi nhỏ hơn 50 của bản cộng đồng.planstringbắt buộcyear(thuê bao năm) hoặclife(vĩnh viễn).expstringtuỳ chọnYYYY-MM-DD, bắt buộc vớiyear; có hiệu lực tới HẾT ngày đó theo giờ UTC+7.updstringtuỳ chọnYYYY-MM-DD: hết quyền nhận cập nhật. Image dựng sau ngày này không nhận token. Với gói năm, máy chủ bản quyền đặtupd = exp + 7 ngày(bằng thời gian ân hạn, khớp với gate).featarraytuỳ chọnMặc định:[]Tính năng:whitelabel,api_full(DocBuilder đầy đủ),callback(callback của DocBuilder).midstringtuỳ chọnMã instance được gắn; rỗng, vắng hoặc*là không gắn.keystringbắt buộcMã bản quyền, dạngOOSY-XXXXX-XXXXX-XXXXX-XXXXX(thuê bao năm) hoặcOOSL-…(vĩnh viễn). Gate không kiểm dạng mã;/o3o/statuschỉ hiện 5 ký tự cuối (key_hint).custstringtuỳ chọnTên khách hàng.iatnumberbắt buộcThời điểm ký, giây Unix.lidnumbertuỳ chọnMã nội bộ của máy chủ bản quyền; gate và DocBuilder bỏ qua.aidnumbertuỳ chọnMã lần kích hoạt nội bộ, chỉ có khi token gắn với một lần kích hoạt; gate và DocBuilder bỏ qua.
Trạng thái token#
license.state | Nghĩa | Gói hiệu lực |
|---|---|---|
none | Không có token. | cộng đồng |
valid | Chữ ký đúng, còn hạn. | doanh nghiệp (khi kind = enterprise) |
grace | Gói năm đã qua exp không quá 7 ngày; grace_days_left là số ngày còn lại. | doanh nghiệp |
expired | Quá 7 ngày sau exp. | cộng đồng |
invalid | Hỏng định dạng, sai chữ ký, sai trường bắt buộc, hoặc khoá THỬ khi không ở chế độ DEV. | cộng đồng |
wrong_product | prod khác o3o-online. | cộng đồng |
update_expired | Image dựng sau ngày upd. | cộng đồng |
instance_mismatch | Token gắn với instance khác (mid). | cộng đồng |
Hoạt động khi không có mạng#
- Token được xác minh hoàn toàn NGOẠI TUYẾN bằng khoá công khai Ed25519 có sẵn trong cấu hình; máy chủ MORA của bạn không gọi về office.o3o.vn và không gửi số liệu sử dụng đi đâu.
- Máy chủ trong mạng kín vẫn nhận đủ bản doanh nghiệp cho tới
exp, cộng 7 ngày ân hạn với gói năm. - Bản vĩnh viễn không hết hạn; quyền nhận cập nhật kết thúc ở
upd: các image dựng trước ngày đó tiếp tục dùng token mãi mãi. - Muốn gắn token vào đúng một máy chủ, yêu cầu token có
midbằnginstance_idtrong/o3o/status. Khi dùng token gắn instance, đặtO3O_GATE_INSTANCE_IDtường minh trong.envđể gate và DocBuilder cùng một mã;scripts/gen-secrets.sh(hoặcgen-secrets.ps1) sinh sẵn mã này khi tạo.envmới.
Kích hoạt trực tuyến bằng mã bản quyền, báo nhịp và thu hồi bản quyền qua máy chủ office.o3o.vn. v1 chỉ xác minh ngoại tuyến.
Gia hạn và nâng hạn mức#
MORA ký và giao token mới khi đơn hàng hoàn tất. Thay token theo đúng cách đã nạp; gate nhận token mới trong vòng 60 giây (tệp) hoặc sau khi tạo lại container (biến môi trường). Phiên đang mở không bị ảnh hưởng.
Giá#
Từ 15/11/2026, MORA Office Online không bán riêng theo số kết nối. Bản tự cài cấp token doanh nghiệp theo MORA Self-host: 49.000đ mỗi người dùng mỗi tháng, tối thiểu 50 người dùng, thanh toán 12 tháng một lần; triển khai, tích hợp API và hỗ trợ đặc thù báo giá riêng. MORA Office Online dùng trực tuyến có sẵn trong các gói MORA Cá nhân và Doanh nghiệp.