Erste Fassung

Author: Peter Siering

README.MD

@@ -0,0 +1,35 @@
+
+Dieses Projektchen ergänzt einen [Artikel zu Nextcloud aus c’t 11/2020](https://www.heise.de/select/ct/2020/11). Für die Inbetriebnahme der Nextcloud-Umgebung 
+benötigen Sie:
+
+* ein System mit Docker und docker-compose
+
+* eine Domain nebst Host wie nextcloud.example.com
+
+* eine E-Mail-Adresse ich@example.com
+
+* nextcloud.example.com muss auf die IP-Adresse des Systems zeigen
+
+Um diesen Ausgangszustand herzustellen, ersetzen Sie in der Datei nextcloud.yml und static.yml jeweils nextcloud.example.com (kommt mehrfach vor) durch Ihren 
+Host(-namen) und die E-Mail-Adresse ich@example.com in static.yml durch Ihre Adresse.
+
+Ändern Sie unbedingt auch das Passwort für den Nextcloud-Admin-Benutzer (ncadmin). Es ist vorbelegt als "12345678x!". Ändern Sie besser auch gleich noch den 
+Namen dieses Benutzers auf einen für Sie passenden.
+
+Die Datei acme.json braucht exakt die im tar.gz-Archiv enthaltenen Zugriffsrechte (chmod 600), sonst verarbeitet Traffic sie nicht. Hierin laden schließlich die 
+Zertifikatsinformationen.
+
+Starten Sie anschließend mit `docker-compose -f ./ctnextcloud.yml up -d ` Traefik, Nextcloud und die zugehörige Datenbank.
+
+Wenn Docker alle Images heruntergeladen und gestartet hat, sollten Sie nach einiger Zeit in eine Web-Browser unter Ihrem Host- und Domain-Namen die frische 
+Nextcloud-Installation erreichen können.
+
+Die Besonderheiten für die Nextcloud-Einrichtung:
+
+Nextcloud wird gezwungen, alle Zugriffe auf das https-Protokoll umzuleiten; das geschieht über Nextcloud-eigene Mechanismen (das für das Apache-Image 
+implementierte OVERWRITEPROTOCOL) und über ein Redirect im vorgespannten Traefik, das als Proxy Anfragen an den Docker-Host für den virtuellen Host 
+nextcloud.example.com an den Nextcloud-Container weiterzuleiten.
+
+Traefik beschafft automatisch passende Zertifikate bei Let’s Encrypt. Einige weitere Anweisungen (unter labels: für den Nextcloud-Container) sorgen dafür, dass 
+Nextcloud erfährt, dass es hinter einem Proxy arbeitet. Die Variable TRUSTED_DOMAINS hilft ebenfalls dabei. Weitere Labels formen die URLs für die DAV-Protokolle 
+so um, dass diese auch über Kurz-URLs erreichbar sind.

acme.json

@@ -0,0 +1,66 @@
+version: "3.7"
+
+volumes:
+  nextcloud_root:
+  nextcloud_data:
+  nextcloud_config:
+  nextcloud_apps:
+  db_nextcloud:
+
+services:
+  traefik:
+    image: traefik:v2.1.7
+    restart: always
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:rw
+      - ./static.yml:/etc/traefik/traefik.yml
+      - ./acme.json:/etc/traefik/acme/acme.json
+  db_nextcloud:
+    image: mysql:5
+    restart: always
+    volumes:
+      - db_nextcloud:/var/lib/mysql
+    environment:
+      - MYSQL_DATABASE=nextcloud
+      - MYSQL_USER=nextcloud
+      - MYSQL_PASSWORD=geheim45
+      - MYSQL_ROOT_PASSWORD=geheim45geheim
+  nextcloud:
+    image: nextcloud:apache
+    restart: always
+    depends_on:
+      - db_nextcloud
+    volumes:
+      - nextcloud_root:/var/www/html
+      - nextcloud_data:/var/www/html/data
+      - nextcloud_config:/var/www/html/config
+      - nextcloud_apps:/var/www/html/apps
+      - /etc/localtime:/etc/localtime:ro
+      - /etc/timezone:/etc/timezone:ro
+    environment:
+      - MYSQL_DATABASE=nextcloud
+      - MYSQL_USER=nextcloud
+      - MYSQL_PASSWORD=geheim45
+      - MYSQL_HOST=db_nextcloud
+      - NEXTCLOUD_ADMIN_USER=ncadmin
+      - NEXTCLOUD_ADMIN_PASSWORD=12345678x!
+      - NEXTCLOUD_TRUSTED_DOMAINS="nextcloud.example.com"
+      - OVERWRITEPROTOCOL=https
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.nextcloud.rule=Host(`nextcloud.example.com`)"
+      - "traefik.http.routers.nextcloud.entrypoints=web"
+      - "traefik.http.routers.nextcloud.middlewares=redirect-to-https@docker"
+      - "traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https"
+      - "traefik.http.routers.nextcloud-secure.rule=Host(`nextcloud.example.com`)"
+      - "traefik.http.routers.nextcloud-secure.entrypoints=web-secure"
+      - "traefik.http.routers.nextcloud-secure.tls.certResolver=default"
+      - "traefik.http.routers.nextcloud-secure.tls=true"
+      - "traefik.http.routers.nextcloud-secure.middlewares=nextcloudheaders@docker,nextcloud-dav@docker"
+      - "traefik.http.middlewares.nextcloudheaders.headers.customRequestHeaders.X-Forwarded-Proto=https"
+      - "traefik.http.middlewares.nextcloudheaders.headers.accessControlAllowOrigin=*"
+      - "traefik.http.middlewares.nextcloud-dav.replacepathregex.regex=^/.well-known/ca(l|rd)dav"
+      - "traefik.http.middlewares.nextcloud-dav.replacepathregex.replacement=/remote.php/dav/"

nextcloud.yml

@@ -0,0 +1,35 @@
+entryPoints:
+  web:
+    address: ":80"
+  web-secure:
+    address: ":443"
+  
+providers:
+  docker:
+    watch: true
+    exposedByDefault: false
+  file:
+    directory: /etc/traefik/dynamic
+    watch: true
+    filename: dynamic.yml
+
+certificatesResolvers:
+  default:
+    acme:
+      email: ich@example.com
+      storage: /etc/traefik/acme/acme.json
+      httpChallenge:
+        entryPoint: web
+
+api:
+  insecure: true
+  dashboard: true
+
+log:
+  level: INFO
+
+accessLog:
+  filePath: /dev/stdout
+
+global:
+  sendAnonymousUsage: false