Verbind Collabora Online met ownCloud Infinite Scale.

Gebruik de Collaboration-service van ownCloud Infinite Scale als WOPI-brug tussen de webinterface en Collabora Online. Voor een nieuwe installatie is de veiligste optie het officiële modulaire ocis_fullDocker Compose-voorbeeld van ownCloud, dat Infinite Scale, Collaboration, Collabora en Traefik bevat. Stel de openbare URL's voor Infinite Scale, Collabora en WOPI in, gebruik geldige TLS-certificaten en zorg ervoor dat alle servicegeheimen consistent zijn. Configureer dit niet alsof Infinite Scale een klassieke ownCloud Server is.

Dit onderscheid wordt bevestigd in de huidige documentatie van ownCloud: Infinite Scale integreert kantoorsuites via WOPI en de bijbehorende samenwerkingsservice. Deze service vervangt de oudere externe cs3org/wopiserver in nieuwere versies, dus beheerders die een oudere implementatie upgraden, moeten de migratie-instructies voor hun geïnstalleerde versie volgen.

1. Controleer de release- en netwerkvereisten.

Controleer de exacte Infinite Scale-release voordat u iets installeert. De huidige ownCloud-documentatie vermeldt de Collaboration-service in de ontwikkelingsdocumentatie voor versie 9.0 en geeft aan dat deze apart moet worden gestart wanneer Infinite Scale in de beheermodus draait. Het ownCloud full-stack voorbeeld waarschuwt ook dat de installatie afhankelijk is van releases die de Collaboration-service bevatten en niet werkt met productieversies van 5.x. Gebruik documentatie en Compose-bestanden die overeenkomen met uw geïnstalleerde release; kopieer geen voorbeeld uit een rolling release-omgeving naar een ouder productiesysteem zonder de compatibiliteit te controleren.

Voor een publieke implementatie is het raadzaam om aparte hostnamen te gebruiken, zoals cloud.example.com, office.example.com, en wopi.example.com. De browser moet de cloud- en Collabora-URL's kunnen bereiken, terwijl Collabora het WOPI-eindpunt moet kunnen bereiken dat Infinite Scale beschikbaar stelt. DNS, firewalls en TLS-vertrouwen moeten in beide richtingen werken. Een host die wel vanaf uw laptop, maar niet vanaf de Collabora-container bereikbaar is, is niet voldoende.

Het implementatievoorbeeld van ownCloud gebruikt Traefik als reverse proxy en verwacht een geldig SSL-certificaat voor de serverconfiguratie. De lokale testopstelling kan gebruikmaken van zelfondertekende certificaten, maar openbare installaties mogen certificaatverificatie niet stilzwijgend uitschakelen. Bepaal welke hostnamen en certificaten u wilt gebruiken voordat u de stack configureert.

2. Begin met het bijbehorende Compose-voorbeeld van ownCloud.

1. Open de officiële implementatiehandleiding van ownCloud voor het volledig modulaire oCIS met WebOffice en de bijbehorende voorbeeldmap ocis_full . Voor productie kunt u een release of tag gebruiken die overeenkomt met uw Infinite Scale-versie in plaats van te vertrouwen op de rolling branch van de repository.
2. Bekijk het voorbeeldbestand .env. Stel OCIS_DOMAIN, COLLABORA_DOMAIN, en WOPISERVER_DOMAINin op de hostnamen die naar uw server verwijzen. In het voorbeeld wordt Collabora ingeschakeld met COLLABORA=:collabora.yml; behoud deze instelling als Collabora de Office-editor is die u wilt gebruiken.
3. Stel sterke, privé-beheerdersgegevens in en volg de TLS-richtlijnen voor productieomgevingen in het voorbeeld. Laat de voorbeeldwachtwoorden niet ongewijzigd. Als de repositoryversie de namen van omgevingsvariabelen of de bestandsstructuur heeft gewijzigd, gebruik dan de bestanden van diezelfde getagde release in plaats van instructies uit verschillende versies te combineren.
4. Controleer de Compose-configuratie voordat u deze start. Bevestig dat de Collabora-, Collaboration-, Infinite Scale- en proxyservices hetzelfde netwerk en dezelfde configuratie delen. De ownCloud-handleiding waarschuwt dat als Collaboration in een aparte container draait, de relevante Infinite Scale-configuratie en gegenereerde geheimen met de andere services moeten worden gedeeld.

Het implementatievoorbeeld is een geïntegreerde stack, geen universele configuratie voor elke bestaande installatie. Als u Infinite Scale al gebruikt met systemd, Kubernetes of een aangepaste reverse proxy, behoud dan dat implementatiemodel en configureer de Collaboration-service en App Registry volgens de documentatie voor die release in plaats van een tweede volledige stack te lanceren.

3. Verbind samenwerking met Collabora via WOPI

De kerninstellingen identificeren de URL van de editor en de extern bereikbare WOPI-bron. In de huidige servicedocumentatie COLLABORATION_APP_NAMEis de weergavenaam van de app, COLLABORATION_APP_PRODUCTidentificeert het product, COLLABORATION_APP_ADDRverwijst naar Collabora en COLLABORATION_WOPI_SRCis de URL die Collabora gebruikt om bestanden te lezen en te schrijven via Infinite Scale. Een conceptuele configuratie ziet er als volgt uit:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Gebruik de daadwerkelijke openbare URL's en de variabele indeling die vereist zijn voor uw implementatie. Als de services communiceren via een intern containernetwerk, kan het interne adres geschikt zijn voor de ene situatie, terwijl de URL voor de browser in een andere situatie thuishoort. Vervang geen hostnaam die alleen voor de container geldt door een waarde die Collabora extern moet kunnen oplossen.

De samenwerkingsservice vereist ook de runtime-waarden OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, en voor Infinite Scale MICRO_REGISTRY_ADDRESS. Deze moeten overeenkomen met de actieve instantie; het officiële full-stack voorbeeld biedt service-relaties voor zijn eigen Compose-netwerk. Verzin geen nieuwe geheimen voor slechts één service en schakel geen WOPI-bewijssleutelcontroles uit om een ​​mismatch te omzeilen. Houd certificaatverificatie ingeschakeld voor vertrouwde openbare certificaten; COLLABORATION_APP_INSECUREis alleen gedocumenteerd als een optie voor een zelfondertekend WOPI-appcertificaat, niet als een algemene oplossing voor productieomgevingen.

Het app-register bepaalt welke Office-app wordt weergegeven voor elk MIME-type en welke app standaard wordt geopend. Als Collabora actief is, maar documenten geen 'openen met'-optie tonen, controleer dan de MIME-typeconfiguratie in het register en de bijbehorende default_appwaarde. De naam die daar wordt gebruikt, moet overeenkomen met de geconfigureerde Office-appnaam. ownCloud documenteert dit als YAML-configuratie; omgevingsvariabelen vervangen de MIME-typetoewijzing niet.

4. Start, test en diagnosticeer de integratie

Valideer met behulp van het officiële Compose-voorbeeld de gegenereerde configuratie en start vervolgens de stack vanuit de implementatiemap:

docker compose config
docker compose up -d

Als u het Compose-voorbeeld niet gebruikt, start dan eerst de gateway, de App Provider en de Collabora-services. In de beheerde modus documenteert ownCloud het expliciet starten van Collaboration met ocis collaboration server; het start niet automatisch. Zorg ervoor dat de vereiste omgevingsvariabelen zijn ingevuld in het Collaboration-serviceproces voordat u het start.

1. Openen https://office.example.com/hosting/discoveryin een browser. Een bereikbaar eindpunt zou de ontdekkings-XML van Collabora moeten retourneren in plaats van een DNS-, TLS- of proxyfout.
2. Meld u aan bij Infinite Scale, open een ondersteund document en kies Collabora als de gebruikersinterface meerdere Office-apps biedt. Test zowel een bestaand bestand als, indien ingeschakeld in het app-register, het maken van een nieuw document.
3. Voer een kleine wijziging door, wacht tot de opslagindicator stabiel is, sluit de editor en open het bestand opnieuw om te controleren of de wijziging is opgeslagen.
4. Als de editor niet opent, controleer dan de logboeken van Infinite Scale Collaboration en App Provider, de Collabora-logboeken en de reverse-proxy-logboeken op hetzelfde tijdstempel. "Unauthorized WOPI host" wijst op de WOPI-vertrouwensconfiguratie van Collabora; een mislukte callback of TLS-fout wijst op de bereikbaarheid van de URL of het vertrouwen in het certificaat; een ontbrekende app-optie wijst op problemen met het app-register.

Succesvolle integratie betekent dat de browser de editor laadt, de WOPI-verbinding Infinite Scale bereikt en dat wijzigingen behouden blijven na het opnieuw openen van de editor. De exacte containernamen, URL-configuratie en locaties van configuratiebestanden zijn afhankelijk van de Infinite Scale-release en de implementatiemethode. Raadpleeg de bijbehorende ownCloud-documentatie voor deze details, met name bij de migratie vanaf de oude externe WOPI-server.

Referenties: configuratie van de ownCloud Collaboration-service , configuratie van de ownCloud App Registry en release-opmerkingen en migratie-opmerkingen van Infinite Scale .