reverseproxy_ynh/README_fr.md

63 lines
3.7 KiB
Markdown
Raw Permalink Normal View History

2022-06-05 16:08:00 +02:00
<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
2023-01-08 14:33:31 +01:00
# Reverse Proxy pour YunoHost
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
[![Niveau d'intégration](https://dash.yunohost.org/integration/reverseproxy.svg)](https://dash.yunohost.org/appci/app/reverseproxy) ![Statut du fonctionnement](https://ci-apps.yunohost.org/ci/badges/reverseproxy.status.svg) ![Statut de maintenance](https://ci-apps.yunohost.org/ci/badges/reverseproxy.maintain.svg)
[![Installer Reverse Proxy avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=reverseproxy)
2021-06-04 16:26:21 +02:00
*[Read this readme in english.](./README.md)*
2023-01-08 14:33:31 +01:00
> *Ce package vous permet d'installer Reverse Proxy rapidement et simplement sur un serveur YunoHost.
2021-06-04 16:26:21 +02:00
Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.*
## Vue d'ensemble
2023-01-08 14:33:31 +01:00
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.
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
Les backends supportés sont:
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
- HTTP en clair (plaintext) vers localhost (127.x.x.x)
- HTTPS vers n'importe quelle destination
- fichier socket sur disque local
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
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).
2022-08-16 23:30:29 +02:00
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
**Version incluse :** 0.1~ynh1
## Avertissements / informations importantes
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
### Chemin web du backend
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
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/`.
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
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.
2021-06-04 16:26:21 +02:00
2023-01-08 14:33:31 +01:00
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é.
2021-06-04 16:26:21 +02:00
2023-01-09 12:41:40 +01:00
### 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.
2021-06-04 16:26:21 +02:00
## Documentations et ressources
2023-01-08 14:33:31 +01:00
* Site officiel de l'app : <https://en.wikipedia.org/wiki/Reverse_proxy>
* Documentation YunoHost pour cette app : <https://yunohost.org/app_reverseproxy>
* Signaler un bug : <https://github.com/YunoHost-Apps/reverseproxy_ynh/issues>
2021-06-04 16:26:21 +02:00
## Informations pour les développeurs
2023-01-08 14:33:31 +01:00
Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/reverseproxy_ynh/tree/testing).
2021-06-04 16:26:21 +02:00
Pour essayer la branche testing, procédez comme suit.
2022-06-05 16:08:00 +02:00
``` bash
2023-01-08 14:33:31 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/reverseproxy_ynh/tree/testing --debug
2021-06-04 16:26:21 +02:00
ou
2023-01-08 14:33:31 +01:00
sudo yunohost app upgrade reverseproxy -u https://github.com/YunoHost-Apps/reverseproxy_ynh/tree/testing --debug
2021-06-04 16:26:21 +02:00
```
2022-06-05 16:08:00 +02:00
**Plus d'infos sur le packaging d'applications :** <https://yunohost.org/packaging_apps>