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:
parent
e5f6048c53
commit
67698a548e
2 changed files with 44 additions and 2 deletions
23
doc/APPS.md
23
doc/APPS.md
|
@ -2,7 +2,28 @@
|
||||||
|
|
||||||
## Android
|
## 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
|
## Apple devices
|
||||||
|
|
||||||
|
|
|
@ -2,7 +2,28 @@
|
||||||
|
|
||||||
## Android
|
## 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
|
## Appareils Apple
|
||||||
|
|
||||||
|
|
Loading…
Add table
Reference in a new issue