Zum Hauptinhalt springen

Installation von ONLYOFFICE Docs Community Edition für CentOS und Derivativen

Einleitung​

Mit der Community Edition können Sie ONLYOFFICE Docs auf Ihrem lokalen Server installieren und die Online-Editoren in die ONLYOFFICE-Kollaborationsplattform oder andere beliebte Systeme integrieren. So können Sie Dateien freigeben, Zugriffsrechte verwalten, Dokumente auf einer Website einbetten und Dateien bearbeiten, die auf Drive, Box, Dropbox, OneDrive oder ownCloud gespeichert und mit ONLYOFFICE verbunden sind (siehe die detaillierte Liste der Funktionen). Diese Anleitung zeigt Ihnen, wie Sie die Linux-Version von ONLYOFFICE Docs Community Edition auf Ihrem Computer installieren.

Systemanforderungen​

  • CPU: Dual-Core 2 GHz oder besser
  • RAM: mindestens 2 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
  • HDD: mindestens 40 GB freier Speicherplatz
  • SWAP: mindestens 4 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
  • OS: CentOS Stream 9, RHEL 8 oder RHEL 9
  • Zusätzliche Anforderungen
    • NGINX: Version 1.30 oder höher

Installieren von Abhängigkeiten​

Installieren der aktuellen NGINX-Paketversion​

Um das yum-Repository für RHEL/CentOS einzurichten, erstellen Sie die Datei /etc/yum.repos.d/nginx.repo mit folgendem Inhalt:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Offizielle Anleitung

Installieren Sie NGINX:

sudo yum install nginx

Bearbeiten Sie anschließend die NGINX-Konfigurationsdatei /etc/nginx/nginx.conf, sodass sie folgendermaßen aussieht:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
Wichtig

Wenn Sie ONLYOFFICE Docs auf Port 80 ausführen möchten, deaktivieren Sie jetzt die Standard-Website von NGINX. Andernfalls funktioniert ONLYOFFICE Docs möglicherweise nicht richtig. Führen Sie dazu die folgenden Befehle aus:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Je nachdem, wie NGINX installiert wurde, meldet einer der ersten beiden Befehle möglicherweise, dass die Datei nicht existiert. Diese Meldung können Sie ignorieren.

EPEL-Repository installieren​

sudo yum install epel-release

Um EPEL auf CentOS 9 zu installieren, verwenden Sie die folgenden Befehle:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Um EPEL auf RHEL zu installieren, verwenden Sie die folgenden Befehle:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Ersetzen Sie $REV manuell durch die Version Ihres Betriebssystems (7 für Version 7.x, 8 für Version 8.x, 9 für Version 9.x usw.).

Hinzufügen des ONLYOFFICE Docs-Repositorys​

Fügen Sie das yum-Repository von ONLYOFFICE Docs mit dem folgenden Befehl hinzu:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

Installieren von mscorefonts​

Installieren Sie die Pakete cabextract und xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Für CentOS 7.8 (2003) ist zusätzlich fontconfig erforderlich:

sudo yum install fontconfig

Installieren Sie das msttcore-Schriftartenpaket:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

ONLYOFFICE Docs installieren​

Führen Sie den folgenden Befehl für die Community Edition aus:

sudo yum install onlyoffice-documentserver

Starten Sie den NGINX-Dienst und aktivieren Sie den automatischen Start beim Hochfahren:

sudo service nginx start
sudo systemctl enable nginx

Anschließend wird ONLYOFFICE Docs als Prozess ausgeführt. Das Paket wird wie jedes andere RPM-Paket aktualisiert.

ONLYOFFICE Docs aktualisieren​

Um ONLYOFFICE Docs zu aktualisieren, führen Sie den folgenden Befehl aus:

sudo yum update onlyoffice-documentserver
Wichtig

Auf RHEL 8 und davon abgeleiteten Distributionen kann yum update bei aktiviertem ONLYOFFICE-Repository mit einem Abhängigkeitsfehler fehlschlagen.

Um dies zu verhindern, schließen Sie diese Pakete aus dem ONLYOFFICE-Repository aus, sodass sie stattdessen aus dem AppStream-Repository des Systems bezogen werden:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Dieser Befehl muss nur einmal ausgeführt werden. Danach funktioniert yum update wie erwartet.

Wenn Sie ONLYOFFICE Docs über OneClick Install installiert haben, wird dieser Ausschluss bereits automatisch angewendet.

Ändern des Standardports von ONLYOFFICE Docs​

Standardmäßig nimmt ONLYOFFICE Docs eingehende Verbindungen über Port 8083 entgegen. Ab Version 4.3 können Sie einen anderen Port für ONLYOFFICE Docs festlegen, wenn Sie ihn anstelle des Standardports verwenden möchten.

hinweis

Wenn Sie den Standardport ändern, stellen Sie sicher, dass er für eingehende/ausgehende Verbindungen geöffnet ist. Sehen Sie sich die vollständige Liste der von ONLYOFFICE Docs verwendeten Ports an.

Dazu müssen Sie die Umgebungsvariable DS_PORT mit folgendem Befehl bearbeiten:

export DS_PORT=<PORT_NUMBER>

Ersetzen Sie im obigen Befehl <PORT_NUMBER> durch die gewünschte Portnummer.

hinweis

Wenn Sie den Port auf 80 setzen, stellen Sie sicher, dass Sie die Standard-Website von NGINX deaktiviert haben, wie im Abschnitt Installieren der aktuellen NGINX-Paketversion beschrieben.

Warnung

Wenn Sie das Protokoll von ONLYOFFICE Docs auf HTTPS umstellen möchten, ändern Sie den Port nicht auf 443, sondern verwenden Sie stattdessen diese Anleitung.

Danach können Sie mit der Konfiguration von ONLYOFFICE Docs fortfahren.

ONLYOFFICE Docs konfigurieren​

Ausführen eines Konfigurationsskripts​

Führen Sie das Skript documentserver-configure aus:

bash documentserver-configure

Hinzufügen einer Firewall-Ausnahme​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

SELinux deaktivieren​

hinweis

veraltet seit v.5.0

Öffnen Sie die Datei /etc/selinux/config mit einem beliebigen Texteditor, ersetzen Sie die Zeichenfolge SELINUX=enforcing oder SELINUX=permissive durch SELINUX=disabled und speichern Sie die Änderungen.

Starten Sie Ihren Server neu, damit die Änderungen wirksam werden.

Hinweis

Aus Sicherheitsgründen werden ab Version 8.1 beim Ausführen des Skripts documentserver-configure neue WOPI-Schlüssel in local.json generiert. Wenn Sie eine WOPI-Verbindung verwenden, müssen Sie das Skript nach der Aktualisierung von ONLYOFFICE Docs ausführen:

documentserver-configure --wopienabled true

ONLYOFFICE Docs in einem Browser starten​

Sobald die Konfiguration abgeschlossen ist, können Sie http://localhost:8083 in die Adressleiste Ihres Browsers eingeben, um die Willkommensseite von ONLYOFFICE Docs zu öffnen. Dort finden Sie weitere Anweisungen, wie Sie Dokumentbeispiele aktivieren oder die Online-Editoren mithilfe der bereitgestellten API in Ihre Webanwendung integrieren.

Wie Sie ONLYOFFICE Docs mit ONLYOFFICE Workspace verbinden, erfahren Sie in dieser Anleitung.