Integrating Collabora Online with ownCloud Infinite Scale (oCIS) is a WOPI integration, not the same setup used by ownCloud Classic. WOPI, or Web Application Open Platform Interface, is the protocol that lets an online office suite request a file from a storage platform, edit it in the browser, and write the result back.
That distinction matters because current Infinite Scale deployments use the built-in collaboration service as the bridge between oCIS and Collabora. You do not install the old ownCloud Classic Collabora app and point it at a server URL. The office application is registered through the collaboration and app-registry services instead. The official ownCloud WOPI documentation lists Collabora as a supported office application, while the collaboration service documentation explains the service and its required settings.
As of October 2026, ownCloud's official GitHub releases include Infinite Scale 8.2.0, released August 10, 2026. The project's deployment example may evolve independently, so use a tested production tag rather than assuming a rolling image is appropriate. The official oCIS full deployment example currently recommends Collabora CODE tag 26.04.3.1.1 in its environment file. Check the official Infinite Scale releases and the official deployment example environment file before pinning versions.
A production integration normally involves three logical endpoints:
| Endpoint | Purpose | Example |
|---|---|---|
| Infinite Scale | User-facing ownCloud Web and storage APIs | https://cloud.example.com |
| Collabora Online | Browser editor and WOPI client | https://office.example.com |
| WOPI/collaboration service | Bridge through which Collabora reads and writes oCIS files | Internal service URL or externally routed WOPI hostname, depending on topology |
Verified: COLLABORATION_APP_ADDR is the Collabora URL, and COLLABORATION_WOPI_SRC identifies the WOPI source used by the office application. Environment-dependent: the WOPI source does not have to be a separate public hostname when Collabora and the collaboration service share a trusted container network. The current official Compose example uses http://collaboration:9300 internally. A separated deployment may require a routed HTTPS WOPI hostname.
Useful action: decide your topology before copying configuration values. If all components run in one official Compose stack, start from that example. If Collabora is on another host or Kubernetes cluster, document which DNS name each side can actually resolve and reach.
Before touching oCIS configuration, make sure the ownCloud and Collabora names resolve correctly and that Collabora exposes its discovery endpoint. Collabora publishes WOPI capabilities through /hosting/discovery. A basic check is:
dig +short cloud.example.com
dig +short office.example.com
curl -fsS https://office.example.com/hosting/discovery | headYou should receive XML from the discovery endpoint. If TLS terminates at a reverse proxy, confirm that the certificate presented for office.example.com is valid from the perspective of the oCIS host or container network.
Caption: Check name resolution and the Collabora /hosting/discovery endpoint before debugging WOPI registration inside Infinite Scale.
Common misunderstanding: seeing a Collabora landing page in a browser does not prove the WOPI integration works. It proves the web endpoint is reachable. The collaboration service must also reach Collabora, and Collabora must be able to reach the WOPI source.
Useful action: run connectivity tests from the same network namespace as the relevant service—for example, from inside the collaboration container when using Docker.
The collaboration service is not started automatically by a generic ocis server supervised-mode setup. The ownCloud documentation states that it must be started explicitly, because administrators may run more than one collaboration-service instance for different office products.
The important settings for Collabora are:
COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.comThe exact WOPI source above matches the topology used by the current official Compose example: Collabora and the collaboration service share the same Docker network. If your Collabora server is external, replace the internal URL with the address that Collabora can reach.
The service also depends on Infinite Scale's gateway and app-provider infrastructure. In a split-container deployment, the ownCloud documentation specifically warns that the oCIS configuration must be shared with the collaboration container because generated secrets are required across services. See the current official Collabora Compose definition.
Caption: A collaboration-service process should start with the intended Collabora address and WOPI source; use real service logs to confirm the values in your deployment.
Useful action: if you built the deployment manually, compare your environment against the official collabora.yml instead of copying settings from an old cs3org/wopiserver tutorial.
Collabora must trust the WOPI host and be allowed to render inside the ownCloud Web page. The official oCIS Compose example passes Collabora options that terminate TLS at the reverse proxy and set net.frame_ancestors to the oCIS domain. It also generates a WOPI proof key before starting Collabora.
In the official example, relevant Collabora-side values include:
DONT_GEN_SSL_CERT=YES
extra_params:
--o:ssl.enable=...
--o:ssl.ssl_verification=...
--o:ssl.termination=true
--o:welcome.enable=false
--o:net.frame_ancestors=cloud.example.comDokładne flagi SSL zależą od miejsca zakończenia protokołu TLS. Zalecanym rozwiązaniem skierowanym do Internetu jest protokół HTTPS z włączoną weryfikacją certyfikatów. INSECURE=trueOpcja podana w przykładzie istnieje dla konfiguracji lokalnych z certyfikatami podpisanymi samodzielnie; przewodnik wdrażania ownCloud wyraźnie zaleca administratorom usunięcie tej opcji lub ustawienie jej na fałsz w przypadku serwerów publicznych.
Podpis: Jednym z warunków wstępnych jest dostępność punktu końcowego Collabora; wdrożenia produkcyjne powinny udostępniać go za pośrednictwem protokołu HTTPS z certyfikatem zaufanym przez pozostałe komponenty.
Przydatne działanie: jeśli ładowanie dokumentu powoduje błąd pustej ramki iframe lub CSP, sprawdź narzędzia programistyczne przeglądarki i nagłówki odwrotnego proxy. Nie wyłączaj weryfikacji certyfikatów ani ograniczeń bezpieczeństwa treści tylko po to, aby strona się załadowała.
Usługa rejestru aplikacji Infinite Scale decyduje, która aplikacja może otwierać poszczególne typy MIME. Jej konfiguracja może definiować typ MIME, rozszerzenie, ikonę, domyślną aplikację oraz to, czy użytkownicy mogą tworzyć nowe pliki tego typu. Oficjalna dokumentacja rejestru aplikacji opisuje te pola.
Kluczowym szczegółem jest to, że nazwa aplikacji używana przez rejestr musi odpowiadać faktycznie zarejestrowanemu dostawcy współpracy. Aktualne oficjalne przykłady wdrożeń Collabora używają nazw CollaboraOnlineas COLLABORATION_APP_NAMEi Collaborajako nazwy produktu. Nie należy mieszać nazw skopiowanych ze starszych przykładów bez sprawdzenia wersji wdrożenia.
Po uruchomieniu zaloguj się do ownCloud Web i otwórz obsługiwany dokument Office. Pomyślny przepływ wygląda następująco:
Podpis: Ostatecznym testem jest otwarcie prawdziwego dokumentu biurowego z ownCloud Web, edycja go w Collabora, zamknięcie i potwierdzenie, że zapisana wersja jest ponownie widoczna w Infinite Scale.
Przydatne działanie: wprowadź niewielką zmianę w jednorazowym dokumencie testowym, zamknij edytor, otwórz ponownie plik i sprawdź, czy zmiana została zachowana. Strona, która jedynie ładuje edytor, nie jest kompletnym testem ścieżki zapisu.
W przypadku konwencjonalnego wdrożenia Dockera, ścieżka o najniższym ryzyku to ocis_fullprzykład utrzymywany przez ownCloud. Obejmuje on Infinite Scale, usługę współpracy, Collabora i Traefik. Oficjalny przewodnik mówi, że wdrożenie wymaga domen dla oCIS i Collabora oraz dokumentuje komponent WOPI jako część stosu. Zobacz oficjalny pełny przewodnik wdrożenia .
Typowy plik środowiska zorientowanego na produkcję zawiera wartości koncepcyjne takie jak:
OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com
COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com
INSECURE=falseNastępnie uruchom stos za pomocą:
docker compose pull
docker compose up -d
docker compose psZweryfikowano: aktualny oficjalny przykład odwrotnego proxy umożliwia zakodowane ukośniki, znaki zapytania i znaki procent w punkcie wejścia HTTPS, ponieważ Collabora/Collabora ich wymaga. Zależne od środowiska: jeśli używasz Nginx, HAProxy, kontrolera ruchu przychodzącego lub modułu równoważenia obciążenia w chmurze zamiast Traefik, musisz odtworzyć wymaganą obsługę adresów URL, zachowanie WebSocket/proxy, certyfikaty i limity czasu na tej platformie.
Przydatna wskazówka: nie tłumacz etykiet Traefik dosłownie na inny serwer proxy. Użyj ich, aby zrozumieć wymagania dotyczące routingu, a następnie zaimplementuj je, korzystając z udokumentowanej składni serwera proxy.
| Objaw | Prawdopodobny obszar | Sprawdź dalej |
|---|---|---|
| Brak opcji biurowej dla DOCX/ODT | Rejestr aplikacji / rejestracja dostawcy | Sprawdź, czy usługa współpracy jest zarejestrowana i czy typ MIME wskazuje na prawidłową nazwę aplikacji. |
| Strona Collabora działa, ale dokument się nie otwiera | Dostępność WOPI | Sprawdź, czy Collabora ma dostęp COLLABORATION_WOPI_SRCdo dzienników współpracy i może je przeglądać. |
| Pusta ramka lub błąd CSP przeglądarki | Konfiguracja ramki/CSP | Sprawdź frame_ancestorsoCIS CSP i rzeczywiste pochodzenie używane przez przeglądarkę. |
| Błąd TLS lub certyfikatu | Odwrotny serwer proxy / łańcuch zaufania | Używaj ważnych certyfikatów w środowisku produkcyjnym i testuj protokół HTTPS z kontenerów usług, a nie tylko ze swojej stacji roboczej. |
| Edytor otwiera się, ale zapisywanie nie powiodło się | Ścieżka zapisu WOPI / współdzielone sekrety | Sprawdź logi współpracy i Collabora i upewnij się, że współdzielona konfiguracja oCIS jest zamontowana tam, gdzie jest to wymagane. |
| Jeden plik otwiera się nieoczekiwanie w wielu pakietach biurowych | Integracje z wieloma biurami | Oficjalny plik środowiska ostrzega obecnie przed włączaniem nakładających się aplikacji pakietu Office, ponieważ nie jest dostępna funkcja blokowania aplikacji w ramach tego samego pliku. |
Wiadomo: Infinite Scale obsługuje Collabora za pośrednictwem WOPI, wbudowana usługa współpracy jest obecnym mostem, a oficjalne pełne wdrożenie zapewnia działającą architekturę referencyjną.
Zależy to od Twojego środowiska: czy punkt końcowy WOPI jest wewnętrznym adresem URL kontenera czy publiczną nazwą hosta, gdzie kończy się protokół TLS, jakiego serwera proxy używasz i czy Collabora działa w tej samej sieci co oCIS.
Nie zakładaj: instrukcje dotyczące ownCloud Classic dotyczą również Infinite Scale. Dokumentacja Classic, która zaleca zainstalowanie aplikacji Collabora/RichDocuments lub skonfigurowanie jej za pomocą interfejsu administratora Classic, opisuje inną architekturę produktu.
Najbardziej niezawodny obieg pracy integracyjnej wygląda następująco: należy zacząć od oficjalnego modelu wdrożenia Infinite Scale, sprawdzić dostępność sieci i protokołu TLS, skonfigurować usługę współpracy, potwierdzić zaufanie Collabora i możliwość nawiązania połączenia z hostem WOPI, zarejestrować odpowiednie typy MIME, a na koniec przetestować otwieranie i zapisywanie prawdziwego dokumentu.
Dowiedz się, jak przeciągać obraz w programie Word, wybierać opcje zawijania tekstu, zachowywać go w akapicie lub mocować na stronie oraz rozwiązywać problemy z obrazami, których nie można przenieść.
Dowiedz się, jak wstawić pole wyboru w programie Excel za pomocą narzędzia w komórce, zliczyć zaznaczone elementy za pomocą formuł lub dodać powiązany formant formularza w starszych wersjach programu na komputery stacjonarne.
Generuj litery od A do Z, małe litery lub etykiety powyżej Z w programie Excel za pomocą formuły z uchwytem wypełniania, SEKWENCJI lub wielokrotnego użytku listy niestandardowej.
Dowiedz się, jak przekreślać wiersze w programie Excel w systemie Windows, na komputerze Mac i w przeglądarce, formatować część komórki i usuwać wiersze bez usuwania ich wartości.
Microsoft Access to aplikacja bazy danych systemu Windows do przechowywania powiązanych rekordów, tworzenia zapytań, tworzenia formularzy wprowadzania danych i generowania raportów. Dowiedz się, jak działa i kiedy się sprawdza.
Dowiedz się, jak zaimportować plik PST do programu Outlook 2010 lub wyeksportować pocztę, kontakty, kalendarz i zadania. Postępuj zgodnie z odpowiednimi menu i unikaj pominiętych folderów lub duplikatów.
Dowiedz się, jak dostosować wysokość i szerokość linii siatki w programie Word 2010, zmienić widoczną częstotliwość linii oraz ustawić odstępy między liniami siatki w pionie i w poziomie.
Za pomocą dodatku LiveWeb możesz umieścić witrynę internetową na slajdzie programu PowerPoint, ustawić jej rozmiar i sposób odświeżania oraz sprawdzić zgodność przed prezentacją.
Odzyskaj zapomniane hasło PST programu Outlook, korzystając z bieżących instrukcji Kernela, obejmujących m.in. identyfikację właściwego pliku, wykonanie kopii zapasowej i sprawdzenie ograniczeń narzędzia.
Dodaj święta krajowe w nowym Outlooku, Outlooku w przeglądarce lub klasycznej wersji Outlooka. Dowiedz się, jak unikać duplikatów wydarzeń i sprawdzać, czy nie brakuje dat z lat 2026–2027.
