|
|
@@ -1,6 +1,6 @@
|
|
|
<!--
|
|
|
-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.
|
|
|
+Nota bene : ce README est automatiquement généré par <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
|
|
|
+Il NE doit PAS être modifié à la main.
|
|
|
-->
|
|
|
|
|
|
# Pi-hole pour YunoHost
|
|
|
@@ -9,104 +9,40 @@ It shall NOT be edited by hand.
|
|
|
|
|
|
[](https://install-app.yunohost.org/?app=pihole)
|
|
|
|
|
|
-*[Read this readme in english.](./README.md)*
|
|
|
+*[Lire le README dans d'autres langues.](./ALL_README.md)*
|
|
|
|
|
|
-> *Ce package vous permet d’installer Pi-hole 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.*
|
|
|
+> *Ce package vous permet d’installer Pi-hole rapidement et simplement sur un serveur YunoHost.*
|
|
|
+> *Si vous n’avez pas YunoHost, consultez [ce guide](https://yunohost.org/install) pour savoir comment l’installer et en profiter.*
|
|
|
|
|
|
## Vue d’ensemble
|
|
|
|
|
|
Pi-hole® est un puits DNS qui protège vos appareils des contenus indésirables sans installer de logiciel côté client.
|
|
|
|
|
|
|
|
|
-**Version incluse :** 5.14.2~ynh4
|
|
|
+**Version incluse :** 5.14.2~ynh4
|
|
|
|
|
|
## Captures d’écran
|
|
|
|
|
|
|
|
|
|
|
|
-## Avertissements / informations importantes
|
|
|
-
|
|
|
-## Configuration
|
|
|
-
|
|
|
-Utiliser le panneau d'administration de votre Pi-hole pour configurer cette application. Vous devrez peut-être aussi suivre le [guide de post-installation](https://docs.pi-hole.net/main/post-install/) pour configurer Pi-hole en tant que *serveur DNS* ou *serveur DHCP*.
|
|
|
-
|
|
|
-## Limitations
|
|
|
-
|
|
|
-* Activer DHCP avec Pi-hole nécessite une configuration manuelle de votre routeur.
|
|
|
-
|
|
|
-## Faire de Pi-hole votre serveur DHCP
|
|
|
-
|
|
|
-> **Attention, vous devez savoir que toucher à votre DHCP pourrait casser votre réseau.
|
|
|
-Dans le cas où votre serveur serait inaccessible, vous perdriez votre résolution dns et votre adresse IP.
|
|
|
-Ainsi, vous perdriez toute connexion à internet et même la connexion à votre routeur.**
|
|
|
-
|
|
|
-> **Si vous rencontrez ce genre de problèmes, merci de lire la section "Comment restaurer mon réseau" à la fin de ce document.**
|
|
|
-
|
|
|
-### Comment configurer Pi-hole
|
|
|
-
|
|
|
-Il y a 2 manière de configurer Pi-hole pour qu'il soit utilisé comme votre serveur DHCP.
|
|
|
-- Soit vous pouvez choisir de l'utiliser lorsque vous installez l'application.
|
|
|
-- Soit vous pouvez activer le serveur DHCP par la suite dans l'onglet "Settings", partie "Pi-hole DHCP Server".
|
|
|
-Dans ce second cas, il peut être préférable de forcer l'ip du serveur à une adresse statique.
|
|
|
-
|
|
|
-### Comment configurer mon routeur
|
|
|
-
|
|
|
-Votre routeur ou celui de votre FAI dispose d'un serveur DHCP activé par défaut.
|
|
|
-Si vous gardez ce DHCP, en même temps que celui de Pi-hole, vous allez avoir des conflits transparents entre eux.
|
|
|
-Le premier serveur DHCP à répondre va distribuer ses propres ip et paramètres.
|
|
|
-Donc vous devez éteindre le serveur DHCP de votre routeur et laisser Pi-hole gérer votre réseau.
|
|
|
-
|
|
|
-#### Pourquoi je devrais utiliser le DHCP de Pi-hole ?
|
|
|
-
|
|
|
-En utilisant le DHCP de Pi-hole, vous lui permettez de donner sa configuration dns à chacun de vos clients. De cette manière, chaque requête sera filtrée par Pi-hole.
|
|
|
-
|
|
|
-Un autre cas d'usage du DHCP de Pi-hole est le cas où vous rencontrez des problèmes de hairpinning (Vous ne pouvez pas vous connecter à votre serveur parce que son ip est votre ip publique, et votre routeur n'autorise pas cela).
|
|
|
-Dans ce cas, utilisez le dns de Pi-hole va vous permettre de vous connecter à votre serveur par son adresse locale plutôt que son adresse publique.
|
|
|
-
|
|
|
-### Comment restaurer mon réseau
|
|
|
-
|
|
|
-> Oups !
|
|
|
-Votre serveur Pi-hole est tombé, et vous n'avez plus de DHCP.
|
|
|
-Ne paniquez pas, on va surmonter ça \o/
|
|
|
-
|
|
|
-Utilisez votre terminal favori sur votre ordinateur de bureau.
|
|
|
-Et tout d'abord, récupérer votre interface réseau (Le plus souvent `eth0`).
|
|
|
-``` bash
|
|
|
-sudo ifconfig
|
|
|
-```
|
|
|
-
|
|
|
-Ensuite, changer votre ip pour une ip statique.
|
|
|
-``` bash
|
|
|
-sudo ifconfig eth0 192.168.1.100
|
|
|
-```
|
|
|
-
|
|
|
-Maintenant, vous pouvez vous connecter à votre routeur et rallumer son serveur DHCP pour l'utiliser à nouveau.
|
|
|
-Vous pouvez maintenant retirer votre ip statique et réobtenir une ip dynamique.
|
|
|
-``` bash
|
|
|
-sudo ifconfig eth0 0.0.0.0 && sudo dhclient eth0
|
|
|
-```
|
|
|
-
|
|
|
-> N'oubliez pas d'éteindre le DHCP de votre routeur si votre serveur fonctionne à nouveau.
|
|
|
-
|
|
|
## Documentations et ressources
|
|
|
|
|
|
-* Site officiel de l’app : <https://pi-hole.net/>
|
|
|
-* Documentation officielle de l’admin : <https://docs.pi-hole.net>
|
|
|
-* Dépôt de code officiel de l’app : <https://github.com/pi-hole/pi-hole>
|
|
|
-* YunoHost Store: <https://apps.yunohost.org/app/pihole>
|
|
|
-* Signaler un bug : <https://github.com/YunoHost-Apps/pihole_ynh/issues>
|
|
|
+- Site officiel de l’app : <https://pi-hole.net/>
|
|
|
+- Documentation officielle de l’admin : <https://docs.pi-hole.net>
|
|
|
+- Dépôt de code officiel de l’app : <https://github.com/pi-hole/pi-hole>
|
|
|
+- YunoHost Store : <https://apps.yunohost.org/app/pihole>
|
|
|
+- Signaler un bug : <https://github.com/YunoHost-Apps/pihole_ynh/issues>
|
|
|
|
|
|
## Informations pour les développeurs
|
|
|
|
|
|
-Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/pihole_ynh/tree/testing).
|
|
|
+Merci de faire vos pull request sur la [branche `testing`](https://github.com/YunoHost-Apps/pihole_ynh/tree/testing).
|
|
|
|
|
|
-Pour essayer la branche testing, procédez comme suit.
|
|
|
+Pour essayer la branche `testing`, procédez comme suit :
|
|
|
|
|
|
-``` bash
|
|
|
+```bash
|
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/pihole_ynh/tree/testing --debug
|
|
|
ou
|
|
|
sudo yunohost app upgrade pihole -u https://github.com/YunoHost-Apps/pihole_ynh/tree/testing --debug
|
|
|
```
|
|
|
|
|
|
-**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>
|
|
|
+**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>
|
yunohost-bot