mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Update some pages following 3.8 release with new diagnosis system
This commit is contained in:
Alexandre Aubin
parent
7ad8c9700d
commit
4f69cdfbb5
4 changed files with 26 additions and 114 deletions
|
|
@ -1,53 +1,10 @@
|
|||
# Diagnose YunoHost functioning
|
||||
|
||||
If you have successfully [installed](/install) YunoHost and passed through the [post-installation](/postinstall), you probably have a **working server**.
|
||||
To diagnose that all critical aspects of your server are properly configured,
|
||||
you should run a diagnosis from the webadmin in the "Diagnosis" section. (This
|
||||
feature was added in Yunohost 3.8).
|
||||
|
||||
### <small>1.</small> Test it
|
||||
|
||||
In a web browser, access to your server via the domain name you just entered at the post-installation step.
|
||||
|
||||
For example: `http://mydomain.com`
|
||||
|
||||
|
||||
<div class="alert alert-warning">
|
||||
If you have taken a <b>.nohost.me</b> or a <b>.noho.st</b> domain, you may have to wait 5 min before the address is reachable.
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
#### If that does not work...
|
||||
|
||||
---
|
||||
|
||||
### <small>2.</small> Have you configured your DNS well ?
|
||||
|
||||
<div class="alert alert-info">
|
||||
This step is not necessary if you have a <b>.nohost.me</b> or a <b>.noho.st</b> domain
|
||||
</div>
|
||||
|
||||
Go to https://www.whatsmydns.net/ , enter your domain name in the field and click `Search`.
|
||||
If you do not see your IP address, or if there are red crosses everywhere, then you have probably misconfigured your [DNS](/dns).
|
||||
|
||||
---
|
||||
|
||||
### <small>3.</small> Are network ports opened on your router ?
|
||||
|
||||
If your DNS is properly configured, and your server is accessible locally, you may have **network ports blocked** or it may not be forwarded by your router.
|
||||
In order to verify this, try accessing your server with a client outside your local network. For example via another WiFi access point or with your mobile phone in 3G/4G.
|
||||
|
||||
If the server is unreachable from outside your local network too, then the problem probably comes from your router's configuration.
|
||||
|
||||
<div class="alert alert-info">
|
||||
Try to activate uPnP in your router's configuration interface, and check that your server is plugged in Ethernet directly behind it.
|
||||
<p>
|
||||
You can also redirect ports manually to your server's local IP address on the router's configuration interface.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
### <small>4.</small> Does your router have hairpinning ?
|
||||
|
||||
If the server is accessible from outside your local network, but unreachable with its domain name on the local network, then your router probably lacks <a href="https://en.wikipedia.org/wiki/Hairpinning" target="_blank">hairpinning</a>.
|
||||
|
||||
Here is a [tutorial](dns_local_network) to access your server on a local network and bypass the hairpinning problem. The tutorial proposes a first solution to create a redirection with DNS of the ISP box and a second solution to modify the `hosts` file of the **clients** to instruct it to access the **server** via its local IP address. The first solution is preferable because it's not necessary to modify the `hosts` files on every computer on your local network, if you are using many different clients.
|
||||
TODO: elaborate on the fact that the diagnosis runs periodically, sends an email
|
||||
to root which is forwarded to the very first user created, and that issues
|
||||
should either be fixed or ignored (if they are understood/not relevant)
|
||||
otherwise an email will be sent twice a day..
|
||||
|
|
|
|||
|
|
@ -1,55 +1,12 @@
|
|||
# Diagnostic du bon fonctionnement de YunoHost
|
||||
|
||||
Si vous avez réussi l’[installation](/install) de YunoHost et passé l’étape de [post-installation](/postinstall), vous avez probablement un **serveur fonctionnel**.
|
||||
Pour vérifier que tous les aspects critiques de votre serveur sont correctement
|
||||
configurés, il est recommandé d'utiliser le système de diagnostic disponible
|
||||
dans la webadmin de YunoHost. (Cette fonctionnalité a été ajouté dans la version
|
||||
3.8)
|
||||
|
||||
### <small>1.</small> Essayer
|
||||
|
||||
Dans un navigateur web, essayez d’accéder à votre serveur grâce au nom de domaine que vous avez entré à l’étape de post-installation.
|
||||
|
||||
Par exemple : `http://mondomaine.org`
|
||||
|
||||
<div class="alert alert-warning">
|
||||
Si vous avez opté pour un nom de domaine se terminant par <b>.nohost.me</b> ou <b>.noho.st</b>, vous devrez patienter cinq minutes avant que l’adresse soit atteignable.
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
#### Si ça ne fonctionne pas…
|
||||
|
||||
---
|
||||
|
||||
### <small>2.</small> Avez-vous bien configuré votre DNS ?
|
||||
|
||||
<div class="alert alert-info">
|
||||
Cette étape n’est pas nécessaire si vous possédez un nom de domaine en <b>.nohost.me</b> ou un <b>.noho.st</b>
|
||||
</div>
|
||||
|
||||
Rendez-vous sur https://www.whatsmydns.net/, entrez votre nom de domaine dans le champ prévu à cet effet et cliquez sur `Search`. Si vous ne voyez pas votre adresse IP, ou s’il y a des croix rouges par endroits, cela signifie que vous avez probablement mal configuré votre [DNS](/dns).
|
||||
|
||||
---
|
||||
|
||||
### <small>3.</small> Est-ce que les ports de votre box/routeur sont ouverts ?
|
||||
|
||||
Si vos DNS sont bien configurés, et que le serveur est accessible localement, vous avez probablement des **ports bloqués** sur votre box/routeur ou non dirigés vers votre serveur.
|
||||
Afin de le vérifier, essayez d’accéder à votre serveur avec un client extérieur au réseau local. Par exemple grâce à un autre accès Wi-Fi ou avec un smartphone en 3G/4G.
|
||||
|
||||
Si le serveur est inatteignable depuis l’extérieur du réseau local, le problème vient probablement de la configuration du routeur.
|
||||
|
||||
<div class="alert alert-info">
|
||||
Essayez d’activer l’uPnP sur l’interface de configuration de votre box/routeur, et vérifiez que le serveur y est directement connecté en Ethernet.
|
||||
<p>
|
||||
Vous pouvez également rediriger les ports manuellement vers l’adresse IP locale de votre serveur grâce à l’interface de configuration de votre box/routeur.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
### <small>4.</small> Est-ce que votre box/routeur fait du hairpinning ?
|
||||
|
||||
Si le serveur est accessible de l’extérieur, mais inatteignable via son nom de domaine dans votre réseau local, votre box/routeur ne fait probablement pas correctement de <a href="https://fr.wikipedia.org/wiki/Hairpinning" target="_blank">hairpinning</a>.
|
||||
|
||||
Voici un [tutoriel](/dns_local_network) pour pouvoir accéder à son serveur en réseau local et contourner le problème de hairpinning. Le tutoriel propose en première solution de mettre en place une redirection avec le DNS de la box et en seconde solution de modifier le fichier `hosts` des **clients** pour indiquer qu’il doit accéder au **serveur** via son IP locale. La première solution est préférable car il ne nécessite pas de modifier le fichier `hosts` sur chacun des clients du réseau local.
|
||||
|
||||
___
|
||||
|
||||
Sinon, retentez l’installation en prenant cette fois un nom de domaine en **.nohost.me** ou en **.noho.st**.
|
||||
TODO: elaborer le fait que le diagnostique tourne périodiquement, qu'un email
|
||||
est envoyé à root qui est normalement forwardé vers le premier utilisateur créé,
|
||||
que les problèmes trouvés doivent soient être réglé, soit ignorés (si ils sont
|
||||
compris ou ne sont pas pertinents) autrement un mail est envoyé deux fois par
|
||||
jour...
|
||||
|
|
|
|||
|
|
@ -1,12 +1,11 @@
|
|||
# Configure port-forwarding
|
||||
|
||||
If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). If you want a short explanation on what is and why you need port forwarding, have a look in [this page](port_forwarding).
|
||||
If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). If you want a short explanation on what is and why you need port forwarding, have a look to [this page](port_forwarding).
|
||||
|
||||
### 0. Diagnose ports opened
|
||||
|
||||
After configuring port forwarding, you should be able to validate with this small tool that your ports are correctly forwarded :
|
||||
|
||||
<a class="btn btn-default" href="http://ports.yunohost.org">Check which ports are forwarded</a>
|
||||
The new diagnosis tool introduced in 3.8 can be used to diagnose that ports are
|
||||
correctly exposed.
|
||||
|
||||
### 1. Access your box/router administration interface
|
||||
|
||||
|
|
@ -14,14 +13,14 @@ Your box/router admin interface is usually reachable via http://192.168.0.1 or h
|
|||
|
||||
### 2. Find the local IP of your server
|
||||
|
||||
Identify what is the local IP of your server, either :
|
||||
Identify what is thei *local* IP of your server, either :
|
||||
- from your box/router interface, which might list devices connected
|
||||
- from the YunoHost webadmin, in 'State of the server', 'Network'
|
||||
- from the command line in your server, by running `ip a | grep "scope global" | awk '{print $2}'`
|
||||
- from the YunoHost webadmin, in 'Diagnosis', section 'Internet connectivity', click on 'Details' on the IPv4 report.
|
||||
- from the command line in your server, by running `hostname -I`
|
||||
|
||||
A local IP address typically looks like `192.168.xx.yy`, or `10.0.xx.yy`.
|
||||
|
||||
The local IP address needs to be static, so that the port forwards that you are going to set in the next step will always reach your server. You should go into your box/router and make sure that the local IP address of your server is static instead of dynamic.
|
||||
The local IP address needs to be static, so that the port forwards that you are going to configure in the next step will always reach your server. You should go into your box/router and make sure that the local IP address of your server is static instead of dynamic.
|
||||
|
||||
### 3. Forwarding ports
|
||||
|
||||
|
|
|
|||
|
|
@ -4,9 +4,8 @@ Si vous vous auto-hébergez à la maison et sans VPN, il vous faut rediriger les
|
|||
|
||||
### 0. Diagnostiquer les ports ouverts
|
||||
|
||||
Une fois que vous aurez configuré la redirection, vous devriez pouvoir valider avec ce petit outil que vos ports sont bien redirigés :
|
||||
|
||||
<a class="btn btn-default" href="http://ports.yunohost.org">Vérifier la redirection des ports</a>
|
||||
Une fois les redirections configurées, l'outil de diagnostic introduit dans
|
||||
YunoHost 3.8 vous permettra de vérifier si les ports sont correctement exposés.
|
||||
|
||||
### 1. Accéder à l'interface d'administration de votre box/routeur
|
||||
|
||||
|
|
@ -19,8 +18,8 @@ fournis par votre fournisseur d'accès internet (FAI).
|
|||
Identifiez quelle est l'IP locale de votre serveur, soit :
|
||||
- depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs
|
||||
connectés;
|
||||
- depuis la webadmin de Yunohost, dans 'Diagnostic', section 'Connectivité Internet', cliquer sur 'Details' à côté de la ligne sur IPv4.
|
||||
- depuis la webadmin de YunoHost, dans 'État du serveur', 'Réseau';
|
||||
- depuis la ligne de commande dans votre serveur, par exemple avec `ip a | grep "scope global" | awk '{print $2}'`.
|
||||
|
||||
Une adresse IP locale ressemble généralement à `192.168.xx.yy`, ou `10.0.xx.yy`.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue