3.7 KiB
Reverse Proxy pour YunoHost
Ce package vous permet d’installer Reverse Proxy rapidement et simplement sur un serveur YunoHost. Si vous n’avez pas YunoHost, regardez ici pour savoir comment l’installer et en profiter.
Vue d’ensemble
Cette application permet de configurer un reverse proxy HTTP(S) pour servir un autre service web, ainsi qu'un dossier (optionnel) pour les assets statiques qui sera servi directement depuis nginx. L'application apparaît comme tuile dans le panel SSOWat, sauf si elle a été configurée autrement après l'installation. L'accès à l'application peut être rendu public.
Les backends supportés sont:
- HTTP en clair (plaintext) vers localhost (127.x.x.x)
- HTTPS vers n'importe quelle destination
- fichier socket sur disque local
Attention, SSOWat envoie les identifiants des utilisateurices en clair jusqu'au backend, donc n'utilisez pas cette application pour reverse-proxy un service dans lequel vous n'avez pas confiance (par exemple pour mirrorer un site hébergé par une autre personne).
Version incluse : 0.2~ynh2
Avertissements / informations importantes
Chemin web du backend
La requête est transmise telle-quelle au serveur backend. Cela veut usuellement dire que le service backend doit avoir connaissance du chemin web utilisé pour accéder au service. Par exemple, si l'application est installée sur example.com/proxy, votre application backend devrait produire des liens absolus commençant par example.com/proxy/.
Pour supporter les URLs relatives depuis le backend, accéder à l'application via http(s)://example.com/proxy produit une redirection permanente (302) vers http(s)://example.com/proxy/ (avec le slash de fin). Sinon, un lien relatif comme <link rel="stylesheet" href="style.css"> essayerait de charger http(s)://example.com/style.css, ce qui échouerait.
Il est possible que votre service backend ne supporte pas de configurer une "base URL" (chemin web personnalisé). Dans ce cas, il faudra installer l'application sur un (sous-)domaine dédié.
Backend localhost en clair (plaintext)
Les connexions en clair en HTTP au backend ne sont autorisées qu'en localhost sur les adresses 127.X.X.X. Il faudrait aussi supporter 10.X.X.X.
Documentations et ressources
- Site officiel de l’app : https://en.wikipedia.org/wiki/Reverse_proxy
- YunoHost Store: https://apps.yunohost.org/app/reverseproxy
- Signaler un bug : https://github.com/YunoHost-Apps/reverseproxy_ynh/issues
Informations pour les développeurs
Merci de faire vos pull request sur la branche testing.
Pour essayer la branche testing, procédez comme suit.
sudo yunohost app install https://github.com/YunoHost-Apps/reverseproxy_ynh/tree/testing --debug
ou
sudo yunohost app upgrade reverseproxy -u https://github.com/YunoHost-Apps/reverseproxy_ynh/tree/testing --debug
Plus d’infos sur le packaging d’applications : https://yunohost.org/packaging_apps