Doku: guests unter pve1/guests statt global.

Verlinkungen angepasst; pve2/guests als Platzhalter. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-28 11:15:21 +02:00
parent fbf62e6e48
commit 805b6d3534
26 changed files with 31 additions and 24 deletions
@@ -0,0 +1,22 @@
+# Stack: nextcloud
+
+Live: `/opt/stacks/nextcloud/`
+
+## Enthalten im Repo
+
+| Pfad | Zweck |
+|------|-------|
+| `compose.yml` | MariaDB, Redis, Nextcloud, Collabora, notify_push Sidecar |
+| `db.env` | DB-Credentials (REDACTED) |
+| `config/php/www2.conf` | PHP-FPM Tuning |
+| `config/php/php-local.ini` | APCu 128M |
+| `config/custom-cont-init.d/` | custom_apps-Symlink |
+| `config/nginx/site-confs/default.conf` | Nginx inkl. `/push/` für notify_push |
+
+## Nicht im Repo (nur auf dem Gast)
+
+- `config/www/` — Nextcloud-Installation, `config.php`, Apps
+- `db/` — MariaDB-Daten
+- `/mnt/nextcloud-data` — NFS User-Daten
+
+Betrieb & Tuning: [../../../../06_ubuntu-vm-nextcloud.md](../../../../06_ubuntu-vm-nextcloud.md)
@@ -0,0 +1,76 @@
+x-logging: &default-logging
+  driver: json-file
+  options:
+    max-size: "50m"
+    max-file: "3"
+
+networks:
+  default:
+    external: false
+  docbr0:
+    external: true
+services:
+  db:
+    logging: *default-logging
+    image: mariadb
+    command: --transaction-isolation=READ-COMMITTED --character-set-server=utf8
+      --innodb-read-only-compressed=OFF --log-bin=binlog --binlog-format=ROW
+      --expire_logs_days=7
+    restart: always
+    volumes:
+      - ./db:/var/lib/mysql
+    environment:
+      - MYSQL_ROOT_PASSWORD=REDACTED
+      - MARIADB_AUTO_UPGRADE=1
+    env_file:
+      - db.env
+  redis:
+    logging: *default-logging
+    image: redis:alpine
+    restart: always
+  nextcloud:
+    logging: *default-logging
+    image: lscr.io/linuxserver/nextcloud:latest
+    container_name: nextcloud
+    hostname: cloud
+    domainname: cloud.jeanavril.com
+    extra_hosts:
+      - cloud.jeanavril.com:127.0.0.1
+    environment:
+      - PUID=33
+      - PGID=33
+      - TZ=Etc/UTC
+    volumes:
+      - ./config:/config
+      - /mnt/nextcloud-data:/data
+    restart: unless-stopped
+    depends_on:
+      - db
+      - redis
+    networks:
+      default:
+      docbr0:
+        ipv4_address: 10.2.2.253
+  collabora:
+    logging: *default-logging
+    image: collabora/code
+    container_name: collabora
+    environment:
+      - domain=cloud.jeanavril.com
+      - username=admin
+      - password=REDACTED
+    cap_add:
+      - MKNOD
+    restart: always
+
+  notify_push:
+    logging: *default-logging
+    image: ghcr.io/nextcloud/notify_push:latest
+    container_name: nextcloud-notify-push
+    restart: unless-stopped
+    network_mode: "service:nextcloud"
+    depends_on:
+      - nextcloud
+    volumes:
+      - ./config/www/nextcloud/config/config.php:/config/config.php:ro
+    command: ["/notify_push", "--port", "7867", "--nextcloud-url", "http://127.0.0.1", "/config/config.php"]
@@ -0,0 +1,2 @@
+#!/usr/bin/with-contenv bash
+ln -sfn /config/www/nextcloud/custom_apps /app/www/public/custom_apps
@@ -0,0 +1,180 @@
+## Version 2025/07/10 - Changelog: https://github.com/linuxserver/docker-nextcloud/commits/master/root/defaults/nginx/site-confs/default.conf.sample
+
+# Set the `immutable` cache control options only for assets with a cache busting `v` argument
+map $arg_v $asset_immutable {
+    "" "";
+    default "immutable";
+}
+
+server {
+    listen 80 default_server;
+    listen [::]:80 default_server;
+    listen 443 ssl default_server;
+    listen [::]:443 ssl default_server;
+    listen 443 quic reuseport default_server;
+    listen [::]:443 quic reuseport default_server;
+
+    server_name _;
+
+    include /config/nginx/ssl.conf;
+
+    root /app/www/public;
+
+    # display real ip in nginx logs when connected through reverse proxy via docker network
+    set_real_ip_from 172.16.0.0/12;
+    real_ip_header X-Forwarded-For;
+
+    # https://docs.nextcloud.com/server/latest/admin_manual/installation/nginx.html#nextcloud-in-the-webroot-of-nginx
+
+    # set max upload size and increase upload timeout:
+    client_max_body_size 0;
+    client_body_timeout 300s;
+    fastcgi_buffers 64 4K;
+
+    # Enable gzip but do not remove ETag headers
+    gzip on;
+    gzip_vary on;
+    gzip_comp_level 4;
+    gzip_min_length 256;
+    gzip_proxied expired no-cache no-store private no_last_modified no_etag auth;
+    gzip_types application/atom+xml text/javascript application/json application/ld+json application/manifest+json application/rss+xml application/vnd.geo+json application/vnd.ms-fontobject application/wasm application/x-font-ttf application/x-web-app-manifest+json application/xhtml+xml application/xml font/opentype image/bmp image/svg+xml image/x-icon text/cache-manifest text/css text/plain text/vcard text/vnd.rim.location.xloc text/vtt text/x-component text/x-cross-domain-policy;
+
+    # Pagespeed is not supported by Nextcloud, so if your server is built
+    # with the `ngx_pagespeed` module, uncomment this line to disable it.
+    #pagespeed off;
+
+    # The settings allows you to optimize the HTTP2 bandwidth.
+    # See https://blog.cloudflare.com/delivering-http-2-upload-speed-improvements/
+    # for tuning hints
+    client_body_buffer_size 512k;
+
+    # HTTP response headers borrowed from Nextcloud `.htaccess`
+    add_header Referrer-Policy                   "no-referrer"       always;
+    add_header X-Content-Type-Options            "nosniff"           always;
+    add_header X-Frame-Options                   "SAMEORIGIN"        always;
+    add_header X-Permitted-Cross-Domain-Policies "none"              always;
+    add_header X-Robots-Tag                      "noindex, nofollow" always;
+    add_header X-XSS-Protection                  "1; mode=block"     always;
+
+    # Remove X-Powered-By, which is an information leak
+    fastcgi_hide_header X-Powered-By;
+
+    # Specify how to handle directories -- specifying `/index.php$request_uri`
+    # here as the fallback means that Nginx always exhibits the desired behaviour
+    # when a client requests a path that corresponds to a directory that exists
+    # on the server. In particular, if that directory contains an index.php file,
+    # that file is correctly served; if it doesn't, then the request is passed to
+    # the front-end controller. This consistent behaviour means that we don't need
+    # to specify custom rules for certain paths (e.g. images and other assets,
+    # `/updater`, `/ocs-provider`), and thus
+    # `try_files $uri $uri/ /index.php$request_uri`
+    # always provides the desired behaviour.
+    index index.php index.html /index.php$request_uri;
+
+    # Rule borrowed from `.htaccess` to handle Microsoft DAV clients
+    location = / {
+        if ( $http_user_agent ~ ^DavClnt ) {
+            return 302 /remote.php/webdav/$is_args$args;
+        }
+    }
+
+    location = /robots.txt {
+        allow all;
+        log_not_found off;
+        access_log off;
+    }
+
+    # Make a regex exception for `/.well-known` so that clients can still
+    # access it despite the existence of the regex rule
+    # `location ~ /(\.|autotest|...)` which would otherwise handle requests
+    # for `/.well-known`.
+    location ^~ /.well-known {
+        # The rules in this block are an adaptation of the rules
+        # in `.htaccess` that concern `/.well-known`.
+
+        location = /.well-known/carddav { return 301 /remote.php/dav/; }
+        location = /.well-known/caldav  { return 301 /remote.php/dav/; }
+
+        location /.well-known/acme-challenge    { try_files $uri $uri/ =404; }
+        location /.well-known/pki-validation    { try_files $uri $uri/ =404; }
+
+        # Let Nextcloud's API for `/.well-known` URIs handle all other
+        # requests by passing them to the front-end controller.
+        return 301 /index.php$request_uri;
+    }
+
+    # Rules borrowed from `.htaccess` to hide certain paths from clients
+    location ~ ^/(?:build|tests|config|lib|3rdparty|templates|data)(?:$|/)  { return 404; }
+    location ~ ^/(?:\.|autotest|occ|issue|indie|db_|console)                { return 404; }
+
+    # Ensure this block, which passes PHP files to the PHP process, is above the blocks
+    # which handle static assets (as seen below). If this block is not declared first,
+    # then Nginx will encounter an infinite rewriting loop when it prepends `/index.php`
+    # to the URI, resulting in a HTTP 500 error response.
+    location ~ \.php(?:$|/) {
+        # Required for legacy support
+        rewrite ^/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|ocs-provider\/.+|.+\/richdocumentscode\/proxy) /index.php$request_uri;
+
+        fastcgi_split_path_info ^(.+?\.php)(/.*)$;
+        set $path_info $fastcgi_path_info;
+
+        try_files $fastcgi_script_name =404;
+
+        include /etc/nginx/fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        fastcgi_param PATH_INFO $path_info;
+
+        fastcgi_param modHeadersAvailable true;         # Avoid sending the security headers twice
+        fastcgi_param front_controller_active true;     # Enable pretty urls
+        fastcgi_pass 127.0.0.1:9000;
+
+        fastcgi_intercept_errors on;
+        fastcgi_request_buffering off;
+
+        fastcgi_max_temp_file_size 0;
+    }
+
+    # Serve static files
+    location ~ \.(?:css|js|mjs|svg|gif|png|jpg|ico|wasm|tflite|map|ogg|flac)$ {
+        try_files $uri /index.php$request_uri;
+        add_header Cache-Control "public, max-age=15778463, $asset_immutable";
+        access_log off;     # Optional: Don't log access to assets
+
+        location ~ \.wasm$ {
+            default_type application/wasm;
+        }
+
+    }
+
+    location ~ \.woff2?$ {
+        try_files $uri /index.php$request_uri;
+        expires 7d;         # Cache-Control policy borrowed from `.htaccess`
+        access_log off;     # Optional: Don't log access to assets
+    }
+
+    # Rule borrowed from `.htaccess`
+    location /remote {
+        return 301 /remote.php$request_uri;
+    }
+
+    # Support for the Client Push (notify_push) plugin, needs mod installed https://github.com/linuxserver/docker-mods/tree/nextcloud-notify-push
+    location ^~ /push/ {
+        proxy_pass http://127.0.0.1:7867/;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "Upgrade";
+    }
+
+    location / {
+        # enable for basic auth
+        #auth_basic "Restricted";
+        #auth_basic_user_file /config/nginx/.htpasswd;
+
+        try_files $uri $uri/ /index.php$request_uri;
+    }
+
+    # deny access to .htaccess/.htpasswd files
+    location ~ /\.ht {
+        deny all;
+    }
+}
@@ -0,0 +1,4 @@
+; Edit this file to override php.ini directives
+
+date.timezone = Etc/UTC
+apc.shm_size=128M
@@ -0,0 +1,13 @@
+; Edit this file to override www.conf and php-fpm.conf directives and restart the container
+; Freigabe 2026-06-28 — siehe docu/migration/nextcloud-tuning-freigabe.md
+
+[www]
+pm = dynamic
+pm.max_children = 12
+pm.start_servers = 3
+pm.min_spare_servers = 2
+pm.max_spare_servers = 6
+pm.max_requests = 500
+request_terminate_timeout = 300
+request_slowlog_timeout = 10s
+slowlog = /config/log/php/fpm-slow.log
@@ -0,0 +1,3 @@
+MYSQL_PASSWORD=REDACTED
+MYSQL_DATABASE=nextcloud
+MYSQL_USER=nextcloud