reverseproxy_ynh/README_fr.md

89 lines
4.9 KiB
Markdown
Raw Normal View History

2021-06-04 16:26:21 +02:00
# Redirect pour YunoHost
[![Niveau d'intégration](https://dash.yunohost.org/integration/redirect.svg)](https://dash.yunohost.org/appci/app/redirect) ![](https://ci-apps.yunohost.org/ci/badges/redirect.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/redirect.maintain.svg)
[![Installer Redirect avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=redirect)
*[Read this readme in english.](./README.md)*
*[Lire ce readme en français.](./README_fr.md)*
> *Ce package vous permet d'installer Redirect rapidement et simplement sur un serveur YunoHost.
Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.*
## Vue d'ensemble
Créer une redirection ou un proxy vers un autre emplacement
**Version incluse :** 1.0.0~ynh5
## Avertissements / informations importantes
2021-08-22 08:58:24 +02:00
**Ajoutez un lien sur votre panneau d'utilisateur redirigeant vers une autre page ou application, qui peut être protégée derrière votre panneau pour certains**.
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
Il peut s'agir d'une redirection invisible, d'un lien externe, d'une autre application sur votre réseau local, d'un reverse proxy vers une application ou un conteneur Docker... Certaines applications peuvent même être protégées derrière votre panneau (ce qui signifie que vous devrez vous connecter- pour y accéder). La seule limite est votre imagination - et NGINX ;).
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
Cette application ajoute uniquement un fichier de configuration NGINX avec la règle `redirect` ou `proxy_pass` et une tuile YunoHost. Rien de plus.
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
## Type de redirection
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
### Redirection visible
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
La barre d'adresse du visiteur va changer. Utile pour ajouter un lien utilisateur vers un autre site Web
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
votre-domaine.com -> autre-domaine.net
vous-domaine.com/foo -> autre-domaine.net/bar
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
### Redirection invisible (proxy)
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
La barre d'adresse du visiteur restera la même. Principalement utilisé pour servir le serveur Web local pour une application personnelle.
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
vous-domaine.com/foo -> http://172.0.0.1:8080/app
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
**IMPORTANT :** le fichier `redirect.conf` devra peut-être être mis à jour en fonction de votre situation !
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
**AVERTISSEMENT :** De nombreuses applications ne prennent pas en charge la redirection vers un chemin différent en raison de liens relatifs ! Cela signifie que certaines applications hébergées par exemple sur http://127.0.0.1:5050/app/ DOIVENT être redirigées vers http://domain.tld/app/ et NON vers http://domain.tld/someotherapp/
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
*Exemple concret :* le conteneur Odoo Docker fonctionne sur http://127.0.0.1:8069/. Vous ne pourrez pas le rediriger vers http://domain.tld/odoo/ ! Il faut le rediriger vers la racine, donc par exemple http://odoo.domain.tld/
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
## Redirection publique ou privée
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
En cas de redirection privée, l'application sera disponible uniquement pour les utilisateurs connectés. Cela peut être utile si vous souhaitez protéger derrière le SSO une application de votre réseau local ou du serveur (par exemple, un conteneur Docker ou une application qui n'a pas de gestion des utilisateurs ou de protection par mot de passe).
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
**IMPORTANT :** Assurez-vous que l'application que vous souhaitez protéger NE PEUT PAS être accessible via son port ou un autre lien direct. Sinon, votre application ne sera protégée que dans YunoHost mais sera toujours disponible via son lien direct. Dans le cas d'un conteneur Docker, le port du conteneur devra être local (par exemple, -p 127.0.0.1:9000:9000).
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
## Exemples de cas
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
- **Création d'une tuile pour un conteneur Docker** avec un port local (par exemple, -p 127.0.0.1:PORT:PORT) : redirection proxy vers http://127.0.0.1:PORT-OF-THE-CONTAINER/
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
- **Redirection vers un site externe** : redirection visible vers l'URL
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
- [CozyCloud derrière YunoHost ?](https://forum.cozy.io/t/cozy-cloud-sous-yunohost/616/11)
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
- **Créer une vignette et protéger les applications difficiles à packager nativement (ou pour le prototypage)**
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
**_N'hésitez pas à [partager vos exemples de cas et vos fichiers Nginx personnalisés sur le forum](https://forum.yunohost.org/t/2182)._**
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
## Crédits
2021-06-04 16:26:21 +02:00
2021-08-22 08:58:24 +02:00
Inspiré du travail de [scith](https://github.com/scith).
2021-06-04 16:26:21 +02:00
## Documentations et ressources
* Site officiel de l'app : https://github.com/YunoHost-Apps/redirect_ynh
* Documentation YunoHost pour cette app : https://yunohost.org/app_redirect
* Signaler un bug : https://github.com/YunoHost-Apps/redirect_ynh/issues
## Informations pour les développeurs
Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/redirect_ynh/tree/testing).
Pour essayer la branche testing, procédez comme suit.
```
sudo yunohost app install https://github.com/YunoHost-Apps/redirect_ynh/tree/testing --debug
ou
sudo yunohost app upgrade redirect -u https://github.com/YunoHost-Apps/redirect_ynh/tree/testing --debug
```
**Plus d'infos sur le packaging d'applications :** https://yunohost.org/packaging_apps