Zum Hauptinhalt springen

OnlyOffice

Bereitstellung und Konfiguration von OnlyOffice als optionaler Docker-Compose-Dienst.

📋 Voraussetzungen​

⚠️ Um die OnlyOffice-Integration zu aktivieren, stellen Sie zunächst sicher, dass die Reverse-Proxy-Konfiguration aktiviert ist.

⚡ Aktivierung​

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

Nginx-Konfiguration​

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

include onlyoffice.conf;

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

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

Docker Compose-Konfiguration​

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

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

Sync-in-Konfiguration​

Aktivieren Sie in environment.yaml die OnlyOffice-Integration:

server:
  # Derzeit optional; in der nächsten Hauptversion erforderlich
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      onlyoffice:
        # Integration aktivieren
        enabled: true
        # Dasselbe Geheimnis wie in docker-compose.yaml verwenden
        secret: 'REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'

Generieren Sie einen sicheren Wert und stellen Sie sicher, dass er mit dem in ./config/onlyoffice/docker-compose.onlyoffice.yaml definierten Wert übereinstimmt:

services:
  onlyoffice:
    environment:
      - 'JWT_SECRET=REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'
Info

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

🌐 Zugriff​

Sync-in und OnlyOffice 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 OnlyOffice-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

Wenn Sie über http://localhost oder http://127.0.0.1 auf Sync-in zugreifen, funktioniert OnlyOffice nicht ordnungsgemäß (Dokumente werden weder angezeigt noch bearbeitet).