Wähle, wie abgewiesene Besucher beantwortet werden​

Bisher hat ein durch eine Whitelist eingeschränkter Proxy oder eine Site allen anderen mit dem nginx-eigenen 403 Forbidden geantwortet. Das funktioniert, verrät der Welt aber auch, dass hinter dieser Domain etwas läuft.

Der Tab Access des Assistenten hat jetzt eine Einstellung Visitors outside the whitelists, für Reverse Proxies und gehostete Sites gleichermaßen:

Wie immer zeigt der Vorschau-Tab genau, was geschrieben wird. Mit einem 404 sieht der Whitelist-Teil der Konfiguration so aus:

include /etc/nginx/whitelists/office.conf;
deny all;

error_page 403 = @rg_denied;

location @rg_denied {
    allow all;
    return 404;
}

Einige Schutzmechanismen kommen dazu:

• Die Einstellung erfordert mindestens eine Whitelist: Ohne sie wird niemand abgewiesen, und der Assistent weist dich darauf hin.
• Die Weiterleitungsadresse wird geprüft, bevor sie in die Datei gelangt: http:// oder https://, ein Host, optional Port, Pfad und Query-String, und nichts, was aus der return-Zeile ausbrechen könnte.
• Die Let's-Encrypt-Challenge bleibt für alle erreichbar, damit Zertifikatserneuerungen unabhängig von deiner Wahl weiter funktionieren.

Wieder öffnen und importieren​

Die Einstellung wird aus der Datei zurückgelesen: Das erneute Öffnen einer Konfiguration im Assistenten oder der Import einer handgeschriebenen Konfiguration stellt die Auswahl und die Weiterleitungsadresse wieder her. Wenn die Zeile error_page 403 = @rg_denied; oder ihr Block location @rg_denied von Hand so verändert wurde, dass der Assistent sie nicht reproduzieren kann, wird der Import mit Zeilennummer und Begründung abgelehnt, und die Datei bleibt als Rohtext bearbeitbar.

Für Mitwirkende​

Das Projekt hat außerdem bekommen, was es braucht, um Beiträge willkommen zu heißen:

• Einen Leitfaden für Beiträge zu Codestil, Tests, Commits und der Lizenzvereinbarung für Mitwirkende.
• Eine Sicherheitsrichtlinie, um Sicherheitslücken vertraulich zu melden.
• Issue-Formulare und eine Vorlage für Pull Requests.

Das Image unter ghcr.io/byteroast/roastgate ist jetzt öffentlich: Zum Herunterladen ist kein docker login mehr nötig.

Wie bekomme ich Roastgate 0.2.0?​

Update​

Aus dem Ordner, der docker-compose.yml enthält:

docker compose pull
docker compose up -d

Die Compose-Datei hat in diesem Release nur zwei Kommentare verloren: Du musst sie nicht erneut herunterladen.

docker run --rm -v roastgate-data:/data -v "$PWD":/backup alpine tar czf /backup/roastgate-data.tgz -C /data .

Um bei dieser Version zu bleiben, verwende in docker-compose.yml den Tag 0.2.0 statt latest.

Neuinstallation​

Folge der Installationsanleitung oder dem Beitrag Vorstellung von Roastgate 0.1.0: Die Schritte sind dieselben.

• Roastgate auf GitHub
• Release 0.2.0
• Probleme melden

Warum?​

Vom ersten Tag an war Music Sharity vollständig von der Odesli-API (auch bekannt als song.link) abhängig, um Links zwischen Streamingplattformen umzuwandeln. Odesli hat die ganze Schwerarbeit erledigt: Titel und Alben zwischen den Diensten zuordnen und die passenden Links zurückgeben.

Diese API wurde abgeschaltet. Ohne sie kann Music Sharity schlicht nichts mehr umwandeln.

Warum nicht neu bauen?​

Der einzige realistische Weg, Odesli zu ersetzen, wäre, die Umwandlung auf Web-Scraping jeder einzelnen Streamingplattform aufzubauen. Das ist fragil, schwer zu warten und nichts, was ich für dieses Projekt verfolgen möchte.

Anstatt eine kaputte App am Leben zu halten, habe ich mich daher entschieden, die Entwicklung einzustellen und das Repository zu archivieren.

Auf der Suche nach einer Alternative?​

Wenn du Musik zwischen Streamingplattformen teilen möchtest, schau dir SongPort an. Es kann alles, was Music Sharity konnte, und das noch viel besser.

Was passiert mit dem Code?​

Der Code bleibt als Referenz auf GitHub verfügbar, unter der GPL v3-Lizenz. Du kannst ihn gerne durchstöbern, forken oder daraus lernen.

Einige Arbeiten nach dem Release 1.1.1 haben es nie in einen offiziellen Build geschafft, etwa die Seite mit dem Umwandlungsverlauf und einer unteren Navigationsleiste. Wenn du neugierig bist, findest du alles im Repository.

Danke​

Danke an alle, die Music Sharity ausprobiert, Probleme gemeldet oder Feedback gegeben haben. Es hat Spaß gemacht, dieses Projekt zu bauen, und ich habe dabei viel gelernt.

• Music Sharity auf GitHub (archiviert)
• SongPort

Was ist Roastgate?​

Roastgate ist eine Weboberfläche, die in einem Docker-Container neben deinem nginx läuft. Sie verwaltet Reverse Proxies, gehostete Sites, IP-Whitelists und Let's-Encrypt-Zertifikate, ohne jemals die nginx-eigenen Dateien zu verlassen.

Kein eigenes Format, keine versteckte Datenbank mit Konfigurationen: Roastgate liest und schreibt die normalen nginx-Dateien (conf.d/, sites-available/, sites-enabled/). Du kannst sie weiterhin von Hand bearbeiten und jederzeit aufhören, Roastgate zu nutzen. Deine Dateien bleiben, wo sie sind.

Was es verwaltet​

Ein sicherer Änderungszyklus​

Jede Änderung durchläuft denselben Zyklus:

Schreibvorgänge sind atomar (temporäre Datei, dann Umbenennung) und behalten die ursprünglichen Dateiberechtigungen bei. Die 30 neuesten Backups jeder Datei werden aufbewahrt, und auf der Seite Backups kannst du jede Version mit der aktuellen Datei vergleichen und wiederherstellen.

Funktionen​

Erstellungsassistent​

Beschreibe einen Reverse Proxy oder eine statische Site in einem Formular und Roastgate schreibt die nginx-Konfiguration: WebSockets, HTTPS mit optionaler Weiterleitung, HTTP/2, HSTS, Upload-Limit, Timeouts, Sicherheits-Header, Whitelists, die Let's-Encrypt-Challenge und freie Direktiven für alles andere. Ein Vorschau-Tab zeigt genau, was geschrieben wird.

• Sicher durch Konstruktion: Jeder Wert wird anhand eines strengen Musters geprüft, bevor er in die Datei gelangt.
• Kennt dein nginx: HTTP/2 wird ab nginx 1.25.1 als http2 on; geschrieben, davor als listen ... ssl http2;.
• Wieder öffnbar: Die Einstellungen werden in einem Kommentar am Anfang der generierten Datei gespeichert, sodass das erneute Öffnen das Formular wiederherstellt. Wenn du die Datei von Hand bearbeitet hast, warnt dich der Assistent, bevor er deine Änderungen ersetzt.

Import von handgeschriebenen Konfigurationen​

Du hast schon Konfigurationen? Öffne eine im Assistenten und ihre Einstellungen werden aus der Datei gelesen: Namen, Ports, Upstream, Zertifikat, Whitelists, Upload-Limit, WebSocket-Header, Timeouts, Weiterleitung. Alles, wofür das Formular kein Feld hat, bleibt als freie Direktiven erhalten, sodass nichts verloren geht.

Wenn eine Datei nicht originalgetreu reproduziert werden kann (ein upstream auf oberster Ebene, ein server_name als Regex, mehr als zwei Server-Blöcke …), wird sie mit Begründung abgelehnt und bleibt als Rohtext bearbeitbar.

Rohtext-Bearbeitung​

Jede Datei kann in einem Monaco-Editor mit nginx-Syntaxhervorhebung bearbeitet werden. Einen Proxy oder eine Site zu aktivieren oder zu deaktivieren, ist ein einziger Schalter.

Let's-Encrypt-Zertifikate​

Zertifikate auf der Seite Certificates beziehen, auflisten, erneuern und löschen.

• Nutze den eingebetteten certbot (im Image enthalten, von Roastgate zweimal täglich erneuert) oder den auf dem Host installierten.
• Zertifikate werden aus den Dateien gelesen, die certbot pflegt: Domains, Aussteller, Ablaufdatum und welche deiner Konfigurationen sie verwenden.
• nginx wird nur neu geladen, wenn sich ein Zertifikat wirklich geändert hat.
• Ein Dry Run prüft deine Domains zuerst gegen den Staging-Server von Let's Encrypt.
• Ein Zertifikat, das noch von einer Konfiguration verwendet wird, kann nicht gelöscht werden.

IP-Whitelists​

• Ein Listeneditor mit strenger Prüfung von IPv4, IPv6 und CIDR-Bereichen (10.0.0.5/24, das nginx stillschweigend ignoriert, wird markiert).
• Füge viele Adressen auf einmal ein, oder die Adresse, von der aus du verbunden bist, mit einem Klick.
• Jede Whitelist zeigt, wo sie verwendet wird, und eine noch eingebundene Whitelist kann nicht gelöscht werden.

Sicherheit​

Roastgate steuert deinen Webserver: Wer Roastgate kontrolliert, ist in der Praxis root auf dem Host. Deshalb hat die Sicherheit in dieser ersten Version viel Aufmerksamkeit bekommen.

• Zwei-Faktor-Authentifizierung (TOTP) mit jeder Authenticator-App und zehn Einmal-Wiederherstellungscodes.
• Passkeys: Anmeldung per Fingerabdruck, Gesicht, Geräte-PIN oder Sicherheitsschlüssel, allein oder als zweiter Schritt. Sobald ein Passkey existiert, reicht das Passwort allein nicht mehr aus.
• Rate Limiting: 5 Fehlversuche pro 15 Minuten und Client-Adresse.
• Widerruf von Sitzungen: Eine Passwortänderung beendet alle offenen Sitzungen auf allen Geräten.
• Audit-Log jeder Anmeldung und jedes Fehlversuchs.

Wie bekomme ich Roastgate?​

Voraussetzungen​

• Ein Linux-Server mit auf dem Host installiertem nginx (Debian- und Ubuntu-Verzeichnisstrukturen werden unterstützt)
• Docker mit dem Compose-Plugin
• Optional: certbot auf dem Host

Installation​

Du brauchst nur die Compose-Datei, nicht das ganze Repository. In einem Ordner deiner Wahl:

mkdir roastgate && cd roastgate
curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/ByteRoast/Roastgate/refs/heads/main/docker-compose.yml
docker compose up -d
docker logs roastgate        # gibt das Setup-Token aus

Oder mit PowerShell (pwsh):

New-Item -ItemType Directory roastgate | Set-Location
Invoke-WebRequest -Uri https://raw.githubusercontent.com/ByteRoast/Roastgate/refs/heads/main/docker-compose.yml -OutFile docker-compose.yml
docker compose up -d
docker logs roastgate        # gibt das Setup-Token aus

Das Image wird unter ghcr.io/byteroast/roastgate veröffentlicht. Um bei dieser Version zu bleiben, verwende in docker-compose.yml den Tag 0.1.0 statt latest.

Aus dem Quellcode bauen​

Um das Image selbst zu bauen, klone das Repository und baue es dort:

git clone https://github.com/ByteRoast/Roastgate.git
cd Roastgate
docker compose up -d --build

Entwicklungs-Image​

Du willst die neuesten Änderungen zuerst? docker-compose.dev.yml ist dieselbe Compose-Datei, festgelegt auf das dev-Image, das jedem Push auf den dev-Branch folgt. Lade sie als docker-compose.yml herunter, alle anderen Befehle bleiben gleich:

curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/ByteRoast/Roastgate/refs/heads/dev/docker-compose.dev.yml
docker compose pull
docker compose up -d

Invoke-WebRequest -Uri https://raw.githubusercontent.com/ByteRoast/Roastgate/refs/heads/dev/docker-compose.dev.yml -OutFile docker-compose.yml
docker compose pull
docker compose up -d

Erster Start​

Öffne http://127.0.0.1:8181 (von deinem eigenen Rechner aus liefert dir ssh -L 8181:127.0.0.1:8181 user@server diese Adresse) und folge der Einrichtung:

1. Gib das Setup-Token aus den Logs ein
2. Lege das Administratorkonto an
3. Wähle die Pfade und Optionen (nginx-Verzeichnis, Whitelist-Verzeichnis, ACME-Webroot, certbot-Modus)
4. Prüfe die Host-Diagnose
5. Fertig: Du wirst automatisch angemeldet

Update​

Aus dem Ordner, der docker-compose.yml enthält:

docker compose pull
docker compose up -d

Lade die Compose-Datei nur dann erneut herunter (derselbe curl- oder Invoke-WebRequest-Befehl wie oben), wenn die Release Notes sagen, dass sie sich geändert hat. Sie überschreibt deine Kopie, also wiederhole danach deine eigenen Anpassungen (Ports, Mounts, Setup-Token …). Wenn du aus dem Quellcode gebaut hast: git pull, dann docker compose up -d --build.

Deine Daten sichern​

Die Datenbank liegt im Volume roastgate-data, sodass dein Konto und deine Backups Updates und docker compose down überstehen. Nur docker compose down --volumes (oder docker volume rm roastgate-data) löscht es. Zum Sichern:

docker run --rm -v roastgate-data:/data -v "$PWD":/backup alpine tar czf /backup/roastgate-data.tgz -C /data .

Ausgesperrt?​

Passwort vergessen:

docker exec -it roastgate roastgate reset-password

Authenticator-App, Wiederherstellungscodes und Passkeys verloren:

docker exec roastgate roastgate disable-2fa

Das schaltet die Zwei-Faktor-Authentifizierung ab, entfernt alle Passkeys und beendet alle Sitzungen, sodass du dich wieder nur mit dem Passwort anmelden kannst.

Deinstallation​

docker compose down            # behält das Datenvolume
docker compose down --volumes  # löscht auch Konto, Einstellungen und Backup-Verlauf

Lösche dann den Ordner, der docker-compose.yml enthält, und das Image mit docker image rm ghcr.io/byteroast/roastgate:latest (oder dem Tag, den du verwendet hast). Deine nginx-Dateien bleiben, wo sie sind: Roastgate verschiebt sie nie.

Technische Details​

Roastgate ist mit .NET 10 und MudBlazor gebaut, mit BlazorMonaco für den Editor. Die Daten werden in SQLite gespeichert.

Der Container läuft privileged mit pid: host, damit er nginx und certbot über nsenter in den Namespaces des Hosts ausführen kann. Befehle werden nie über eine Shell ausgeführt.

Mitwirken​

Fehlerberichte, Ideen, Korrekturen an der Dokumentation und Code sind alle willkommen. Roastgate ist in der Alpha-Phase und wird nach bestem Bemühen gepflegt, Antworten können also ein paar Tage dauern.

• Einen Fehler gefunden oder ein Feature gewünscht? Eröffne ein Issue über die Issue-Formulare. Bei allem, was über eine kleine Korrektur hinausgeht, warte auf eine Antwort, bevor du Code schreibst.
• Du möchtest Code beitragen? Forke das Repository, erstelle deinen Branch von dev aus und öffne deinen Pull Request gegen dev, nicht main. Der Leitfaden für Beiträge behandelt Codestil, Tests, Commits und die Lizenzvereinbarung für Mitwirkende.

Lizenz​

Roastgate ist freie Open-Source-Software unter der Lizenz AGPL-3.0-or-later.

• Roastgate auf GitHub
• Release 0.1.0
• Probleme melden

Fehlerbehebung​

• Android: Abrufen der URL aus geteilten Inhalten korrigiert

Wie bekomme ich Music Sharity?​

Android​

• Google Play Store: Bei Google Play herunterladen
• Direkte APK: Herunterladen

Linux​

• DEB-Paket: Herunterladen für Debian/Ubuntu-basierte Distributionen
• RPM-Paket: Herunterladen für Fedora/RHEL-basierte Distributionen

Web (PWA)​

Probiere es direkt in deinem Browser aus unter music-sharity.byteroast.fr

Windows​

• Installer: Herunterladen

Das vollständige Release findest du auf der Release-Seite.

Was ist neu?​

SoundCloud-Unterstützung​

Music Sharity unterstützt jetzt SoundCloud!

Splashscreens​

Music Sharity hat jetzt Splashscreens. Diese Funktion wurde ursprünglich für die Web-App hinzugefügt, damit Nutzer nicht denken, die App würde nicht funktionieren. Es ist nicht wirklich eine Funktion, aber jetzt ist sie integriert.

Die Splashscreens erscheinen nur unter Android, iOS (wenn du es selbst baust) und im Web.

Bessere Erkennung von Tidal-Links​

Ich hatte übersehen, dass Tidal noch andere Links zum Teilen von Musik verwendet. Jetzt sollte es richtig funktionieren (hoffe ich).

Verbessertes Teilen auf Desktop und Web​

In den Desktop- und Web-Versionen wurde der Teilen-Button im letzten Schritt durch eine Funktion zum Kopieren in die Zwischenablage ersetzt. So lässt sich der umgewandelte Link einfacher und schneller teilen.

Fehlerbehebungen und Verbesserungen​

• Regulären Ausdruck (RegEx) für Tidal korrigiert, um Links besser zu erkennen
• Code-Refactoring für bessere Wartbarkeit

Wie bekomme ich Music Sharity?​

Android​

• Google Play Store: Bei Google Play herunterladen
• Direkte APK: Herunterladen

Linux​

• DEB-Paket: Herunterladen für Debian/Ubuntu-basierte Distributionen
• RPM-Paket: Herunterladen für Fedora/RHEL-basierte Distributionen

Web (PWA)​

Probiere es direkt in deinem Browser aus unter music-sharity.byteroast.fr

Windows​

• Installer: Herunterladen

Das vollständige Release findest du auf der Release-Seite.

Was ist Music Sharity?​

Music Sharity ist eine kostenlose Open-Source-App, mit der du Musik mühelos über verschiedene Streamingplattformen hinweg teilen kannst. Schluss mit dem Kopieren von Songtiteln oder der manuellen Suche in verschiedenen Diensten!

Warum gibt es diese App?​

Stell dir vor: Du entdeckst auf Spotify einen großartigen Song und möchtest ihn mit einem Freund teilen. Der nutzt aber Apple Music. Deine Optionen?

1. Ihm nur Titel und Interpret schicken (langweilig)
2. Apple Music öffnen, manuell suchen, den Link kopieren (anstrengend)
3. Music Sharity nutzen: sofortige Umwandlung!

Was kann man teilen?​

Aktuell unterstützt Music Sharity:

• Titel (einzelne Songs)
• Alben (einschließlich EPs und Singles)

Unterstützte Streamingplattformen​

Music Sharity funktioniert derzeit mit den 5 größten Streamingplattformen:

Für diese erste Version habe ich mich auf die beliebtesten Plattformen konzentriert. Weitere Plattformen könnten in Zukunft hinzukommen, abhängig von der Verfügbarkeit der APIs und dem Interesse der Community!

Wie bekomme ich Music Sharity?​

Music Sharity ist auf mehreren Plattformen verfügbar:

Web (PWA)​

Probiere es direkt in deinem Browser aus unter music-sharity.byteroast.fr

Du kannst es auf Android auch als Progressive Web App (PWA) installieren:

1. Öffne die Website in Chrome
2. Tippe auf „Installieren“ oder „Zum Startbildschirm hinzufügen“
3. Music Sharity erscheint in deinem Teilen-Menü!

Android​

• Google Play Store: Bei Google Play herunterladen
• Direkte APK: Download auf der GitHub-Releases-Seite

Windows​

• Installer: Download auf der GitHub-Releases-Seite

Linux​

• DEB-Paket: für Debian/Ubuntu-basierte Distributionen
• RPM-Paket: für Fedora/RHEL-basierte Distributionen

Beide findest du auf der GitHub-Releases-Seite.

Wie funktioniert es?​

Music Sharity nutzt die Odesli-API (auch bekannt als song.link), um Links zwischen Plattformen umzuwandeln. Odesli pflegt eine Datenbank der Musik aller großen Streamingdienste und kann Titel anhand verschiedener Kennungen wie ISRC-Codes zuordnen.

Der Umwandlungsprozess:

1. Den Quelllink an die Odesli-API senden
2. Alle verfügbaren Plattformlinks abrufen
3. Den umgewandelten Link für die gewählte Plattform anzeigen

Technische Details​

Music Sharity basiert auf zwei Grundprinzipien: Datenschutz und Transparenz.

Native Apps (Android, Windows, Linux)

• Direkte API-Aufrufe an Odesli
• Keine Zwischenstellen
• Keine Datenerhebung

Web-App (PWA)

• Datenschutzfreundlicher CORS-Proxy über Cloudflare Workers
• Kein Logging, kein Tracking
• Zustandslose Ausführung am Edge
• Open-Source-Code des Proxys

Gemeinsamkeiten

• Keine API-Schlüssel nötig
• Keine Erhebung von Nutzerdaten
• Kein Tracking, keine Analytics
• Vollständig Open Source (GPL v3)

Funktionen​

• Umwandlung zwischen 5 Plattformen (Spotify, Apple Music, YouTube Music, Deezer, Tidal)
• Unterstützung für Titel und Alben
• Schnelle Umwandlung dank Odesli
• Natives Teilen unter Android (erscheint im Teilen-Menü)
• Unterstützung als Progressive Web App
• Modernes dunkles Design mit Material Design 3
• Datenschutzfreundlich (kein Tracking, keine Analytics, keine Datenerhebung)
• Plattformübergreifend (Web, Android, Windows, Linux)

Warum „Music Sharity“?​

Der Name ist eine Mischung aus:

• Music (natürlich!)
• Share + Charity = Sharity

Die Idee ist, Musik plattformübergreifend im Geist von Großzügigkeit und Offenheit zu teilen.

Screenshots​

Wie geht es weiter?​

Folgendes ist für kommende Versionen geplant:

• Weitere Streamingplattformen
• Verlauf der Umwandlungen
• Anzeige der Albumcover
• Internationalisierung (Französisch, Deutsch)
• iOS-Unterstützung (Mitwirkende mit Mac gesucht)

Unser Datenschutzversprechen​

Music Sharity ist mit Datenschutz als Grundprinzip gebaut:

• Keine Benutzerkonten: einfach öffnen und loslegen
• Kein Tracking: keinerlei Analytics oder Telemetrie
• Keine Datenspeicherung: alles geschieht in Echtzeit
• Open Source: prüfe den Code selbst
• Transparente Infrastruktur: sogar unser Web-Proxy ist Open Source

Details findest du in unserer vollständigen Datenschutzerklärung.

Mitwirken​

Music Sharity ist Open Source (GPL v3). Beiträge sind willkommen, insbesondere für:

• iOS/macOS-Unterstützung (Mac-Besitzer gesucht)
• Web-Optimierungen
• Integration neuer Plattformen
• Fehlerbehebungen und Dokumentation

Wirf einen Blick in den Leitfaden für Beiträge, um loszulegen!

Continuous Integration​

Jeder Push wird automatisch auf allen Plattformen getestet:

Unsere CI-Pipeline stellt sicher, dass:

• die Android-APK erfolgreich gebaut wird
• die Web-App korrekt kompiliert
• die Windows-Anwendung ohne Fehler gebaut wird
• die Linux-Pakete (DEB/RPM) korrekt gebaut werden
• der Code die statische Analyse besteht

Probiere Music Sharity noch heute aus und teile deine Musik ganz mühelos!

• Web-App ausprobieren
• Auf GitHub herunterladen
• Dem Projekt einen Stern geben
• Probleme melden