Bỏ qua, tới nội dung
Tài liệu APIv1

Tích hợp lưu trữ

Nextcloud AIO và Nextcloud cài sẵn Beta

Chạy occ trên Nextcloud cài sẵn, snap hay docker, và những gì Nextcloud All-in-One tự ghi đè khi đấu với máy chủ O3O.

Trang này mô tả tính năng đang ở giai đoạn beta: đã chạy được nhưng có thể còn thay đổi.

Trong trang này

Trang Nextcloud dùng Nextcloud đi kèm bản Docker DEV. Trang này dành cho hai trường hợp khác: một Nextcloud đã chạy sẵn ở nơi khác, và Nextcloud All-in-One (AIO). Cơ chế giống nhau, khác ở chỗ chạy lệnh occ và ở những thứ tự động ghi đè cấu hình.

Nextcloud cài sẵn#

Bạn nắm toàn quyền config.phpocc, không có gì tự ghi đè. Làm đúng các bước của trang Nextcloud, chỉ đổi cách gọi occ và dùng địa chỉ thật:

  • -w: địa chỉ Nextcloud gọi tới máy chủ O3O, ví dụ https://office.example.com.
  • -c: địa chỉ máy chủ O3O gọi ngược về Nextcloud. Luôn truyền -c, kể cả khi địa chỉ người dùng mở Nextcloud cũng gọi được từ máy chủ O3O (khi đó truyền chính địa chỉ ấy): chạy activate-config thiếu -c thì richdocuments xoá wopi_callback_url về rỗng.
  • Phía O3O: O3O_ONLINE_ALIASGROUP2 chứa gốc của địa chỉ ở -c, rồi khởi động lại o3o-online.
BashChạy occ theo từng kiểu cài
# Cài trực tiếp trên máy (gói, tệp nén)
sudo -u www-data php /var/www/nextcloud/occ app:install richdocuments
sudo -u www-data php /var/www/nextcloud/occ richdocuments:activate-config -w https://office.example.com -c https://cloud.example.com

# Bản snap
sudo nextcloud.occ app:install richdocuments
sudo nextcloud.occ richdocuments:activate-config -w https://office.example.com -c https://cloud.example.com

# Image docker chính thức, compose của riêng bạn
docker exec --user www-data <tên-container-nextcloud> php occ app:install richdocuments
docker exec --user www-data <tên-container-nextcloud> php occ richdocuments:activate-config -w https://office.example.com -c https://cloud.example.com

Nextcloud All-in-One#

AIO là một container chủ quản lý các container con. Máy chủ office là một container tuỳ chọn của AIO. Khi tuỳ chọn đó bật, mỗi lần khởi động AIO ghi đè wopi_url và tự tính wopi_allowlist, nên mọi giá trị bạn đặt tay sẽ mất.

  1. Không bật máy chủ office đi kèm trong giao diện AIO.
  2. Tạo mastercontainer với REMOVE_DISABLED_APPS=no; nếu không, AIO gỡ luôn richdocuments khi thấy máy chủ office đi kèm đang tắt.
  3. Cài và cấu hình richdocuments bằng tay, trỏ tới máy chủ O3O có tên miền và chứng chỉ riêng (AIO chỉ lo TLS cho tên miền Nextcloud).
  4. Nếu Nextcloud đứng sau Cloudflare hay một CDN, thêm dải IP của nó vào wopi_allowlist trong trang quản trị Nextcloud Office.
BashCấu hình tay trên AIO
# 1. Tạo lại mastercontainer với REMOVE_DISABLED_APPS=no (giữ nguyên các tham số khác bạn đang dùng)
#    ... --env REMOVE_DISABLED_APPS=no ... nextcloud/all-in-one:latest

# 2. Trong giao diện AIO: KHÔNG bật tuỳ chọn máy chủ office đi kèm của AIO, rồi khởi động lại các container

# 3. Cấu hình tay richdocuments trỏ tới máy chủ O3O; luôn kèm -c (địa chỉ máy chủ O3O gọi ngược về Nextcloud)
sudo docker exec --user www-data nextcloud-aio-nextcloud php occ app:install richdocuments
sudo docker exec --user www-data nextcloud-aio-nextcloud php occ richdocuments:activate-config -w https://office.example.com -c https://cloud.example.com
sudo docker exec --user www-data nextcloud-aio-nextcloud php occ config:app:get richdocuments public_wopi_url
sudo docker exec --user www-data nextcloud-aio-nextcloud php occ config:app:get richdocuments wopi_callback_url

So sánh nhanh#

Nextcloud cài sẵnNextcloud AIO
Chạy occngười dùng web server, snap, hoặc docker execdocker exec --user www-data nextcloud-aio-nextcloud php occ
Cấu hình có bị ghi đèKhôngCó, nếu bật máy chủ office đi kèm
TLS cho máy chủ O3OBạn tự loBạn tự lo; AIO không proxy hộ
Đã kiểm chứng trong v1Lệnh occ trên Nextcloud 30Chưa