Node-RED

Node-RED openen

• Open je browser en ga naar: https://<SERVER_IP>
• Een browserwaarschuwing voor SSL is normaal (zelfondertekend certificaat)
• Authenticatie vereist (Basic Auth popup)
• Authenticatiemethode: HTTP Basic Auth
• Inloggegevens worden veilig opgeslagen in: /root/.cloudzy-creds

Belangrijke bestanden en mappen

• De hoofdinstallatiemap is /root/node-red.
• Het Docker-orchestratiebestand is /root/node-red/docker-compose.yml.
• Persistente Node-RED-gegevens worden opgeslagen in /var/lib/docker/volumes/node-red_node-red-data/_data.
• Het Nginx-configuratiebestand bevindt zich op /etc/nginx/sites-available/node-red.
• Basisverificatiegegevens worden opgeslagen in /etc/nginx/auth/node-red.htpasswd.
• TLS-certificaten worden opgeslagen in /etc/nginx/ssl.

Servicebeheer

Containerstatus controleren:

docker ps

Logs weergeven:

docker compose -f /root/node-red/docker-compose.yml logs -f

Node-RED herstarten:

docker compose -f /root/node-red/docker-compose.yml restart

Nginx opnieuw starten:

systemctl restart nginx

Node-RED-beheerdergebruiker (alternatief voor basisverificatie)

Node-RED heeft een eigen intern authenticatiesysteem dat HTTP Basic Auth kan vervangen.

1. Localiseren settings.js

Het hoofdconfiguratiebestand staat in het Node-RED Docker-volume: /var/lib/docker/volumes/node-red_node-red-data/_data/settings.js

2. Inschakelen adminAuth

Open settings.js en verwijder de commentaarmarkering van (of voeg toe) adminAuth sectie. Het zou er ongeveer zo uit moeten zien:

  adminAuth: {
      type: "credentials",
      users: [
          {
              username: "admin",
              password: "<HASHED_PASSWORD>",
              permissions: "*"
      }]
  },

3. Genereer een wachtwoord-hash

Je kunt de hash aanmaken vanuit de Node-RED-container:

docker exec -it node-red-node-red-1 node-red admin hash-pw

Je wordt gevraagd je wachtwoord in te voeren.

Kopieer de gegenereerde hash en plak deze als de password waarde in settings.js.

4. Node-RED herstarten

Na bewerking settings.js:

docker compose -f /root/node-red/docker-compose.yml restart

5. HTTP Basic Auth uitschakelen in Nginx (optioneel)

Bewerk het Nginx-sitebestand: /etc/nginx/sites-available/node-red

Verwijder of commentarieer deze regels uit:

auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/node-red.htpasswd;

Nginx herladen:

systemctl restart nginx

SSL inschakelen met een domein

1. Wijs uw domein toe aan het server-IP.

2. Bewerk de Nginx-configuratie en vervang beide server_name <IP>; door uw domein (<your-domain>) voor zowel het HTTP- (poort 80) als het HTTPS-blok (poort 443):

vim /etc/nginx/sites-available/node-red

3. Installeer Certbot:

apt install -y certbot python3-certbot-nginx

4. Voer het volgende commando uit om een geldig Let's Encrypt-certificaat te genereren:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Vervang de SSL-paden in de Nginx-configuratie:

vim /etc/apache2/sites-available/node-red
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Herstart Nginx om de wijzigingen toe te passen:

systemctl restart nginx

7. Open je browser en ga naar: https://yourdomain.com