Kutt ist ein leistungsstarker Open-Source-URL-Shortener, der sich durch seine einfache Installation und Benutzerfreundlichkeit auszeichnet. In diesem Blogbeitrag zeigen wir dir, wie du Kutt mithilfe von Docker auf deiner Synology DiskStation installieren kannst – ohne SSH-Zugriff und nur mit dem Container Manager in DSM 7.2. Diese Anleitung ist speziell für DSM 7.2 optimiert.

Voraussetzungen

Bevor wir mit der Installation beginnen, stelle sicher, dass folgende Voraussetzungen erfüllt sind:

1. Synology DiskStation mit DSM 7.2: Diese Anleitung ist für DSM 7.2 optimiert.
2. Docker installiert: Installiere Docker über das Paket-Zentrum deiner DiskStation, falls noch nicht geschehen.
3. Container Manager: Der Container Manager ist in DSM 7.2 der Nachfolger von Docker und wird für die Verwaltung der Container verwendet.
4. Deine Diskstation sollte aus dem Internet erreichbar sein. Wie Du das machst findest Du in diesem Beitrag.

Schritt 1: Arbeitsverzeichnis erstellen

Zuerst erstellen wir ein Verzeichnis, in dem alle Daten für Kutt gespeichert werden. Dies sorgt dafür, dass deine Einstellungen und Daten auch nach einem Neustart des Containers erhalten bleiben.

1. Öffne File Station auf deiner DiskStation.
2. Navigiere zu /volume1/docker/ und erstelle einen neuen Ordner namens kutt.
3. Innerhalb des kutt-Ordners erstellst du zwei weitere Unterordner:
   • db: Hier wird die SQLite-Datenbank gespeichert.
   • custom: Dieser Ordner dient für benutzerdefinierte Anpassungen.

Schritt 2: Container im Container Manager erstellen

Nun richten wir den Kutt-Container über den Container Manager ein. Dies ist die grafische Oberfläche in DSM 7.2, mit der du Docker-Container verwalten kannst.

1. Öffne den Container Manager auf deiner DiskStation.
2. Klicke auf Projekt (oben links) und dann auf Erstellen.
3. Gib dem Projekt einen Namen, z.B. kutt.
4. Wähle den Pfad zum Arbeitsverzeichnis aus, das wir zuvor erstellt haben (/volume1/docker/kutt).
5. Klicke auf docker-compose.yml erstellen.

Schritt 3: docker-compose.yml erstellen

Im nächsten Schritt erstellen wir die docker-compose.yml-Datei, die die Konfiguration für den Kutt-Container enthält. Dies kannst du direkt im Container Manager erledigen.

Klicke im Container Manager auf Datei erstellen und wähle docker-compose.yml aus.

Füge den folgenden Inhalt in die Datei ein:

version: '3.7'

services:
  server:
    image: kutt/kutt:latest  # Offizielles Kutt-Image
    container_name: kutt-server
    restart: unless-stopped
    volumes:
      - /volume1/docker/kutt/db:/var/lib/kutt  # Persistente Speicherung für SQLite
      - /volume1/docker/kutt/custom:/kutt/custom  # Benutzerdefinierte Anpassungen
    environment:
      DB_FILENAME: "/var/lib/kutt/data.sqlite"
      NODE_ENV: "production"
      JWT_SECRET: "dein_geheimer_token"  # Token hier eintragen
      DEFAULT_DOMAIN: "example.com"  # Standarddomain anpassen
      ADMIN_EMAILS: "admin@example.com"  # Admin-Mail setzen
      DISALLOW_ANONYMOUS_LINKS: "true"  # Anonyme Links deaktivieren
    ports:
      - "3050:3000"  # Kutt auf Port 3050 erreichbar machen
    networks:
      - kutt-network

networks:
  kutt-network:
    driver: bridge

ACHTUNG: Ändere hier den Wert von JWT_SECRET, sowie deine Admin-Email.

Schritt 4: JWT Secret generieren

Damit Kutt sicher funktioniert, benötigst du einen geheimen Token (JWT_SECRET). Dieser Token wird für die Authentifizierung verwendet und sollte sicher aufbewahrt werden.

1. Generiere einen zufälligen 32-stelligen Token. Du kannst dazu einen Online-Token-Generator verwenden, wie z.B. diesen hier.
2. Kopiere den generierten Token und ersetze den Platzhalter dein_geheimer_token in der docker-compose.yml-Datei mit diesem Wert.
3. Ersetze “example.com” mit diener eigenen produktiv Domain.
4. Erstze Admin-Mail mit deiner eigenen Emailadresse.

Schritt 5: Container starten

Nachdem die Konfiguration abgeschlossen ist, klicken wir auf “weiter“.
Webportal via Webstation können wir überspringen.

Setzte einen Haken bei “Projekt starten nachdem es erstellt wurde“

Jetzt musst du kurz Warten bis alles erledig ist.

Schritt 6: Kutt aufrufen

Nachdem der Container gestartet wurde, ist Kutt unter der IP-Adresse deiner DiskStation und dem Port 3050 erreichbar.

1. Öffne einen Browser und gib folgende Adresse ein:
   http://deine-diskstation-ip:3050
2. Du solltest nun die Kutt-Weboberfläche sehen.

Fehlerbehebung

Falls Kutt nicht wie erwartet funktioniert, kannst du die Logs überprüfen, um mögliche Fehler zu identifizieren:

1. Öffne den Container Manager.
2. Wähle den kutt-server-Container aus.
3. Klicke auf Details und dann auf Logs, um die Logs anzuzeigen.

Stelle außerdem sicher, dass der Port 3050 nicht von einem anderen Dienst belegt ist. Falls nötig, kannst du den Port in der docker-compose.yml-Datei anpassen.

Überprüfe die Firewall (falls aktiviert) Deiner Disksstation.

Schritt 7: Domain über DynDNS auf der DiskStation erreichbar machen

Um deine Domain (oder alternativ deine Synology.me-Adresse) auf deiner DiskStation erreichbar zu machen, musst du einen DynDNS-Dienst einrichten. Dies ermöglicht es, dass deine Domain immer auf die aktuelle IP-Adresse deiner DiskStation verweist, auch wenn sich diese ändert.

1. Öffne die Systemsteuerung deiner DiskStation.
2. Navigiere zu Externer Zugriff und klicke auf DDNS.
3. Klicke auf Hinzufügen, um einen neuen DynDNS-Dienst zu erstellen.
4. Wähle deinen DNS-Provider aus der Liste aus. Falls dein Provider nicht aufgeführt ist, kannst du Custom Provider auswählen und die notwendigen Informationen manuell eingeben.
5. Gib deine Domain ein (z.B. web.modernmaverick.net) und konfiguriere die Einstellungen gemäß den Anforderungen deines DNS-Providers.
6. Speichere die Einstellungen und stelle sicher, dass der DynDNS-Dienst aktiviert ist.

WICHTIG: Stelle sicher das in den DNS-EInstellungen Deiner Domain DynDNS aktiviert ist.

Schritt 8: SSL-Zertifikat für die Domain einrichten

Um deine Domain mit einem SSL-Zertifikat zu verschlüsseln, kannst du ein kostenloses Zertifikat von Let’s Encrypt verwenden.

1. Öffne die Systemsteuerung deiner DiskStation.
2. Navigiere zu Sicherheit und klicke auf Zertifikate.
3. Klicke auf Hinzufügen und wähle Neues Zertifikat hinzufügen.
4. Wähle Ein Zertifikat von Let’s Encrypt beziehen aus.
5. Gib deine Domain ein (z.B. web.modern-maverick.net) und klicke auf Übernehmen.
6. Nachdem das Zertifikat erstellt wurde, weise es deiner Domain zu. Gehe dazu zurück zur Zertifikatsübersicht und klicke auf Einstellungen.
7. Wähle deine Domain aus und weise das neu erstellte Zertifikat zu.

Schritt 9: Reverse Proxy einrichten

Um Kutt über deine Domain mit SSL zu erreichen, musst du einen Reverse Proxy einrichten.

1. Öffne die Systemsteuerung deiner DiskStation.
2. Navigiere zu Anmeldeportal und klicke auf Erweitert.
3. Klicke auf Reverse Proxy und dann auf Erstellen.
4. Gib einen Namen für den Reverse Proxy ein (z.B. Kutt).
5. Wähle als Quellprotokoll HTTPS und gib deine Domain ein (z.B. web.modernmaverick.net).
6. Setze den Quellport auf 443.
7. Wähle als Ziel deine DiskStation (entweder localhost oder die IP-Adresse deiner DiskStation).
8. Setze den Zielport auf 3050 (den Port, auf dem Kutt läuft).
9. Klicke auf Erweitert -> Benutzerdefinierte Header und füge WebSocket hinzu.
10. Speichere die Einstellungen.

Schritt 10: SSL-Zertifikat für den Reverse Proxy zuweisen

1. Gehe zurück zur Systemsteuerung und navigiere zu Sicherheit > Zertifikate.
2. Stelle sicher, dass deine Domain das richtige Zertifikat verwendet. Falls nicht, weise das Zertifikat erneut zu.
3. Überprüfe, ob der Reverse Proxy korrekt funktioniert, indem du deine Domain im Browser aufrufst (z.B. https://web.modernmaverick.net).

Schritt 11: Kutt über die Domain aufrufen

Nachdem du den Reverse Proxy eingerichtet und das SSL-Zertifikat zugewiesen hast, kannst du Kutt über deine Domain aufrufen. Öffne einen Browser und gib deine Domain ein (z.B. https://web.modernmaverick.net). Du solltest nun die Kutt-Weboberfläche sehen, die über SSL verschlüsselt ist.

Fazit

Herzlichen Glückwunsch! Du hast erfolgreich Kutt auf deiner Synology DiskStation installiert – ohne SSH-Zugriff und nur mit dem Container Manager in DSM 7.2. Mit Kutt kannst du nun deine eigenen Kurzlinks erstellen und verwalten. Bei Bedarf kannst du weitere Anpassungen vornehmen, z.B. durch die Integration einer externen Datenbank wie MySQL oder PostgreSQL.

Viel Spaß beim Nutzen deines eigenen URL-Shorteners! Falls du Fragen oder Anregungen hast, hinterlasse gerne einen Kommentar.

Universelle Verwendung der Docker Compose Datei

Die in dieser Anleitung verwendete docker-compose.yml-Datei ist nicht nur für die Synology DiskStation geeignet, sondern kann auch in anderen Docker Compose-Umgebungen verwendet werden. Egal, ob du auf einem Linux-Server, einem Windows-PC mit Docker Desktop oder einer anderen NAS-Lösung arbeitest – die Konfiguration bleibt weitgehend gleich. Du musst lediglich sicherstellen, dass die Volumes (also die Pfade zu den Verzeichnissen) an deine Umgebung angepasst werden.