Choisir la réponse faite aux visiteurs refusés​

Jusqu'ici, un proxy ou un site restreint par une liste blanche répondait à tous les autres avec le 403 Forbidden de nginx. Ça fonctionne, mais ça indique aussi au monde entier que quelque chose se cache derrière ce domaine.

L'onglet Access de l'assistant dispose maintenant d'un réglage Visitors outside the whitelists, aussi bien pour les reverse proxies que pour les sites hébergés :

Comme toujours, l'onglet d'aperçu montre exactement ce qui sera écrit. Avec un 404, la partie liste blanche de la configuration ressemble à ceci :

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

error_page 403 = @rg_denied;

location @rg_denied {
    allow all;
    return 404;
}

Quelques garde-fous l'accompagnent :

• Le réglage nécessite au moins une liste blanche : sans elle, personne n'est refusé et l'assistant vous le signale.
• L'adresse de redirection est validée avant d'arriver dans le fichier : http:// ou https://, un hôte, un port, un chemin et une query string optionnels, et rien qui puisse sortir de la ligne return.
• Le challenge Let's Encrypt reste accessible à tous, donc les renouvellements de certificats continuent de fonctionner quel que soit votre choix.

Réouverture et import​

Le réglage est relu depuis le fichier : rouvrir une configuration dans l'assistant, ou importer une configuration écrite à la main, restaure le choix et l'adresse de redirection. Si la ligne error_page 403 = @rg_denied; ou son bloc location @rg_denied a été modifié à la main en quelque chose que l'assistant ne sait pas reproduire, l'import est refusé avec le numéro de ligne et la raison, et le fichier reste modifiable en texte brut.

Pour les contributeurs​

Le projet a aussi reçu ce qu'il lui fallait pour accueillir des contributions :

• Un guide de contribution qui couvre le style de code, les tests, les commits et l'accord de licence des contributeurs.
• Une politique de sécurité pour signaler des vulnérabilités en privé.
• Des formulaires d'issue et un modèle de pull request.

L'image sur ghcr.io/byteroast/roastgate est désormais publique : plus besoin de docker login pour la récupérer.

Comment obtenir Roastgate 0.2.0 ?​

Mise à jour​

Depuis le dossier qui contient docker-compose.yml :

docker compose pull
docker compose up -d

Le fichier compose n'a perdu que deux commentaires dans cette version : inutile de le retélécharger.

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

Pour rester sur cette version, utilisez le tag 0.2.0 au lieu de latest dans docker-compose.yml.

Nouvelle installation​

Suivez le guide d'installation, ou l'article Présentation de Roastgate 0.1.0 : les étapes sont les mêmes.

• Roastgate sur GitHub
• Release 0.2.0
• Signaler un problème

Pourquoi ?​

Dès le premier jour, Music Sharity reposait entièrement sur l'API Odesli (aussi connue sous le nom de song.link) pour convertir les liens entre plateformes de streaming. Odesli faisait tout le gros du travail : faire correspondre les titres et les albums entre les services et renvoyer les liens correspondants.

Cette API a été fermée. Sans elle, Music Sharity ne peut tout simplement plus rien convertir.

Pourquoi ne pas le reconstruire ?​

La seule façon réaliste de remplacer Odesli serait de reconstruire le moteur de conversion en faisant du web scraping sur chaque plateforme de streaming. C'est fragile, difficile à maintenir, et ce n'est pas une voie que je souhaite suivre pour ce projet.

Plutôt que de maintenir en vie une application cassée, j'ai donc décidé d'arrêter le développement et d'archiver le dépôt.

Vous cherchez une alternative ?​

Si vous avez besoin de partager de la musique entre plateformes de streaming, essayez SongPort. Il fait tout ce que faisait Music Sharity, et bien mieux.

Que devient le code ?​

Le code reste disponible sur GitHub à titre de référence, sous licence GPL v3. N'hésitez pas à le parcourir, le forker ou vous en inspirer.

Une partie du travail réalisé après la version 1.1.1 n'a jamais été publiée dans une build officielle, comme la page d'historique des conversions avec une barre de navigation en bas. Tout est dans le dépôt si vous êtes curieux.

Merci​

Merci à toutes celles et ceux qui ont essayé Music Sharity, signalé des problèmes ou partagé leurs retours. C'était un projet amusant à construire, et j'ai beaucoup appris en chemin.

• Music Sharity sur GitHub (archivé)
• SongPort

Qu'est-ce que Roastgate ?​

Roastgate est une interface web qui tourne dans un conteneur Docker à côté de votre nginx. Elle gère les reverse proxies, les sites hébergés, les listes blanches d'IP et les certificats Let's Encrypt, sans jamais sortir des fichiers propres à nginx.

Pas de format maison, pas de base de configurations cachée : Roastgate lit et écrit les fichiers nginx classiques (conf.d/, sites-available/, sites-enabled/). Vous pouvez continuer à les modifier à la main, et arrêter d'utiliser Roastgate à tout moment. Vos fichiers restent là où ils sont.

Ce qu'elle gère​

Un cycle de modification sûr​

Chaque modification suit le même cycle :

Les écritures sont atomiques (fichier temporaire, puis renommage) et conservent les permissions d'origine du fichier. Les 30 sauvegardes les plus récentes de chaque fichier sont conservées, et la page Backups permet de comparer n'importe quelle version avec le fichier actuel et de la restaurer.

Fonctionnalités​

Assistant de création​

Décrivez un reverse proxy ou un site statique dans un formulaire et Roastgate écrit la configuration nginx : WebSockets, HTTPS avec redirection optionnelle, HTTP/2, HSTS, limite d'upload, timeouts, en-têtes de sécurité, listes blanches, challenge Let's Encrypt, et directives libres pour tout le reste. Un onglet d'aperçu montre exactement ce qui sera écrit.

• Sûr par construction : chaque valeur est validée par un motif strict avant d'arriver dans le fichier.
• Adapté à votre nginx : HTTP/2 est écrit sous la forme http2 on; à partir de nginx 1.25.1, et listen ... ssl http2; avant.
• Réouvrable : les réglages sont stockés dans un commentaire en tête du fichier généré, donc le rouvrir restaure le formulaire. Si vous avez modifié le fichier à la main, l'assistant vous prévient avant d'écraser vos changements.

Import de configurations écrites à la main​

Vous avez déjà des configurations ? Ouvrez-en une dans l'assistant et ses réglages sont lus depuis le fichier : noms, ports, upstream, certificat, listes blanches, limite d'upload, en-têtes WebSocket, timeouts, redirection. Tout ce qui n'a pas de champ dans le formulaire est conservé en directives libres, donc rien n'est perdu.

Lorsqu'un fichier ne peut pas être reproduit fidèlement (un upstream au niveau racine, un server_name en regex, plus de deux blocs server…), il est refusé avec la raison et reste modifiable en texte brut.

Édition brute​

Chaque fichier peut être modifié dans un éditeur Monaco avec coloration syntaxique nginx. Activer ou désactiver un proxy ou un site se fait d'un simple interrupteur.

Certificats Let's Encrypt​

Obtenez, listez, renouvelez et supprimez des certificats depuis la page Certificates.

• Utilisez le certbot intégré (livré dans l'image, renouvelé deux fois par jour par Roastgate) ou celui installé sur l'hôte.
• Les certificats sont lus depuis les fichiers que maintient certbot : domaines, émetteur, expiration, et lesquelles de vos configurations les utilisent.
• nginx n'est rechargé que lorsqu'un certificat a réellement changé.
• Un dry run valide d'abord vos domaines auprès du serveur de staging de Let's Encrypt.
• Un certificat encore utilisé par une configuration ne peut pas être supprimé.

Listes blanches d'IP​

• Un éditeur de liste avec validation stricte des adresses IPv4, IPv6 et des plages CIDR (10.0.0.5/24, que nginx ignore silencieusement, est signalé).
• Collez de nombreuses adresses d'un coup, ou ajoutez celle depuis laquelle vous êtes connecté en un clic.
• Chaque liste blanche indique où elle est utilisée, et une liste encore incluse ne peut pas être supprimée.

Sécurité​

Roastgate contrôle votre serveur web : quiconque contrôle Roastgate est, en pratique, root sur l'hôte. La sécurité a donc reçu beaucoup d'attention pour cette première version.

• Authentification à deux facteurs (TOTP) avec n'importe quelle application d'authentification, et dix codes de récupération à usage unique.
• Passkeys : connectez-vous avec une empreinte digitale, votre visage, le code PIN de l'appareil ou une clé de sécurité, seules ou comme second facteur. Dès qu'une passkey existe, le mot de passe seul ne suffit plus.
• Limitation de débit : 5 échecs par tranche de 15 minutes et par adresse client.
• Révocation des sessions : changer le mot de passe met fin à toutes les sessions ouvertes, sur tous les appareils.
• Journal d'audit de chaque connexion et de chaque échec.

Comment obtenir Roastgate ?​

Prérequis​

• Un serveur Linux avec nginx installé sur l'hôte (les arborescences Debian et Ubuntu sont prises en charge)
• Docker avec le plugin Compose
• Optionnel : certbot sur l'hôte

Installation​

Vous n'avez besoin que du fichier compose, pas du dépôt entier. Dans le dossier de votre choix :

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        # affiche le jeton d'installation

Ou avec 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        # affiche le jeton d'installation

L'image est publiée sur ghcr.io/byteroast/roastgate. Pour rester sur cette version, utilisez le tag 0.1.0 au lieu de latest dans docker-compose.yml.

Compiler depuis les sources​

Pour construire l'image vous-même, clonez le dépôt et construisez-la depuis celui-ci :

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

Image de développement​

Vous voulez les dernières nouveautés en avant-première ? docker-compose.dev.yml est le même fichier compose, épinglé sur l'image dev, qui suit chaque push sur la branche dev. Téléchargez-le sous le nom docker-compose.yml et toutes les autres commandes restent identiques :

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

Premier démarrage​

Ouvrez http://127.0.0.1:8181 (depuis votre propre machine, ssh -L 8181:127.0.0.1:8181 user@server vous donne cette adresse) et suivez l'installation :

1. Saisissez le jeton d'installation affiché dans les logs
2. Créez le compte administrateur
3. Choisissez les chemins et options (répertoire nginx, répertoire des listes blanches, webroot ACME, mode certbot)
4. Vérifiez les diagnostics de l'hôte
5. Terminé : vous êtes connecté automatiquement

Mise à jour​

Depuis le dossier qui contient docker-compose.yml :

docker compose pull
docker compose up -d

Ne retéléchargez le fichier compose (même commande curl ou Invoke-WebRequest que ci-dessus) que lorsque les notes de version indiquent qu'il a changé. Il écrase votre copie, donc refaites vos propres modifications ensuite (ports, montages, jeton d'installation…). Si vous avez compilé depuis les sources : git pull, puis docker compose up -d --build.

Sauvegarder vos données​

La base de données se trouve dans le volume roastgate-data, donc votre compte et vos sauvegardes survivent aux mises à jour et à docker compose down. Seul docker compose down --volumes (ou docker volume rm roastgate-data) le supprime. Pour le sauvegarder :

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

Accès bloqué ?​

Mot de passe oublié :

docker exec -it roastgate roastgate reset-password

Application d'authentification, codes de récupération et passkeys perdus :

docker exec roastgate roastgate disable-2fa

Cette commande désactive l'authentification à deux facteurs, supprime toutes les passkeys et met fin à toutes les sessions, de sorte que le mot de passe seul permet à nouveau de se connecter.

Désinstallation​

docker compose down            # conserve le volume de données
docker compose down --volumes  # supprime aussi le compte, les réglages et l'historique des sauvegardes

Supprimez ensuite le dossier qui contient docker-compose.yml, et l'image avec docker image rm ghcr.io/byteroast/roastgate:latest (ou le tag que vous avez utilisé). Vos fichiers nginx restent là où ils sont : Roastgate ne les déplace jamais.

Détails techniques​

Roastgate est construite avec .NET 10 et MudBlazor, avec BlazorMonaco pour l'éditeur. Les données sont stockées dans SQLite.

Le conteneur tourne en mode privileged avec pid: host, afin de pouvoir exécuter nginx et certbot dans les namespaces de l'hôte via nsenter. Les commandes ne passent jamais par un shell.

Contribuer​

Les rapports de bugs, les idées, les corrections de documentation et le code sont tous les bienvenus. Roastgate est en alpha et maintenue au mieux, donc les réponses peuvent prendre quelques jours.

• Vous avez trouvé un bug ou voulez une fonctionnalité ? Ouvrez une issue avec les formulaires d'issue. Pour tout ce qui dépasse un petit correctif, attendez une réponse avant d'écrire du code.
• Vous voulez contribuer du code ? Forkez le dépôt, créez votre branche depuis dev et ouvrez votre pull request vers dev, pas main. Le guide de contribution couvre le style de code, les tests, les commits et l'accord de licence des contributeurs.

Licence​

Roastgate est libre et open source, sous licence AGPL-3.0-or-later.

• Roastgate sur GitHub
• Release 0.1.0
• Signaler un problème

Correction de bug​

• Android : correction de la récupération de l'URL depuis le contenu partagé

Comment obtenir Music Sharity ?​

Android​

• Google Play Store : Télécharger sur Google Play
• APK direct : Télécharger

Linux​

• Paquet DEB : Télécharger pour les distributions basées sur Debian/Ubuntu
• Paquet RPM : Télécharger pour les distributions basées sur Fedora/RHEL

Web (PWA)​

Essayez-la directement dans votre navigateur sur music-sharity.byteroast.fr

Windows​

• Installeur : Télécharger

Retrouvez la release complète sur la page de release.

Quoi de neuf ?​

Prise en charge de SoundCloud​

Music Sharity prend désormais en charge SoundCloud !

Écrans de démarrage​

Music Sharity dispose maintenant d'écrans de démarrage. Cette fonctionnalité a d'abord été ajoutée pour l'application web, afin que les utilisateurs ne pensent pas que l'application ne fonctionne pas. Ce n'est pas vraiment une fonctionnalité, mais c'est désormais intégré.

Les écrans de démarrage n'apparaissent que sur Android, iOS (si vous le compilez vous-même) et le Web.

Meilleure reconnaissance des liens Tidal​

J'avais oublié que Tidal propose d'autres formats de liens pour partager de la musique. Ça devrait donc fonctionner correctement (je l'espère).

Partage amélioré sur Desktop et Web​

Sur les versions Desktop et Web, le bouton de partage de la dernière étape a été remplacé par une fonction de copie dans le presse-papiers. Partager le lien converti est ainsi plus simple et plus rapide.

Corrections de bugs et améliorations​

• Correction de l'expression régulière (RegEx) Tidal pour une meilleure reconnaissance des liens
• Refactorisation du code pour une meilleure maintenabilité

Comment obtenir Music Sharity ?​

Android​

• Google Play Store : Télécharger sur Google Play
• APK direct : Télécharger

Linux​

• Paquet DEB : Télécharger pour les distributions basées sur Debian/Ubuntu
• Paquet RPM : Télécharger pour les distributions basées sur Fedora/RHEL

Web (PWA)​

Essayez-la directement dans votre navigateur sur music-sharity.byteroast.fr

Windows​

• Installeur : Télécharger

Retrouvez la release complète sur la page de release.

Qu'est-ce que Music Sharity ?​

Music Sharity est une application libre et open source qui vous permet de partager de la musique entre différentes plateformes de streaming sans effort. Fini le copier-coller de titres ou les recherches manuelles sur chaque service !

Pourquoi cette application existe-t-elle ?​

Imaginez : vous découvrez une chanson géniale sur Spotify et vous voulez la partager avec un ami. Mais il utilise Apple Music. Vos options ?

1. Lui envoyer juste le titre et l'artiste (ennuyeux)
2. Ouvrir Apple Music, chercher manuellement, copier le lien (épuisant)
3. Utiliser Music Sharity : conversion instantanée !

Que peut-on partager ?​

Actuellement, Music Sharity prend en charge :

• Les titres (morceaux individuels)
• Les albums (y compris les EP et les singles)

Plateformes de streaming prises en charge​

Music Sharity fonctionne actuellement avec les 5 principales plateformes de streaming :

Pour cette première version, je me suis concentré sur les plateformes les plus populaires. D'autres pourront être ajoutées à l'avenir, selon la disponibilité des API et l'intérêt de la communauté !

Comment obtenir Music Sharity ?​

Music Sharity est disponible sur plusieurs plateformes :

Web (PWA)​

Essayez-la directement dans votre navigateur sur music-sharity.byteroast.fr

Vous pouvez aussi l'installer comme Progressive Web App (PWA) sur Android :

1. Ouvrez le site dans Chrome
2. Appuyez sur « Installer » ou « Ajouter à l'écran d'accueil »
3. Music Sharity apparaîtra dans votre menu de partage !

Android​

• Google Play Store : Télécharger sur Google Play
• APK direct : téléchargez-le depuis la page des releases GitHub

Windows​

• Installeur : téléchargez-le depuis la page des releases GitHub

Linux​

• Paquet DEB : pour les distributions basées sur Debian/Ubuntu
• Paquet RPM : pour les distributions basées sur Fedora/RHEL

Les deux sont disponibles sur la page des releases GitHub.

Comment ça marche ?​

Music Sharity utilise l'API Odesli (aussi connue sous le nom de song.link) pour convertir les liens entre plateformes. Odesli maintient une base de données de la musique présente sur tous les grands services de streaming et peut faire correspondre les titres grâce à divers identifiants comme les codes ISRC.

Le processus de conversion :

1. Envoi du lien source à l'API Odesli
2. Récupération de tous les liens disponibles par plateforme
3. Affichage du lien converti pour la plateforme choisie

Détails techniques​

Music Sharity repose sur deux principes fondamentaux : la confidentialité et la transparence.

Applications natives (Android, Windows, Linux)

• Appels directs à l'API Odesli
• Aucun intermédiaire
• Aucune collecte de données

Application web (PWA)

• Proxy CORS respectueux de la vie privée via Cloudflare Workers
• Aucun log, aucun pistage
• Exécution en edge, sans état
• Code du proxy open source

Points communs

• Aucune clé d'API requise
• Aucune collecte de données utilisateur
• Aucun pistage ni analytics
• Entièrement open source (GPL v3)

Fonctionnalités​

• Conversion entre 5 plateformes (Spotify, Apple Music, YouTube Music, Deezer, Tidal)
• Prise en charge des titres et des albums
• Conversion rapide grâce à Odesli
• Partage natif sur Android (apparaît dans le menu de partage)
• Prise en charge en tant que Progressive Web App
• Thème sombre moderne avec Material Design 3
• Respect de la vie privée (pas de pistage, pas d'analytics, pas de collecte de données)
• Multiplateforme (Web, Android, Windows, Linux)

Pourquoi « Music Sharity » ?​

Le nom est un mélange de :

• Music (évidemment !)
• Share + Charity = Sharity

L'idée est de partager la musique entre les plateformes dans un esprit de générosité et d'ouverture.

Captures d'écran​

Et ensuite ?​

Voici ce qui est prévu pour les prochaines versions :

• D'autres plateformes de streaming
• Historique des conversions
• Affichage des pochettes d'album
• Internationalisation (français, allemand)
• Prise en charge d'iOS (contributeurs avec un Mac recherchés)

Engagement sur la confidentialité​

Music Sharity est conçue avec la confidentialité comme principe fondamental :

• Pas de compte utilisateur : il suffit d'ouvrir l'application
• Pas de pistage : aucune analytics ni télémétrie
• Pas de stockage de données : tout se passe en temps réel
• Open source : auditez le code vous-même
• Infrastructure transparente : même notre proxy web est open source

Consultez notre politique de confidentialité complète pour plus de détails.

Contribuer​

Music Sharity est open source (GPL v3). Les contributions sont les bienvenues, en particulier pour :

• La prise en charge d'iOS/macOS (propriétaires de Mac recherchés)
• Les optimisations web
• L'intégration de nouvelles plateformes
• Les corrections de bugs et la documentation

Consultez le guide de contribution pour commencer !

Intégration continue​

Chaque push est automatiquement testé sur toutes les plateformes :

Notre pipeline de CI garantit que :

• L'APK Android se compile correctement
• L'application web se compile correctement
• L'exécutable Windows se compile sans erreur
• Les paquets Linux (DEB/RPM) se construisent correctement
• Le code passe l'analyse statique

Essayez Music Sharity dès aujourd'hui et partagez votre musique sans effort !

• Essayer l'application web
• Télécharger sur GitHub
• Mettre une étoile au projet
• Signaler un problème