Bản quyền và hai bản

O3O Office Online 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 tính theo số kết nối. Không cần cài lại khi nâng cấp: chỉ cần nạp token bản quyền.

Hai bản khác nhau thế nào#

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.

1. Đặt token

   Hoặc dán vào O3O_LICENSE_TOKEN trong online/.env, hoặc lưu thành tệp và gắn vào cả o3o-gate lẫn o3o-docbuilder tại /etc/o3o/license.token.

2. 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.

3. Kiểm

   GET /o3o/status phải báo license.state = "valid", edition = "enterprise" và connections.limit bằng số kết nối đã mua; GET /v1/limits phải báo edition = "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 O3O (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 thái token#

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ủ O3O 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ó mid bằng instance_id trong /o3o/status. Khi dùng token gắn instance, đặt O3O_GATE_INSTANCE_ID tường minh trong .env để gate và DocBuilder cùng một mã; scripts/gen-secrets.sh (hoặc gen-secrets.ps1) sinh sẵn mã này khi tạo .env mới.

Gia hạn và mua thêm kết nối#

O3O 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.

Bảng giá tóm tắt#

Giá niêm yết bằng USD. Đơn giá áp cho TOÀN BỘ số kết nối của đơn (không luỹ tiến theo bậc). Tối thiểu 50 kết nối mỗi đơn. Bản vĩnh viễn kèm 3 năm cập nhật.

Quy tắc không bao giờ đắt hơn#

tiền_thu(n) = min(m × đơn_giá(m)) với mọi m ≥ n và m ≥ 50. Khi giá rẻ nhất rơi vào m > n, khách trả tiền của mốc m và ĐƯỢC CẤP m kết nối. Nhờ vậy mua nhiều hơn không bao giờ phải trả nhiều hơn tại ranh giới bậc.

Hoá đơn ghi và token cấp đúng số kết nối của mốc được tính, không phải số khách nhập. Ví dụ thuê bao năm: chọn 190 kết nối thì hoá đơn tính 201 kết nối × 4,5 USD = 904,5 USD, và token có conns = 201.

Thanh toán bằng VNĐ: tỷ giá USD sang VNĐ được chốt và lưu lúc TẠO đơn; mã QR thanh toán giữ đúng số tiền đó. Đơn hết hạn mà chưa thanh toán thì tạo đơn mới, tính theo tỷ giá tại thời điểm tạo đơn mới.