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.

ONLYOFFICE-Dokumenteditor mit einem Dropdown-Menü für Schriftarten, in dem die installierten Schriftarten und ein Beispieldokument angezeigt werden.
Im Dropdown-Menü des Editors werden die verfügbaren Schriftfamilien aufgelistet; fehlende Schriftarten können durch eine Ersatzschriftart ersetzt werden, bis der Schriftkatalog des Servers aktualisiert ist.

Wählen Sie eine Schriftartinstallationsmethode.

MethodeAm besten geeignetAbwägung
Docker-Bind-MountMit Docker Compose verwaltete ProduktionscontainerErfordert eine Bearbeitung der Containerkonfiguration und möglicherweise eine Neuerstellung.
docker cpin den laufenden ContainerSchnelltest oder vorübergehende ErgänzungDateien können verschwinden, wenn dieser Container ersetzt wird.
Installieren Sie Schriftarten auf dem Linux-Host, auf dem das native Document Server-Paket ausgeführt wird.DEB/RPM-Installation ohne DockerErfordert Administration auf Serverebene und bleibt an diesen Host gebunden.

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
Ubuntu-Terminal mit dem Befehl „docker ps“ und einem laufenden ONLYOFFICE Document Server-Container.
Suchen Sie den Document Server-Container in der Docker-Liste, bevor Sie Schriftarten kopieren oder den Katalog neu generieren.

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.

Linux-Dateimanager zeigt normale, fette und andere Schriftartdateien in einem benutzerdefinierten Schriftartenverzeichnis an.
Alle Schriftvarianten sollten in einem separaten Verzeichnis gespeichert werden, damit sie in den Document Server-Container eingebunden werden können.

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

Im Code-Editor wird ein Docker Compose-Volumes-Eintrag angezeigt, der den Ordner „customfonts“ des Hosts in ONLYOFFICE einordnet.
Ein dedizierter, schreibgeschützter Volume-Eintrag hält die benutzerdefinierten Schriftartdateien vom Container-Image getrennt.

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.

Terminalanzeige eines docker exec fc-list-Befehls, der nach der im Verzeichnis für benutzerdefinierte Schriftarten installierten Schriftart Inter sucht.
Die Überprüfung der Schriftartkonfiguration hilft dabei, eine unlesbare oder fehlende Schriftartdatei von einem veralteten ONLYOFFICE-Schriftartenkatalog zu unterscheiden.

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.

Terminalanzeige mit dem Befehl documentserver-generate-allfonts.sh und einer Meldung zur Generierung eines Schriftartenkatalogs.
Führen Sie das Skript zur Schriftgenerierung des Dokumentenservers aus, nachdem der Container Zugriff auf die neuen Schriftdateien hat.

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.

Linux-Terminal, das die in das Systemschriftartenverzeichnis kopierte Schriftart Inter und anschließend den Befehl ONLYOFFICE zur Schriftartenregeneration anzeigt.
Auf einem nativen Linux-Dokumentenserver installieren Sie die Schriftart auf diesem Server und generieren dessen Schriftartenkatalog ohne Docker-Befehle neu.

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.

ONLYOFFICE-Editor mit der Schriftart „Inter“ im Dropdown-Menü und einem Beispielabsatz in dieser Schriftart.
Prüfen Sie, ob die Schriftart im Menü angezeigt wird, öffnen Sie dann ein gespeichertes Dokument erneut und vergleichen Sie den Zeilenumbruch und die gerenderten Glyphen.

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.

Einen Kommentar hinterlassen

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Automatisieren Sie ownCloud-Datenbank-Dumps mit einem sicheren nächtlichen Cron-Job

Planen Sie geschützte MariaDB-Dumps für ownCloud Server, handhaben Sie den Wartungsmodus sicher und überprüfen Sie jedes Backup, bevor Sie sich darauf verlassen.

Wechseln Sie ownCloud Classic mit einer unterstützten Migration zu oCIS.

Planen Sie eine Migration von ownCloud 10 zu oCIS mit der unterstützten App, geordneten Befehlen, Identitätsprüfungen und einer klaren Liste der Daten, die eine separate Behandlung erfordern.

ownCloud Classic 10 mit Theme-App und CSS

Ersetzen Sie die ownCloud Classic 10-Logos und passen Sie die Farben der Web-Benutzeroberfläche mit einer Design-App an, ohne dabei Probleme bei Upgrades und Integritätsprüfungen zu riskieren.

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Festlegen von Standard-Speicherkontingenten nach Benutzerrolle in ownCloud oCIS

Weisen Sie neuen ownCloud Infinite Scale-Benutzern rollenbasierte Speicherlimits auf Byte-Basis zu, inklusive eines proxy.yaml-Beispiels und einer Checkliste zur sicheren Überprüfung.

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Behebung von ownCloud-Synchronisierungszertifikatfehlern an der TLS-Quelle

Stellen Sie die ownCloud-Desktop-Synchronisierung wieder her, indem Sie den Server-Hostnamen, die Zertifikatskette, die Vertrauensstellung der privaten Zertifizierungsstelle und Probleme mit dem Captive Portal überprüfen, ohne die TLS-Verifizierung zu deaktivieren.

ownCloud-Integritätswarnung nach einem Upgrade löschen

Verwenden Sie den Bericht über ungültige Dateien, um nicht übereinstimmende Kerndateien oder App-Signaturen zu identifizieren, die korrekten Release-Dateien wiederherzustellen und die Integritätsprüfung sicher durchzuführen.

ownCloud Infinite Scale mit Docker Compose installieren

Stellen Sie ownCloud Infinite Scale anhand des offiziellen Compose-Beispiels bereit, konfigurieren Sie Domänen und persistenten Speicher und überprüfen Sie anschließend TLS, Container und die erste Anmeldung.

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Konfigurieren Sie S3 Blob Storage für ownCloud Infinite Scale

Richten Sie den S3NG-Treiber, die Bucket-Berechtigungen, die persistente Metadatenspeicherung und die Upload-Größe so ein, dass ownCloud Infinite Scale Dateiinhalte zuverlässig speichern kann.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Wenn ownCloud-Uploads bei 99 % hängen bleiben, überprüfen Sie diese Grenzwerte.

Finden Sie heraus, warum ein Upload auf einem ownCloud-Server kurz vor Abschluss abbricht, indem Sie den Dateistatus, das Kontingent, den temporären Speicherplatz, die PHP-Limits und die Proxy-Timeouts überprüfen.

ownCloud Apache .htaccess-Warnung sicher löschen

ownCloud Apache .htaccess-Warnung sicher löschen

Setzen Sie AllowOverride All nur für das Web-Root-Verzeichnis von ownCloud, überprüfen Sie den aktiven Apache-Vhost und laden Sie die Seite sicher neu, um die .htaccess-Regeln wiederherzustellen.