ownCloud mit Let's Encrypt und Nginx über HTTPS schützen

Beenden Sie die TLS-Verschlüsselung an einem Reverse-Proxy vor dem ownCloud-Server und verwenden Sie anschließend Certbot, um ein Let's Encrypt-Zertifikat zu erhalten und zu erneuern. Für einen öffentlichen Hostnamen ist Nginx mit der HTTP-01-Challenge in der Regel die einfachste Lösung, sofern der Proxy eingehende Verbindungen auf Port 80 akzeptieren kann. Falls Port 80 nicht freigegeben werden kann oder ein Wildcard-Zertifikat benötigt wird, verwenden Sie stattdessen DNS-01 mit einer automatisierten DNS-Integration.

Dieser Artikel beschreibt die Verwendung von ownCloud Classic Server 11 in Docker mit Nginx auf demselben Linux-Host. Die aktuelle ownCloud-Dokumentation leitet TLS über einen Proxy um. In den Beispielen wird ein Platzhalter-Hostname verwendet; ersetzen Sie diesen durch Ihren eigenen.

Wählen Sie die Zertifizierungsmethode, die zu Ihrem Netzwerk passt.

Wenn Sie bereits einen TLS-terminierenden Proxy betreiben, behalten Sie die Zertifikatsverwaltung dort bei, anstatt einen weiteren Proxy hinzuzufügen. Das Nginx-Plugin von Certbot bezieht das Zertifikat und bearbeitet den virtuellen Host, ändert aber Ihre Nginx-Konfiguration. Wenn Sie diese Konfiguration lieber selbst verwalten möchten, verwenden Sie den Zertifikatsmodus von Certbot und fügen Sie die Zertifikatspfade manuell in Ihren Proxy ein.

AuswahlAm besten geeignetHauptkompromisse
HTTP-01 mit Nginx und CertbotEin öffentlicher einzelner Hostname mit verfügbarem eingehendem TCP-Port 80Einfach, benötigt kein DNS-API-Geheimnis; setzt korrekte öffentliche DNS-Einstellungen und die Erreichbarkeit von Port 80 voraus. Es können keine Wildcard-Zertifikate ausgestellt werden.
DNS-01 mit einem DNS-Provider-PluginPort 80 ist geschlossen, der Dienst ist privat oder Sie benötigen eine Wildcard.Funktioniert ohne öffentliche Web-Authentifizierung, die automatische Verlängerung erfordert jedoch Zugriff auf die DNS-API. Verwenden Sie eingeschränkt gültige Anmeldeinformationen und schützen Sie diese.
ACME-Integration des bestehenden ProxysEin Proxy verwaltet bereits Zertifikate für andere Websites.Weniger bewegliche Teile; Erneuerungsverhalten und Konfiguration sind spezifisch für diesen Proxy.

Das optionale tlsserver-Profil von Let's Encrypt stellt seit dem 13. Mai 2026 45-Tage-Zertifikate aus; die standardmäßigen klassischen Zertifikate behalten ihre Gültigkeit von 90 Tagen bis zum 10. Februar 2027, bevor sie auf 64 Tage umgestellt werden. Certbot plant regelmäßig die Erneuerung; überprüfen Sie Ihre.

Ein DNS-Verwaltungsfenster listet cloud.example.com mit einer Beispiel-A-Record-Adresse auf und zeigt an, dass die eingehenden TCP-Ports 80 und 443 zulässig sind.
Beispielhafte DNS- und Firewall-Einstellungen für cloud.example.com. Ersetzen Sie die Beispieladresse durch die öffentliche IP-Adresse des Servers und erlauben Sie eingehenden TCP-Verkehr über die Ports 80 und 443.

ownCloud und Nginx für einen öffentlichen Hostnamen konfigurieren

  1. Richten Sie die DNS-Einstellungen auf den Proxy ein und öffnen Sie die erforderlichen Ports. Erstellen Sie einen A-Record, cloud.example.comder auf die öffentliche IPv4-Adresse des Servers verweist. Fügen Sie einen AAAA-Record nur dann hinzu, wenn IPv6 den gleichen Proxy korrekt erreicht. Erlauben Sie eingehende Verbindungen über TCP 80 für die HTTP-01-Validierung und TCP 443 für HTTPS-Verbindungen der Benutzer sowohl in der Host-Firewall als auch in allen Cloud-Firewalls oder Routern. Überprüfen Sie die DNS-Einstellungen von außerhalb Ihres Netzwerks.
  2. Legen Sie die externe URL von ownCloud fest und beschränken Sie den App-Port. Ersetzen Sie in der vorhandenen Compose- .envDatei den Beispiel-Hostnamen und legen Sie die entsprechenden Werte fest:
OWNCLOUD_DOMAIN=cloud.example.com
OWNCLOUD_TRUSTED_DOMAINS=cloud.example.com
OWNCLOUD_OVERWRITE_CLI_URL=https://cloud.example.com
OWNCLOUD_OVERWRITE_HOST=cloud.example.com
OWNCLOUD_OVERWRITE_PROTOCOL=https
OWNCLOUD_TRUSTED_PROXIES=PROXY_SOURCE_IP
HTTP_PORT=127.0.0.1:8080

PROXY_SOURCE_IPist ein Platzhalter: Verwenden Sie die Adresse, die ownCloud tatsächlich für den Proxy sieht, nicht eine angenommene Loopback-Adresse. Docker-Netzwerke ändern die Quelladresse, die ownCloud sieht. Vertrauen Sie nur der Proxy-Adresse oder dem kleinsten erforderlichen Satz; ein umfassendes Vertrauen ermöglicht es Clients, weitergeleitete Informationen zu fälschen. Das offizielle Compose-Beispiel veröffentlicht ownCloud auf Port 8080; die Bindung der Hostseite an Loopback verhindert, dass der HTTP-Listener der Anwendung die öffentliche Schnittstelle verwendet, wenn die bereitgestellte Portzuordnung verwendet wird ${HTTP_PORT}:8080. Wenn sich Ihr Nginx in einem Container befindet, verwenden Sie ein privates, gemeinsam genutztes Docker-Netzwerk und dessen Dienstadresse anstelle dieses Host-Loopback-Beispiels.

Behalten Sie Ihre bestehenden Datenbank-, Redis- und Volume-Einstellungen bei. Nach der Bearbeitung der Datei müssen Sie den ownCloud-Dienst neu erstellen, damit er die aktualisierte Umgebung einliest: docker compose up -d owncloud.

Ein Terminalfenster zeigt den Certbot Nginx-Befehl für cloud.example.com und die resultierenden Pfade fullchain.pem und privkey.pem an.
Beispielausgabe von Certbot, die eine Zertifikatsanforderung für cloud.example.com sowie die Dateipfade für das Zertifikat und den privaten Schlüssel anzeigt.
  1. Fügen Sie einen virtuellen HTTP-Host hinzu, der als Proxy für ownCloud fungiert. Erstellen oder aktualisieren Sie die Nginx-Site für den Hostnamen. Dieser Starterblock ermöglicht es Nginx, die Anwendung über HTTP bereitzustellen, während Certbot die Domain validiert.
server {
    listen 80;
    server_name cloud.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Aktivieren Sie die Website mithilfe des Nginx-Layouts Ihrer Distribution und überprüfen und laden Sie Nginx anschließend neu sudo nginx -t. sudo systemctl reload nginxDie Pfade zur Website-Aktivierung variieren je nach Distribution. Stellen Sie sicher, dass die ACME-HTTP-Challenge erreichbar ist; fügen Sie beim Ausstellen des Zertifikats keine Authentifizierungsbarriere oder allgemeine Umleitungsregel vor dem Challenge-Pfad ein.

Ein Nginx-Konfigurationsfenster zeigt die TLS-Zertifikatspfade und proxy_pass auf 127.0.0.1:8080 an, wobei X-Forwarded-Proto auf https gesetzt ist.
Der HTTPS-Virtual-Host sendet Anfragen von Nginx an den ownCloud-Dienst über die Loopback-Adresse des Hosts.
  1. Stellen Sie das Zertifikat aus und aktivieren Sie die Weiterleitung. Installieren Sie Certbot gemäß den Anweisungen für Ihre Linux-Distribution und das Nginx-Plugin und führen Sie anschließend Folgendes aus:
sudo certbot --nginx -d cloud.example.com --redirect

Der Nginx-Installer von Certbot ruft das Zertifikat ab und konfiguriert HTTPS sowie eine HTTP-zu-HTTPS-Weiterleitung. Überprüfen Sie die Nginx-Änderungen, bevor Sie sie übernehmen. Soll Certbot das Zertifikat ausstellen, ohne Nginx zu bearbeiten, verwenden Sie die entsprechende Option und sudo certbot certonly --nginx -d cloud.example.comkonfigurieren Sie anschließend den virtuellen TLS-Host manuell mit den resultierenden fullchain.pemPfaden privkey.pemund laden Sie Nginx neu. Veröffentlichen oder teilen Sie die Datei mit dem privaten Schlüssel niemals.

Prüfen Sie HTTPS und die automatische Vertragserneuerung.

Öffnen Sie die Seite von einem externen Netzwerk aus. Prüfen Sie, ob https://cloud.example.comder Browser ein gültiges Zertifikat meldet, ownCloud ohne Weiterleitungsschleife lädt und die generierten Links HTTPS verwenden. Falls ownCloud eine nicht vertrauenswürdige Domain meldet oder HTTP-Links erstellt, überprüfen Sie OWNCLOUD_TRUSTED_DOMAINSdie vertrauenswürdige Proxy-Adresse.OWNCLOUD_OVERWRITE_HOSTOWNCLOUD_OVERWRITE_PROTOCOL

  1. Testen Sie die Verlängerung und bestätigen Sie den Zeitplan. Führen Sie den Nicht-Produktions-Verlängerungstest von Certbot durch:
sudo certbot renew --dry-run
sudo systemctl list-timers --all | grep -i certbot

Ein erfolgreicher Testlauf prüft den Erneuerungspfad, ohne das aktive Zertifikat zu ersetzen. Der Nginx-Installer sollte erneuerte Zertifikate über seine Erneuerungsintegration bereitstellen. Wenn Sie stattdessen den Zertifikat-Only- oder Webroot-Modus verwenden, stellen Sie sicher, dass Ihre Erneuerungskonfiguration Nginx nach einer erfolgreichen Erneuerung neu lädt. Certbot dokumentiert die Bereitstellungs-Hooks für die Erneuerung zu diesem Zweck. Überprüfen Sie den Scheduler nach der Installation oder Migration erneut und lassen Sie sich bei Erneuerungsfehlern benachrichtigen, anstatt sich auf eine manuelle Erneuerung zu verlassen.

Verwenden Sie für DNS-01 das für Ihren DNS-Anbieter dokumentierte Plugin, erstellen Sie ein API-Token, das auf die zu ändernden Einträge beschränkt ist, und testen Sie die automatische Erneuerung mit demselben Certbot-Testlauf. Let's Encrypt weist darauf hin, dass DNS-01 Wildcard-Namen und nicht-öffentliche Dienste unterstützt, warnt jedoch davor, dass weit gefasste DNS-Zugangsdaten auf dem Webserver die Auswirkungen einer Kompromittierung erhöhen.

Versionsspezifische Details finden Sie im Installationsleitfaden für ownCloud Server 11 Docker , in der zugehörigen Reverse-Proxy-Konfiguration und in der Referenz der Umgebungsvariablen . Informationen zu Validierungs- und Erneuerungsoptionen finden Sie in der Dokumentation zu Let's Encrypt-Challenges , im Zertifikatsgültigkeitsplan und in den Certbot-Anweisungen für Ihr Betriebssystem .

Ein Browser zeigt https://cloud.example.com mit einem Schlosssymbol über einem ownCloud-Anmeldebildschirm, darunter befindet sich ein Testlauf zur Terminalerneuerung.
Beispielhafte Überprüfungsansicht: Der Browser verwendet HTTPS, und der Testlauf der Certbot-Erneuerung meldet Erfolg. Dies ist ein beispielhaftes, erwartetes Ergebnis und kein Test Ihres Servers.

Einen Kommentar hinterlassen

ownCloud mit Let's Encrypt und Nginx über HTTPS schützen

ownCloud mit Let's Encrypt und Nginx über HTTPS schützen

Wählen Sie HTTP-01 oder DNS-01, konfigurieren Sie einen ownCloud Reverse-Proxy und vergewissern Sie sich, dass Certbot HTTPS-Zertifikate automatisch erneuert.

Verbinden Sie ownCloud Infinite Scale mit LDAP für die Benutzeranmeldung.

Konfigurieren Sie die oCIS LDAP-Anmeldung, gleichen Sie Benutzer- und Gruppenabfragen ab und überprüfen Sie die TLS- und Schemaeinstellungen vor der Einführung.

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Fügen Sie ownCloud 10 einen Amazon S3-Bucket hinzu, bereiten Sie kompatible Anmeldeinformationen und Endpunkte vor und prüfen Sie den Zugriff, ohne eine Einbindung mit dem primären Speicher zu verwechseln.

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.