Readeck

Zugriff auf Readeck

1. Browser öffnen und aufrufen: https://<SERVER_IP>/
2. Eine Browser-SSL-Warnung ist zu erwarten, da das Zertifikat selbstsigniert ist.
3. Lege das Admin-Konto sofort über die Weboberfläche an.

Wichtige Dateien und Verzeichnisse

• Readeck-Datenverzeichnis: /var/lib/readeck
• Readeck-Konfigurationsverzeichnis: /etc/readeck
• Readeck-Binärdatei /usr/local/bin/readeck
• Systemd-Servicedatei: /etc/systemd/system/readeck.service
• Nginx Virtual Host: /etc/nginx/sites-available/readeck
• TLS-Zertifikat und Schlüssel: /etc/nginx/ssl

Dienste verwalten

Readeck-Status prüfen:

systemctl status readeck

Readeck neu starten:

systemctl restart readeck

Readeck-Logs anzeigen:

journalctl -xeu readeck --no-pager -f

Nginx-Verwaltung:

systemctl status nginx
systemctl restart nginx
journalctl -u nginx -f

Sicherheitshinweise

• Readeck läuft als Systembenutzer ohne Login.
• Strenges systemd-Sandboxing ist aktiviert.
• Nur Ports 80 und 443 sind exponiert.
• Interner Service-Port 8000 ist von außen nicht erreichbar.
• TLS verwendet ein selbst signiertes Zertifikat.

SSL mit einer Domain aktivieren

1. Weise deiner Domain die Server-IP zu.

2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name <IP>; mit Ihrer Domain (<your-domain>) für sowohl HTTP (Port 80) als auch HTTPS (Port 443) Blöcke:

vim /etc/nginx/sites-available/readeck

3. Installieren Sie Certbot:

apt install -y certbot python3-certbot-nginx

4. Führe folgenden Befehl aus, um ein gültiges Let's Encrypt-Zertifikat zu generieren:

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

5. Ersetze SSL-Pfade in der Nginx-Konfiguration:

vim /etc/apache2/sites-available/readeck
# 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. Starte NGINX neu, um die Änderungen zu übernehmen:

systemctl restart nginx

7. Öffne deinen Browser und rufe folgende Adresse auf: https://yourdomain.com