Installieren von ONLYOFFICE Docs Community Edition auf CentOS oder RHEL für die 64-Bit-ARM-Architektur

Einleitung

Diese Anleitung zeigt Ihnen, wie Sie ONLYOFFICE Docs Community Edition ab Version 7.1 auf CentOS Stream 9 und 10 sowie RHEL 8, 9 und 10 für arm64 installieren. Eine vollständige Liste der verfügbaren Funktionen finden Sie in der Übersicht der ONLYOFFICE Docs-Editionen. Wenn Sie ONLYOFFICE Workspace verwenden, können Sie nach der Installation von Docs außerdem Dateien freigeben, Zugriffsrechte verwalten, Dokumente einbetten und Dateien aus verbundenen Cloud-Speichern bearbeiten.

Systemanforderungen
  • CPU: 64-Bit-ARM-Prozessoren
  • 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 oder 10, RHEL 8, RHEL 9 oder RHEL 10 für arm64
  • 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
module_hotfixes=true

Installieren Sie NGINX:

sudo yum install nginx

Entfernen Sie die folgende Datei:

sudo rm /etc/nginx/conf.d/default.conf

Offizielle Anleitung

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 (8 für Version 8.x, 9 für Version 9.x usw.).

ONLYOFFICE Docs installieren

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
Befehle zur Installation von ONLYOFFICE Docs

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.

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.

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
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.

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.

Artikel zum Thema:
Alle Schlagwörter