Schriftarten zum ONLYOFFICE Document Server hinzufügen: Docker vs. Linux

Um benutzerdefinierte Schriftarten zum ONLYOFFICE Document Server hinzuzufügen, legen Sie die lizenzierten Schriftartdateien in einem für den Server zugänglichen Verzeichnis ab und führen Sie den Befehl aus /usr/bin/documentserver-generate-allfonts.sh. Bei Docker-Bereitstellungen ist ein per Bind-Mount eingebundenes Schriftartverzeichnis in der Regel dem Kopieren von Dateien in einen laufenden Container vorzuziehen, da es auch nach einem Neustart des Containers erhalten bleibt.

Die richtige Installationsmethode hängt davon ab, wo ONLYOFFICE Docs ausgeführt wird, wie oft Sie es neu erstellen und ob Sie eine kurze Serviceunterbrechung in Kauf nehmen können, während der Schriftartenkatalog aktualisiert wird.

Wählen Sie eine Schriftartinstallationsmethode.

Die offizielle Docker-Schriftartenanleitung beschreibt das Kopieren von Dateien und das Neuerstellen der Schriftartenliste. Die Docker- Referenz zur Bind-Mount-Einbindung erklärt, warum das Einbinden eines dedizierten Host-Ordners die Verfügbarkeit von Dateien auch nach einem Containerwechsel gewährleistet. Es handelt sich hierbei um unterschiedliche Bereitstellungsoptionen, nicht um unterschiedliche Schriftartformate.

Bereiten Sie die Schriftdateien vor und bestätigen Sie den Zielserver.

1. Identifizieren Sie die aktive ONLYOFFICE-Bereitstellung

Führen Sie docker psden Editor auf dem Docker-Host aus, wenn er in Containern läuft. Suchen Sie den Namen des Dokumentenserver-Containers in der NAMESSpalte; in den folgenden Beispielen wird „document server container“ verwendet onlyoffice-documentserver. Ersetzen Sie diesen Wert, falls Ihrer abweicht. Eine Nextcloud- oder ownCloud-Integration ändert normalerweise nichts daran, dass die Schriftarten auf dem ONLYOFFICE Docs-Server installiert sein müssen, nicht nur auf dem Speicherserver oder dem Computer, auf dem das Dokument angezeigt wird.

docker ps

2. Lizenzierte Schriftdateien sammeln

Wählen Sie vollständige, ordnungsgemäß lizenzierte Schriftfamilien inklusive der in Ihren Dokumenten verwendeten Schriftschnitte und -stile. ONLYOFFICE listet in seiner Linux-Schriftdokumentation.ttf TrueType- und OpenType-Formate wie z. B. TTF und OTF .otfsowie weitere unterstützte Schrifterweiterungen auf . Für eine zuverlässige Erstinstallation verwenden Sie am besten herkömmliche TTF- oder OTF-Dateien und prüfen Sie die in der Schriftlizenz festgelegten Nutzungsbedingungen für Server und Client.

Im Docker-Beispiel müssen die Dateien /srv/onlyoffice/custom-fontsauf dem Docker-Host bereitgestellt werden. Die Beispieldateinamen Inter-Regular.ttfdienen Inter-Bold.ttfnur der Veranschaulichung; verwenden Sie die Dateien, für deren Installation Sie die Berechtigung haben.

sudo mkdir -p /srv/onlyoffice/custom-fonts
sudo cp Inter-Regular.ttf Inter-Bold.ttf /srv/onlyoffice/custom-fonts/
sudo chmod 644 /srv/onlyoffice/custom-fonts/*.ttf

Führen Sie diese Befehle im Verzeichnis mit den Schriftartdateien aus. Überprüfen Sie den Ordnerinhalt, bevor Sie fortfahren. Passen Sie auf einem verwalteten System die Besitzverhältnisse und Berechtigungen an Ihre Sicherheitsrichtlinie an, anstatt den Ordner für alle Benutzer beschreibbar zu machen.

Für Docker empfohlen: Das Schriftartenverzeichnis dauerhaft einbinden.

3. Fügen Sie dem bestehenden Compose-Dienst eine Bind-Mount-Verbindung hinzu.

Suchen Sie in der aktuellen Compose-Datei den Dienst, der das Image des ONLYOFFICE Document Servers ausführt. Fügen Sie unter der bestehenden volumesListe den folgenden Eintrag hinzu; behalten Sie die anderen bereits konfigurierten Volumes, Ports, Anmeldeinformationen und Umgebungsvariablen bei:

services:
  onlyoffice-documentserver:
    volumes:
      - /srv/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom:ro

Der Quellpfad befindet sich auf dem Docker-Host, das Zielverzeichnis im Container. Das :roSuffix beschränkt Schreibzugriffe des Containers auf das Schriftartenverzeichnis. Binden Sie das dedizierte customVerzeichnis ein, anstatt den gesamten /usr/share/fontsVerzeichnisbaum zu ersetzen, da dies die vom Image bereitgestellten Schriftarten verdecken könnte. Das offizielle ONLYOFFICE-Dockerfile deklariert das benutzerdefinierte TrueType-Schriftartenverzeichnis in den Image-Stufen „Community“ und „Enterprise“ als Volume.

Überprüfen Sie die überarbeitete Compose-Konfiguration und wenden Sie sie anschließend docker compose up -daus dem Projektverzeichnis an. Dadurch wird der Dienst möglicherweise neu erstellt: Planen Sie die Änderung so, dass Bearbeiter Dokumente sicher schließen können. Wenn Sie eine einfache Bereitstellung verwenden , fügen Sie beim Neuerstellen des Containers docker rundas entsprechende Argument für schreibgeschütztes Lesen hinzu .--mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonly

4. Überprüfen Sie, ob der Container die Schriftdateien erkennen kann.

Nachdem der Dienst gestartet wurde, überprüfen Sie das eingebundene Verzeichnis und, falls vorhanden, die Fontconfig-Liste. Der von Fontconfig gemeldete Familienname kann vom Dateinamen abweichen.

docker exec onlyoffice-documentserver ls -l /usr/share/fonts/truetype/custom
docker exec onlyoffice-documentserver fc-list | grep -i 'Inter'

Bei den Beispiel-Inter-Schriftarten sollte der zweite Befehl eine passende Schriftfamilie auflisten, sofern fontconfig diese erkennt. Falls die Dateien vorhanden sind, die Schriftfamilie aber nicht angezeigt wird, überprüfen Sie die Berechtigungen und führen Sie den Befehl erneut docker exec onlyoffice-documentserver fc-cache -faus fc-list. Die Erkennung durch fontconfig allein füllt das Menü des ONLYOFFICE-Editors nicht automatisch.

5. Generieren Sie den ONLYOFFICE-Schriftartenkatalog neu.

Führen Sie, nachdem die Dateien im Container vorhanden sind, das Schriftartgenerierungsskript des Dokumentenservers aus:

docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

ONLYOFFICE nutzt diesen Schritt, um die Schriftauswahldaten und -ressourcen zu aktualisieren. Dies kann laufende Editordienste beeinträchtigen. Führen Sie den Vorgang daher während eines geeigneten Wartungszeitraums aus. Die dokumentierte Docker-Umgebungsvariable GENERATE_FONTSist standardmäßig auf `true` gesetzt true, wodurch die Schriftdaten beim Containerstart neu generiert werden. Dies ist nach einem Neustart hilfreich, ersetzt aber nicht die Installation der Dateien an einem permanenten Speicherort.

Ändern Sie die Einstellungen nicht GENERATE_FONTSund erzwingen Sie keinen Neustart, nur um ein fehlendes Volume zu kaschieren. Überprüfen Sie zuerst, ob die erwarteten Dateien tatsächlich eingebunden sind.

Alternativen: temporäre Docker-Kopie oder natives Linux

6. Verwenden Sie eine direkte Containerkopie für einen kurzlebigen Test.

Falls Sie Compose nicht sofort ändern können, kopieren Sie eine Datei in den aktuellen Container und erstellen Sie den Katalog neu. Dies entspricht dem dokumentierten Docker-Ansatz von ONLYOFFICE und vermeidet die Neuerstellung des Containers für einen schnellen Test.

docker cp ./Inter-Regular.ttf onlyoffice-documentserver:/usr/share/fonts/truetype/custom/
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

Dies ist zwar praktisch für die Fehlersuche, aber als Bereitstellungsplan weniger zuverlässig. Ein Image-Update oder ein neuer Container kann die kopierte Datei löschen; ein Neustart desselben Containers ist nicht dasselbe wie eine Neuerstellung . Wenn die Schriftart für die laufende Arbeit benötigt wird, sollte ein erfolgreicher Test in eine Bind-Mount-Umgebung oder ein separat verwaltetes benutzerdefiniertes Image umgewandelt werden.

7. Installation direkt auf einem nicht containerisierten Linux-Dokumentenserver

Für eine native Linux-Paketinstallation legen Sie die Dateien in das System-Schriftartenverzeichnis des Servers und führen Sie dasselbe Regenerierungsskript auf diesem Host aus. Dieser Befehl sollte nicht auf dem Desktop eines normalen Benutzers ausgeführt werden.

sudo install -d -m 755 /usr/share/fonts/truetype/custom
sudo install -m 644 Inter-Regular.ttf /usr/share/fonts/truetype/custom/
sudo /usr/bin/documentserver-generate-allfonts.sh

Bei diesem Ansatz verbleiben die Schriftdateien in der Linux-Installation anstatt in einem Docker-Volume. Administratoren müssen diese jedoch beim Neuaufbau des Hosts in der Konfigurationsverwaltung oder in Backups sichern. Beachten Sie die offizielle ONLYOFFICE-Anleitung für Linux-Systeme mit installiertem Paket. Wenn mehrere Document-Server-Knoten Ihre Redakteure bedienen, stellen Sie auf jedem Knoten dieselbe Schriftfamilie und dieselben Varianten bereit.

8. Überprüfen Sie die Schriftart in einem Originaldokument.

Öffnen Sie eine neue Bearbeitungssitzung in der mit dem Dokumentenserver verbundenen Anwendung. Wählen Sie in einer Test-DOCX-Datei die installierte Schriftfamilie aus dem Dropdown-Menü aus, geben Sie eine Zeile normalen Textes, fettgedruckten Text und repräsentative nicht-englische Zeichen ein, falls die Schrift für die mehrsprachige Verwendung vorgesehen ist. Speichern Sie die Datei, schließen Sie sie, öffnen Sie sie erneut und exportieren Sie sie als PDF. Vergleichen Sie Textbreite, Zeilenumbrüche, Glyphenabdeckung und die Varianten für Fettdruck/Kursivschrift mit einem bekannten Referenzdokument.

Wenn eine Schriftart in der Auswahlliste fehlt, überprüfen Sie nacheinander den Serverpfad, die Ausgabe von `<font-family>` fc-listund den Befehl zur Katalogerstellung. Wird die Schriftfamilie zwar angezeigt, das Layout jedoch verschoben, stellen Sie sicher, dass das Dokument die exakte Schriftfamilie anfordert und die erforderlichen Schriftschnitte vorhanden sind; andernfalls kann der Editor eine andere Schriftart verwenden. Die Installation einer Schriftart auf dem Desktop eines Benutzers allein fügt sie nicht automatisch dem Server hinzu.

Es gibt eine browserspezifische Besonderheit: Laut den Anweisungen von ONLYOFFICE für Schriftarten muss bei Version 8.1.3 oder älter der Browser-Cache geleert und der Editor neu gestartet werden . Bei neueren Versionen ist dieser zusätzliche Schritt nicht erforderlich. Falls Sie eine ältere Installation verwenden, führen Sie diesen dokumentierten Cache-Schritt durch, bevor Sie komplexere Ursachen untersuchen.

Die Fehlerbehebung ist abgeschlossen, wenn die benutzerdefinierte Schriftfamilie nach dem erneuten Öffnen des Editors weiterhin auswählbar bleibt, das gespeicherte Dokument korrekt gerendert wird und – im Fall von Docker – die Schriftarten nach dem Neuerstellen des Dienstes mit derselben Konfiguration weiterhin vorhanden sind. Sollte eine dieser Prüfungen fehlschlagen, untersuchen Sie die entsprechende Ebene, anstatt Schriftarten wiederholt in den Container zu kopieren.