Zum Hauptinhalt springen

Collabora Online

Bereitstellung und Konfiguration von Collabora Online als optionaler Docker-Compose-Dienst.

📋 Voraussetzungen​

⚠️ Um die Integration von Collabora Online zu aktivieren, stellen Sie sicher, dass zuerst die Reverse-Proxy-Konfiguration aktiviert ist.

⚡ Aktivierung​

Führen Sie die folgenden Schritte aus, um Collabora Online mit dem Nginx-Reverse-Proxy zu aktivieren.

Nginx-Konfiguration​

Entkommentieren Sie in ./config/nginx/nginx.conf das Collabora Online-Include am Ende der Datei:

include collabora.conf;

Stellen Sie in ./config/nginx/docker-compose.nginx.yaml sicher, dass die Collabora Online-Konfiguration im Nginx-Container bereitgestellt ist:

services:
  nginx:
    volumes:
      - ./collabora.conf:/etc/nginx/collabora.conf

Docker Compose-Konfiguration​

Entkommentieren Sie in docker-compose.yaml die erforderlichen Docker Compose-Dateien:

include:
  - ./config/nginx/docker-compose.nginx.yaml
  - ./config/collabora/docker-compose.collabora.yaml

Wenn Sie HTTPS über den Nginx-Reverse-Proxy verwenden, bearbeiten Sie die Datei ./config/collabora/docker-compose.collabora.yaml und setzen Sie die Option ssl.termination auf true:

services:
  collabora:
    environment:
      extra_params: >-
        --o:ssl.termination=true

Sync-in-Konfiguration​

Aktivieren Sie in environment.yaml die Collabora Online-Integration:

server:
  # Derzeit optional; in der nächsten Hauptversion erforderlich
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      collabora:
        # Integration aktivieren
        enabled: true
Info

Führen Sie docker compose up -d && docker compose restart nginx sync_in aus, um die Änderungen anzuwenden.

🌐 Zugriff​

Sync-in und Collabora Online laufen in Docker-Containern und kommunizieren über den Nginx-Reverse-Proxy.

Wenn Sie server.publicUrl konfigurieren, legen Sie die Option auf die genaue Adresse fest, die für den Zugriff auf Sync-in verwendet wird, einschließlich aller nicht standardmäßigen Ports. Verwenden Sie beispielsweise bei einer Nginx-Portzuordnung von 8060:80 http://your-server:8060. Diese URL muss vom Browser und vom Collabora Online-Container aus erreichbar sein. Wenn die Option weggelassen wird, verwendet Sync-in den von Nginx weitergeleiteten Anforderungsursprung als Kompatibilitäts-Fallback. Aus Sicherheitsgründen wird server.publicUrl in der nächsten Hauptversion erforderlich sein, sodass Editor-Endpunkte aus einem vertrauenswürdigen Ursprung erstellt werden, der vom Administrator kontrolliert wird, und nicht aus Anforderungsheadern.

Warnung

Beim Zugriff auf Sync-in über http://localhost oder http://127.0.0.1 funktioniert Collabora Online nicht ordnungsgemäß (Dokumente können weder angezeigt noch bearbeitet werden).