Thomas/Homelab--Bratonein-Kontrollzentrum--Tutorial

Files

Thomas Dannenberg 956574f895 Kapitel 7/Tutorial.md aktualisiert

2025-09-04 14:37:11 +00:00

9.6 KiB

Raw Blame History

🛠️ Kapitel 7 – Nextcloud (Nginx + PostgreSQL + Redis, NPM-Setup)

[!INFO] Dieses Kapitel ist eine vorbereitete Rohfassung. Es enthält bereits alle technischen Schritte in korrekter Reihenfolge. Die Blogtexte und Erklärungen folgen später.

✨ Einleitung

[Platzhalter für Einstiegstext:
Was ist Nextcloud, warum ist es sinnvoll, was kann man damit tun.
Hinweis auf Unabhängigkeit von Google & Co., Einsatz als Streamer, für Teamsharing etc.]

📋 Voraussetzungen

[Platzhalter für grafische Checkliste oder Übersicht: z. B. Screenshot LXC-Übersicht]

Proxmox-Host mit 2 Platten (System + Daten)
LXC mit Ubuntu 24.04, „Nesting“ aktiviert
Nginx Proxy Manager (NPM) läuft bereits
Domain zeigt korrekt auf den Proxy
Container-Ressourcen: 2 vCPU, 4–8 GB RAM
Grundkenntnisse in Proxmox, SSH, Terminal

⚙️ LXC-Container anlegen

In der Proxmox-GUI:

CT-Name: nextcloud
Template: Ubuntu 24.04 LTS
CPU: 2+, RAM: 4096+ MB
„Nesting“ aktivieren (unter „Optionen“)

Zweite Festplatte direkt einbinden:

Mount Point: /mnt/hdd
Größe: z. B. 500 GB
Backup: deaktivieren

Nach dem Start:

ssh root@<IP-des-Containers>
ls -ld /mnt/hdd

→ Wenn ein gültiges Verzeichnis erscheint, ist alles korrekt gemountet.

📦 System vorbereiten

[Platzhalter: Warum update & Basis-Tools wichtig sind]

apt update && apt upgrade -y
apt install -y curl gnupg2 ca-certificates lsb-release apt-transport-https software-properties-common unzip nano sudo gnupg

🌐 Dienste installieren

[Platzhalter: Warum explizites PHP-Repo nötig ist (Ubuntu 24.04 enthält nicht alle Module).
Verweis auf Ondřej Surý PPA – Standard bei professionellen PHP-Deployments.]

PHP 8.3 Repository für Ubuntu 24.04 einbinden

[Platzhalter: Warum Ubuntu 24.04 kein vollständiges PHP ausliefert – und warum wir stattdessen das offizielle Sury-Repository nutzen.]

apt install -y curl lsb-release ca-certificates gnupg
curl -fsSL https://packages.sury.org/php/apt.gpg | gpg --dearmor -o /etc/apt/trusted.gpg.d/php.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/php.list
apt update

Dienste + PHP 8.3 + Module installieren

apt install -y nginx redis-server postgresql php8.3-fpm php8.3-pgsql php8.3-cli php8.3-common php8.3-gd php8.3-mbstring php8.3-xml php8.3-zip php8.3-curl php8.3-bz2 php8.3-intl php8.3-gmp php8.3-imagick php8.3-redis

[Platzhalter: Hinweis auf explizite PHP-Version, warum kein „php-*“ verwendet wird]

apt install -y nginx redis-server postgresql php8.3-fpm php8.3-pgsql php8.3-cli php8.3-common php8.3-gd php8.3-mbstring php8.3-xml php8.3-zip php8.3-curl php8.3-bz2 php8.3-intl php8.3-gmp php8.3-imagick php8.3-redis

📁 Verzeichnisse anlegen

mkdir -p /srv/nextcloud/app
mkdir -p /mnt/hdd/nextcloud_data
chown -R www-data:www-data /mnt/hdd/nextcloud_data

⚙️ PHP konfigurieren

`php.ini` (globale Werte)

nano /etc/php/8.3/fpm/php.ini

upload_max_filesize = 10G
post_max_size = 10G
memory_limit = 1024M
max_execution_time = 3600
max_input_time = 3600
date.timezone = Europe/Berlin

opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.interned_strings_buffer=16

`www.conf` (Pool-Konfiguration)

nano /etc/php/8.3/fpm/pool.d/www.conf

pm = dynamic
pm.max_children = 12
pm.start_servers = 3
pm.min_spare_servers = 2
pm.max_spare_servers = 6

PHP-FPM neu laden:

systemctl reload php8.3-fpm

🐘 PostgreSQL initialisieren (für LXC)

pg_dropcluster 16 main --stop
pg_createcluster 16 main --start
systemctl enable postgresql
systemctl start postgresql

Zugang zur DB:

su - postgres

Datenbank anlegen:

psql
CREATE DATABASE nextcloud;
CREATE USER nextcloud WITH PASSWORD 'DEIN_SICHERES_PASSWORT';
GRANT ALL PRIVILEGES ON DATABASE nextcloud TO nextcloud;
GRANT ALL ON SCHEMA public TO nextcloud;
ALTER SCHEMA public OWNER TO nextcloud;
\q

Dann wieder raus:

exit

🔄 Redis konfigurieren

[Platzhalter: Warum Redis wichtig ist (Caching, File Locking, keine APCu mehr).
Nur lokal via Socket, daher keine Authentifizierung nötig.]

Redis-Zugriffsrechte setzen

usermod -aG redis www-data

Note

Dadurch kann der Webserver-User (www-data) auf den Redis-Socket zugreifen.

Redis-Konfiguration prüfen

nano /etc/redis/redis.conf

Die folgenden Zeilen sollten gesetzt sein (oder geändert werden):

supervised systemd
unixsocket /var/run/redis/redis-server.sock
unixsocketperm 770

Tip

Weitere Einstellungen wie bind oder requirepass brauchst du nicht,
solange du Redis nur lokal über den Socket nutzt.

Redis neu starten:

systemctl restart redis-server

Fertig. Jetzt ist Redis bereit für Nextcloud – Caching und Locking funktionieren nach dem Setup automatisch,
wenn wir die Einträge in der config.php ergänzen.

⬇️ Nextcloud herunterladen

[Platzhalter: Warum wir Nextcloud manuell installieren (Version kontrollieren, Updates nachvollziehbar, keine Snap/FPM-Probleme).]

Download & Entpacken

cd /srv/nextcloud/app
curl -LO https://download.nextcloud.com/server/releases/nextcloud-29.0.1.zip
unzip nextcloud-29.0.1.zip && rm nextcloud-29.0.1.zip
chown -R www-data:www-data nextcloud

Note

Aktuelle Version prüfen: https://nextcloud.com/changelog/

⚙️ `config.php` vorbereiten

[Platzhalter: Warum wir die Datei vorher anlegen (Proxy-Erkennung, Redis, saubere Setup-Erfahrung).
Wird beim ersten Aufruf automatisch ergänzt.]

Datei erstellen

nano /srv/nextcloud/app/nextcloud/config/config.php

Inhalt einfügen

<?php
$CONFIG = array (
  'trusted_domains' => [
    'cloud.DEINE-DOMAIN.tld',
  ],
  'overwrite.cli.url' => 'https://cloud.DEINE-DOMAIN.tld',
  'overwritehost' => 'cloud.DEINE-DOMAIN.tld',
  'overwriteprotocol' => 'https',
  'trusted_proxies' => ['IP.DEINES.NPM'],

  'filelocking.enabled' => true,
  'memcache.local' => '\\OC\\Memcache\\Redis',
  'memcache.locking' => '\\OC\\Memcache\\Redis',
  'redis' => [
    'host' => '/var/run/redis/redis-server.sock',
    'port' => 0,
    'timeout' => 1.5,
  ],
);

Tip

trusted_proxies kann z. B. 10.0.0.1 sein, wenn NPM im selben Netz läuft.
Mehrere Proxies können als Array ergänzt werden.

Damit ist Nextcloud bereit – gleich folgt der Abschnitt zur Nginx-Konfiguration.

🌐 Nginx konfigurieren (vHost intern)

[Platzhalter: Warum wir keinen HTTPS/SSL im Container brauchen (TLS wird von NPM übernommen).
Nginx hier nur als lokaler Webserver für PHP-FPM + Nextcloud.]

Neue Konfigurationsdatei anlegen

nano /etc/nginx/sites-available/nextcloud.conf

Inhalt einfügen

server {
  listen 80;
  server_name cloud.DEINE-DOMAIN.tld;

  root /srv/nextcloud/app/nextcloud;
  index index.php index.html;

  client_max_body_size 10G;
  fastcgi_buffers 64 4K;

  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-XSS-Protection "1; mode=block" always;

  location = /robots.txt {
    allow all;
    log_not_found off;
    access_log off;
  }

  location ~ ^/(?:\.htaccess|data|config|db_structure\\.xml|README) {
    deny all;
  }

  location ~ \\.php(?:$|/) {
    include fastcgi_params;
    fastcgi_split_path_info ^(.+\\.php)(/.*)$;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_intercept_errors on;
    fastcgi_request_buffering off;
  }
}

Site aktivieren

ln -s /etc/nginx/sites-available/nextcloud.conf /etc/nginx/sites-enabled/
rm /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx

Note

nginx -t prüft die Konfiguration. Nur wenn „syntax is ok“ erscheint, darfst du reloaden.

Sobald das erledigt ist, folgt der Abschnitt für NPM‑Proxy + Domain-Setup. Sag einfach, wann du soweit bist – oder wenn du auf ein Problem triffst.

🌍 NPM-Proxy konfigurieren

[Platzhalter: Warum wir Nginx Proxy Manager verwenden (TLS-Termination, zentraler Reverse Proxy, Let’s Encrypt, Portweiterleitung).
Nextcloud selbst kennt nur HTTP und läuft im LXC ohne Zertifikat.]

Im Nginx Proxy Manager (Web-GUI):

Gehe auf Hosts → Proxy Hosts → Add Proxy Host
Trage ein:

Feld	Wert
Domain Names	`cloud.DEINE-DOMAIN.tld`
Forward Hostname/IP	`<IP deines Nextcloud-LXC>`
Forward Port	`80`
Access	Websockets aktivieren ✅
SSL	→ Request a new SSL Certificate
	→ Force SSL aktivieren ✅
	→ HTTP/2 Support aktivieren ✅

Tip

Trage bei „E-Mail“ eine gültige Adresse ein, sonst schlägt das Zertifikat fehl.
HSTS kannst du bei Bedarf aktivieren (empfohlen).

(Optional) Für große Uploads:

Reiter „Advanced“:

client_max_body_size 10G;
proxy_read_timeout 3600;
proxy_send_timeout 3600;

Jetzt testen:
Öffne im Browser:

https://cloud.DEINE-DOMAIN.tld

Du solltest den Nextcloud-Setup-Assistenten sehen – ohne Fehlermeldung, ohne Mixed Content.
Falls du eine Nginx-Standardseite siehst: Proxy nicht korrekt → prüfe Domain, IP und Port.

9.6 KiB Raw Blame History Unescape Escape

🛠️ Kapitel 7 – Nextcloud (Nginx + PostgreSQL + Redis, NPM-Setup)

✨ Einleitung

📋 Voraussetzungen

⚙️ LXC-Container anlegen

📦 System vorbereiten

🌐 Dienste installieren

PHP 8.3 Repository für Ubuntu 24.04 einbinden

Dienste + PHP 8.3 + Module installieren

📁 Verzeichnisse anlegen

⚙️ PHP konfigurieren

php.ini (globale Werte)

www.conf (Pool-Konfiguration)

🐘 PostgreSQL initialisieren (für LXC)

🔄 Redis konfigurieren

Redis-Zugriffsrechte setzen

Redis-Konfiguration prüfen

⬇️ Nextcloud herunterladen

Download & Entpacken

⚙️ config.php vorbereiten

Datei erstellen

Inhalt einfügen

🌐 Nginx konfigurieren (vHost intern)

Neue Konfigurationsdatei anlegen

Inhalt einfügen

Site aktivieren

🌍 NPM-Proxy konfigurieren

Im Nginx Proxy Manager (Web-GUI):

(Optional) Für große Uploads:

9.6 KiB

Raw Blame History

`php.ini` (globale Werte)

`www.conf` (Pool-Konfiguration)

⚙️ `config.php` vorbereiten