init

2025-12-05 09:15:15 +01:00
commit 8837c20d66
1752 changed files with 1123339 additions and 0 deletions
--- a/content/bewoners/nginx/_index.nl.md
+++ b/content/bewoners/nginx/_index.nl.md
@@ -0,0 +1,121 @@
+---
+title: "NGINX"
+date: 2025-11-08
+weight: 1
+feedback: true
+draft: false
+---
+
+{{< notice "info" "Informatie">}}
+De instructies in dit artikel zijn uitsluitend voor de webserver NGINX, niet de software die hierop geïnstalleerd gaat worden.
+{{< /notice >}}
+
+## Benodigdheden
+- Een server met een Debian Linux installatie
+- Een domeinnaam
+- DNS ingesteld naar het IP-adres van de server
+- Rechten als `su` of `sudo` om opdrachten als root uit te voeren.
+
+## Voorbereiding
+Zorg dat het systeem up-to-date is voordat je begint met installeren. 
+1. Log in met SSH.
+```bash
+ssh gebruiker@server
+```
+2. Gebruik het `apt` commando om het systeem te updaten.
+```bash
+sudo apt update && sudo apt upgrade
+```
+## NGINX
+### Installatie
+Installeer NGINX met het `apt` commando.
+```bash
+sudo apt install nginx
+```
+
+### Configuratie
+{{< notice "info" "Informatie" >}}
+Verander in de code **voorbeeld** naar jouw domeinnaam, zonder `https://` of `www` tenzij letterlijk aangegeven zoals **voorbeeld.nl**
+{{< /notice >}}
+
+1. Zorg dat NGINX altijd start met de server.
+```bash
+sudo systemctl enable --now nginx
+```
+2. Kopieer de standaard site configuratie.
+```bash
+sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/voorbeeld.nl
+```
+3. Pas de inhoud met het programma `nano`.
+```bash
+sudo nano /etc/nginx/sites-available/voorbeeld.nl
+```
+```nginx
+server {
+    server_name voorbeeld.nl www.voorbeeld.nl;
+
+    root /var/www/voorbeeld.nl/public/;
+    index index.html;
+
+    location / {
+            try_files $uri $uri/ =404;
+    }
+
+    listen 80;
+    listen [::]:80;
+
+}
+```
+{{< notice "info" "Tip" >}}
+Je kan plakken in de terminal met CTRL + SHIFT + V
+{{< /notice >}}
+4. Activeer de configuratie door een link te maken met het `ln` commando.
+```bash
+sudo ln -s /etc/nginx/sites-available/voorbeeld.nl \
+           /etc/nginx/sites-enabled/voorbeeld.nl
+```
+5. Controleer werking en herlaad NGINX.
+```bash
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+## CertBot
+### Installatie
+Installeer CertBot met het `apt` commando.
+
+```bash
+sudo apt install certbot python3-certbot-nginx
+```
+### Configuratie
+Genereer en implementeer een geldig certificaat met het volgende commando.
+```bash
+sudo certbot --nginx
+```
+Volg de stappen op met logische antwoorden, zoals het opgeven van jouw e-mailadres en selectie welke sites certificering moeten krijgen.
+{{< notice "info" "Tip" >}}
+Wil je liever je configuratie testen voordat je een certificaat ophaalt, gebruik dan de parameter `--dry-run`.
+```
+sudo certbot --nginx --dry-run
+```
+{{< /notice >}}
+
+## Website activeren
+1. Maak een index.html bestand. En geef deze een vorm van vulling, zoals voorbeeld hieronder.
+```bash
+sudo mkdir -p /var/www/voorbeeld.nl/public
+sudo nano /var/www/voorbeeld.nl/public/index.html
+```
+```html
+<html>
+  <body>
+    <h1>Hallo wereld</h1>
+  </body>
+</html>
+```
+2. Wijs de omgeving toe aan de `www-data` gebruiker en groep, stel schrijfrechten in.
+```bash
+sudo chown www-data:www-data /var/www/voorbeeld.nl -R
+sudo chmod -R g+rwX /var/www/voorbeeld.nl
+```
+3. Open de browser en ga naar je website toe, je zou nu de inhoud van de index.html moeten kunnen zien.
--- a/content/bewoners/nginx/nextcloud/_index.nl.md
+++ b/content/bewoners/nginx/nextcloud/_index.nl.md
@@ -0,0 +1,204 @@
+---
+title: "NextCloud (NGINX)"
+date: 2025-11-10
+weight: 3
+feedback: true
+draft: false
+---
+
+NextCloud is een open source platform voor bestandssynchronisatie en samenwerking, vergelijkbaar met diensten als Dropbox of OneDrive. In deze handleiding installeren we NextCloud rechtstreeks op een Debian server met NGINX als webserver.
+
+{{< notice "info" "Informatie" >}}
+Deze handleiding gaat uit van een Debian server met een basis NGINX installatie zoals beschreven in het bovenliggende artikel **NGINX**.
+{{< /notice >}}
+
+## Benodigdheden
+- Een server met een Debian Linux installatie
+- Een domeinnaam, bijvoorbeeld `cloud.voorbeeld.nl`
+- DNS ingesteld naar het IP-adres van de server
+- Een werkende webserver (NGINX) die verzoeken voor jouw domein kan verwerken
+- Rechten als `su` of `sudo` om opdrachten als root uit te voeren
+
+## Voorbereiding
+Zorg dat het systeem up-to-date is voordat je NextCloud installeert.
+
+1. Log in met SSH.
+```bash
+ssh gebruiker@server
+```
+
+2. Werk de pakketbron en geïnstalleerde pakketten bij.
+```bash
+sudo apt update && sudo apt upgrade
+```
+
+## PHP en database installeren
+NextCloud heeft PHP en een database nodig. In dit voorbeeld gebruiken we MariaDB als database.
+
+1. Installeer PHP, de benodigde modules en MariaDB.
+```bash
+sudo apt install php-fpm php-mysql php-xml php-gd php-curl php-mbstring php-zip php-intl php-bcmath php-gmp mariadb-server unzip
+```
+
+2. Beveilig de MariaDB installatie
+```bash
+sudo mysql_secure_installation
+```
+
+3. Maak een database en gebruiker voor NextCloud.
+```bash
+sudo mysql
+```
+
+Voer daarna in de MariaDB prompt de volgende opdrachten uit, pas wachtwoord en namen aan:
+
+```sql
+CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
+CREATE USER 'nc_user'@'localhost' IDENTIFIED BY 'sterk-db-wachtwoord';
+GRANT ALL PRIVILEGES ON nextcloud.* TO 'nc_user'@'localhost';
+FLUSH PRIVILEGES;
+EXIT;
+```
+
+## NextCloud bestanden downloaden
+We plaatsen NextCloud in `/var/www/nextcloud`.
+
+1. Download en pak NextCloud uit.
+```bash
+cd /tmp
+curl -LO https://download.nextcloud.com/server/releases/latest.zip
+unzip latest.zip
+```
+
+2. Maak de doelmap aan en kopieer de bestanden.
+```bash
+sudo mkdir -p /var/www/nextcloud
+sudo rsync -av nextcloud/ /var/www/nextcloud/
+```
+
+3. Stel de juiste eigenaar en rechten in.
+```bash
+sudo chown -R www-data:www-data /var/www/nextcloud
+sudo find /var/www/nextcloud -type d -exec chmod 750 {} \;
+sudo find /var/www/nextcloud -type f -exec chmod 640 {} \;
+```
+
+## NGINX configureren voor NextCloud
+We maken een aparte server-configuratie aan voor `cloud.voorbeeld.nl`.
+
+1. Maak een nieuw configuratiebestand.
+```bash
+sudo nano /etc/nginx/sites-available/cloud.voorbeeld.nl
+```
+
+2. Plaats de volgende configuratie in het bestand:
+
+```nginx
+server {
+    server_name cloud.voorbeeld.nl;
+
+    root /var/www/nextcloud;
+    index index.php index.html;
+
+    client_max_body_size 512M;
+    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 = /.well-known/carddav  { return 301 $scheme://$host/remote.php/dav; }
+    location = /.well-known/caldav   { return 301 $scheme://$host/remote.php/dav; }
+
+    location ~ ^/(?:build|tests|config|lib|3rdparty|templates|data)/ {
+        deny all;
+    }
+    location ~ ^/(?:\.|autotest|occ|issue|indie|db_|console) {
+        deny all;
+    }
+
+    location / {
+        rewrite ^ /index.php$request_uri;
+    }
+
+    location ~ \.php(?:$|/) {
+        fastcgi_split_path_info ^(.+\.php)(/.+)$;
+        include snippets/fastcgi-php.conf;
+        fastcgi_pass unix:/run/php/php-fpm.sock;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+    }
+
+    location ~ \.(?:css|js|woff2?|svg|gif|map)$ {
+        try_files $uri /index.php$request_uri;
+        access_log off;
+        expires 6M;
+    }
+
+    location ~ \.(?:png|html|ttf|ico|jpg|jpeg)$ {
+        try_files $uri /index.php$request_uri;
+        access_log off;
+        expires 6M;
+    }
+
+    listen 80;
+    listen [::]:80;
+}
+```
+
+{{< notice "info" "Informatie" >}}
+Controleer of het pad naar de PHP-FPM socket klopt. Op sommige Debian-versies kan dit bijvoorbeeld `/run/php/php8.2-fpm.sock` zijn. Gebruik `ls /run/php/` om het juiste bestand te vinden en pas `fastcgi_pass` zo nodig aan.
+{{< /notice >}}
+
+3. Activeer de configuratie en controleer NGINX.
+```bash
+sudo ln -s /etc/nginx/sites-available/cloud.voorbeeld.nl /etc/nginx/sites-enabled/cloud.voorbeeld.nl
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+## CertBot voor HTTPS
+Zorg voor een geldig TLS-certificaat met CertBot.
+
+1. Installeer CertBot met de NGINX plugin.
+```bash
+sudo apt install certbot python3-certbot-nginx
+```
+
+2. Vraag een certificaat aan voor jouw domein.
+```bash
+sudo certbot --nginx
+```
+
+Volg de stappen op met logische antwoorden, zoals het opgeven van jouw e-mailadres en de keuze om HTTP automatisch naar HTTPS om te leiden.
+
+{{< notice "info" "Informatie" >}}
+Wil je liever je configuratie testen voordat je een certificaat ophaalt, gebruik dan de parameter `--dry-run`.
+```bash
+sudo certbot --nginx --dry-run
+```
+{{< /notice >}}
+
+## NextCloud installatie afronden
+1. Open een browser en ga naar:
+```text
+http://cloud.voorbeeld.nl
+```
+of, na het instellen van HTTPS:
+```text
+https://cloud.voorbeeld.nl
+```
+
+2. Volg de stappen van de NextCloud installatie:
+   - Stel een beheerdersgebruikersnaam en wachtwoord in
+   - Vul de databasegegevens in:
+     - Databasegebruiker: `nc_user`
+     - Databasewachtwoord: `sterk-db-wachtwoord`
+     - Database: `nextcloud`
+     - Host: `localhost`
+
+{{< notice "info" "Informatie" >}}
+Na afronden keert NextCloud terug naar de login-pagina en kun je inloggen met het beheerdersaccount.
+{{< /notice >}}