1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/adguardhome_ynh.git synced 2024-09-03 18:06:23 +02:00

Add Android documentation

This commit is contained in:
tituspijean 2024-05-19 10:09:33 +02:00
parent e5f6048c53
commit 67698a548e
No known key found for this signature in database
GPG key ID: EF3B0D7CC0A94720
2 changed files with 44 additions and 2 deletions

View file

@ -2,7 +2,28 @@
## Android
To be completed by someone who uses an Android app, feel free to contribute!
### Built-in Private DNS
Android offers a Private DNS feature starting its version 9 and above.
This Private DNS setting will only work for DNS-over-TLS with Adguard Home, since DNS-over-HTTPS is limited to a couple of hardcoded providers.
Android being available under various flavours depending on your phone manufacturer, the location of that setting can vary.
It is generally along the lines of `Settings > Connections > More connections parameters > Private DNS`.
There, select "Hostname of the private DNS provider" and enter your Adguard Home's domain: `__DOMAIN__` (no protocol, no slash, only the domain).
### Intra
Intra by [Jigsaw Operations LLC](https://jigsaw.google.com) can be downloaded from [Google Play](https://play.google.com/store/apps/details?id=app.intra) or [F-Droid](https://f-droid.org/packages/app.intra/).
This free app can connect you to your Adguard Home server through DNS-over-HTTPS.
To configure it, once installed:
- Open its side menu `≡ → Parameters → Select a DNS over HTTPS menu`
- Choose `Custom URL server` and enter your server address:
- `https://__DOMAIN__/dns-query`
- If you want to track your device requests and use some per-device rules, replace [ClientID](https://github.com/AdguardTeam/AdGuardHome/wiki/Clients#clientid) in the following URL: `https://__DOMAIN__/dns-query/ClientID`,
- Go back to the main screen of the app, and enable the app with the top-right switch.
Technically, it creates a local VPN connection to enforce the use of your DNS server: a 🔑 icon will appear at the top of your screen once it is enabled.
## Apple devices

View file

@ -2,7 +2,28 @@
## Android
Doit être complété par quelqu'un qui utilise Android
### DNS privé intégré
Android propose une fonctionalité nommée **DNS privé** depuis sa version 9.
Ce paramètre **DNS privé** ne fonctionnera que pour *DNS-over-TLS*, car *DNS-over-HTTPS* n'est limité qu'à une paire de fournisseurs figés dans le code.
Android étant distribuée en de multiples variantes selon les fournisseurs d'appareils, l'emplacement de ce paramètre peut varier.
Il est peu ou prou placé dans `Paramètres → Connexions → Plus de paramètres de connexion → DNS privé`
Là, sélectionnez "Nom d'hôte du fournisseur DNS privé", et encodez le nom de domaine de votre serveur Adguard Home: `__DOMAIN__` (pas de protocole, pas de barre oblique, seulement le domaine).
### Intra
Intra par [Jigsaw Operations LLC](https://jigsaw.google.com) peut-être téléchargée depuis [Google Play](https://play.google.com/store/apps/details?id=app.intra) ou [F-Droid](https://f-droid.org/packages/app.intra/).
Cette application gratuite permet de vous connecter à votre serveur Adguard Home via *DNS-over-HTTPS*.
Pour la configurer, une fois installée :
- Ouvrez son menu latéral `≡ → Paramètres → Sélectionnez un serveur DNS over HTTPS`
- Choisissez `URL de serveur personnaliséer` et encodez votre URL :
- `https://__DOMAIN__/dns-query`
- Si vous souhaitez suivre les requêtes de votre appareil ou utiliser des règles personnalisées, remplacez [ClientID](https://github.com/AdguardTeam/AdGuardHome/wiki/Clients#clientid) dans l'URL suivante: `https://__DOMAIN__/dns-query/ClientID`,
- Retournez au menu principal de l'app, et activez-la avec l'interrupteur en haut à droite de l'écran.
Techniquement, elle créé une connexion VPN locale pour imposer l'usage de votre serveur DNS : une icône 🔑 apparaîtra en haut de votre écran, une fois activée.
## Appareils Apple