mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Add XMPP and NGINX in admin tour
This commit is contained in:
tituspijean
parent
2c3d6689b9
commit
270d69cf77
21 changed files with 123 additions and 216 deletions
|
|
@ -1,64 +0,0 @@
|
|||
---
|
||||
title: Chat, VoIP y red local con XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP'
|
||||
---
|
||||
|
||||
!! TODO: simplify this page for the admin and link it to the user's guide
|
||||
|
||||
|
||||
|
||||
YunoHost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).
|
||||
|
||||
XMPP es un protocolo abierto y extensible que también permite crear salones de discusión, compartir status y datos, echar llamadas en VoIP y hacer videoconferencias.
|
||||
|
||||
Todas las aplicaciones basadas en XMPP son compatibles entre ellas : cuando utilizas un cliente XMPP puedes discutir con cualquier persona que tenga una cuenta XMPP/Jabber. Este protocolo ya es utilizado por millones de personas en el mundo.
|
||||
|
||||
## Cuenta XMPP/Jabber
|
||||
|
||||
Una cuenta XMPP/Jabber está basada en un ID bajo la forma `usuario@dominio.tld`, así como una contraseña. La contraseña es la de la cuenta del usuario de YunoHost.
|
||||
|
||||
## Conectarse a XMPP
|
||||
|
||||
Existen varios clientes web de tipo red social, como :
|
||||
- [Movim](https://movim.eu)
|
||||
- [ConverseJS](https://conversejs.org/)
|
||||
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
|
||||
|
||||
También puedes utilizar un cliente Desktop como :
|
||||
- [Gajim](https://gajim.org/es/) (Linux, Windows)
|
||||
- [Dino](https://dino.im) (Linux)
|
||||
- [Thunderbird](https://www.thunderbird.net/es-ES/) (multiplataformas)
|
||||
- [Beagle IM](https://beagle.im/) (macOS)
|
||||
- [Profanity](https://profanity-im.github.io/) (Linux)
|
||||
|
||||
... o un cliente smartphone :
|
||||
- [Conversations](https://conversations.im/) (Android)
|
||||
- [Xabber](http://xabber.com) (Android)
|
||||
- [Movim](https://movim.eu) (Android)
|
||||
- [ChatSecure](https://chatsecure.org/) (iOS)
|
||||
- [Siskin IM](https://siskin.im/) (iOS)
|
||||
- [Monal](https://monal.im/) (iOS)
|
||||
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
|
||||
|
||||
Aquí tienes una lista más exhaustiva de clientes XMPP (en) : https://xmpp.org/software/clients.html
|
||||
|
||||
### Cifrar tu conversaciones con OMEMO :
|
||||
|
||||
Es posible cifrar tu conversaciones XMPP con la ayuda de [OMEMO](https://xmpp.org/extensions/xep-0384.html), por ejemplo utilizando Gajim :
|
||||
* Instalar `gajim` y el plugin `gajim-omemo`
|
||||
* Activar el plugin en `Tools > Plugins`
|
||||
* Activar el cifrado en una conversación con un contacto que también tiene OMEMO activado.
|
||||
|
||||
### Salón de discusión
|
||||
|
||||
Para crear un salón de discusión (Multi-user chat) en tu servidor YunoHost, utiliza el ID nombredelsalon@muc.dominio.tld (donde dominio.tld es el dominio principal de tu servidor).
|
||||
|
||||
Si utilizas un nombre de dominio personal, es necesario [añadir una redirección de tipo CNAME para el subdominio `muc.`](/dns_config) en tu servidor DNS.
|
||||
|
||||
### VoIP y videoconferencias
|
||||
|
||||
Un buen medio de llamar a un contacto XMPP en VoIP o en llamada video, es utilizar el cliente [Jitsi](http://jitsi.org/).
|
||||
|
|
@ -1,71 +0,0 @@
|
|||
---
|
||||
title: Chat, VoIP et réseau social avec XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP'
|
||||
---
|
||||
|
||||
!! TODO: simplify this page for the admin and link it to the user's guide
|
||||
|
||||
|
||||
|
||||
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom de Jabber).
|
||||
|
||||
Ce protocole est déjà utilisé par des millions de personnes dans le monde - c'est un protocole ouvert. Toutes les applications basées sur XMPP sont compatibles entre elles : lorsque vous utilisez un client XMPP, vous pouvez interagir avec quiconque possède un compte XMPP.
|
||||
|
||||
XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent configurer des « extensions » pour les salons de discussions, partager des messages et des fichiers, et passer des appels voix et vidéo en utilisant XMPP.
|
||||
|
||||
## Compte XMPP
|
||||
|
||||
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prend la forme `utilisateur@votre.domaine.tld`, ainsi qu’un mot de passe.
|
||||
|
||||
Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse email principale de l'utilisateur ainsi que son mot de passe.
|
||||
|
||||
## Se connecter à son compte XMPP YunoHost
|
||||
|
||||
Il existe différents types de clients pour se connecter à XMPP.
|
||||
|
||||
### Clients web
|
||||
|
||||
- [Movim](https://movim.eu)
|
||||
- [ConverseJS](https://conversejs.org/)
|
||||
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
|
||||
|
||||
### Clients de bureau
|
||||
|
||||
- [Gajim](http://gajim.org/fr/) (Linux, Windows)
|
||||
- [Dino](https://dino.im) (Linux)
|
||||
- [Thunderbird](https://www.thunderbird.net/) (multi-plateformes)
|
||||
- [Beagle IM](https://beagle.im/) (macOS)
|
||||
- [Profanity](https://profanity-im.github.io/) (Linux)
|
||||
|
||||
### Clients sur mobile
|
||||
|
||||
- [Conversations](https://conversations.im/) (Android)
|
||||
- [Xabber](http://xabber.com) (Android)
|
||||
- [Movim](https://movim.eu) (Android)
|
||||
- [Monal](https://monal.im/) (iOS)
|
||||
- [ChatSecure](https://chatsecure.org/) (iOS)
|
||||
- [Siskin IM](https://siskin.im/) (iOS)
|
||||
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
|
||||
|
||||
Voici une liste plus exhaustive des clients XMPP : [https://fr.wikipedia.org/wiki/Liste_de_clients_XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP)
|
||||
|
||||
## Chiffrer ses conversations avec OMEMO
|
||||
|
||||
Il est possible de rendre les conversations plus sécurisées et privées en les chiffrant à l'aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
|
||||
- Installez `gajim` et le plugin `gajim-omemo` ;
|
||||
- Activez le plugin dans `Outils > Plugins` ;
|
||||
- Activez le chiffrement dans une conversation avec un contact disposant de OMEMO.
|
||||
|
||||
## Salon de discussion
|
||||
|
||||
Pour créer un salon de discussion (Multi-user chat) sur votre serveur YunoHost, utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
|
||||
|
||||
Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de type CNAME pour le sous domaine `muc.`](/dns_config) au niveau de votre serveur DNS.
|
||||
|
||||
## VoIP et visioconférence
|
||||
|
||||
Un moyen pratique d’appeler un contact XMPP, en VoIP ou en appel vidéo, est d’utiliser le client [Jitsi](http://jitsi.org/).
|
||||
|
|
@ -1,73 +0,0 @@
|
|||
---
|
||||
title: Chat, VoIP and social network with XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP'
|
||||
---
|
||||
|
||||
!! TODO: simplifier cette page pour l'admin et mettre un lien vers le guide de l'utilisateur
|
||||
|
||||
|
||||
|
||||
By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).
|
||||
|
||||
This protocol is already used by millions of people around the world—it is an open protocol.
|
||||
All applications based on XMPP are compatible with each other: When using an XMPP client, you can interact with anybody who has an XMPP account.
|
||||
|
||||
XMPP is an extensible protocol—this means users can configure "extensions" to chatrooms, share messages and files, and make voice and video calls using XMPP.
|
||||
|
||||
## XMPP account
|
||||
|
||||
To use an XMPP account you need a username, in the format: `user@domain.tld`, and a password.
|
||||
|
||||
With YunoHost, an XMPP account is created for all YunoHost users automatically.
|
||||
The XMPP account credentials corresponds to the user's main e-mail address and password.
|
||||
|
||||
## Connecting to your YunoHost XMPP account
|
||||
|
||||
You can connect to your YunoHost XMPP account in different ways.
|
||||
|
||||
### Web clients
|
||||
|
||||
- [Movim](https://movim.eu)
|
||||
- [ConverseJS](https://conversejs.org/)
|
||||
- [Libervia/Salut à Toi](https://salut-a-toi.org/)
|
||||
|
||||
### Desktop clients
|
||||
|
||||
- [Gajim](https://gajim.org/) (Linux, Windows)
|
||||
- [Dino](https://dino.im) (Linux)
|
||||
- [Thunderbird](https://www.thunderbird.net/fr/) (multiplatform)
|
||||
- [Beagle IM](https://beagle.im/) (macOS)
|
||||
- [Profanity](https://profanity-im.github.io/) (Linux)
|
||||
|
||||
### Mobile clients
|
||||
|
||||
- [Conversations](https://conversations.im/) (Android)
|
||||
- [Xabber](https://xabber.com) (Android)
|
||||
- [Movim](https://movim.eu) (Android)
|
||||
- [ChatSecure](https://chatsecure.org/) (iOS)
|
||||
- [Monal](https://monal.im/) (iOS)
|
||||
- [Siskin IM](https://siskin.im/) (iOS)
|
||||
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
|
||||
|
||||
Here is an exhaustive list of XMPP clients: https://xmpp.org/software/clients.html
|
||||
|
||||
## Encrypt conversations with OMEMO
|
||||
|
||||
XMPP chats can be made secure and private using [OMEMO encryption](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim:
|
||||
- Install `gajim` and the plugin `gajim-omemo`.
|
||||
- Turn on the plugin in `Tools > Plugins`.
|
||||
- Turn on the encryption in the chat with somebody who also has OMEMO.
|
||||
|
||||
## Chatrooms
|
||||
|
||||
To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`.
|
||||
|
||||
For this to work you need to [add the corresponding `muc.` DNS record](/dns_config) in the DNS configuration.
|
||||
|
||||
## VoIP and videoconferences
|
||||
|
||||
A practical tool to call an XMPP client, either with voice or voice+video, is to use the [Jitsi](https://jitsi.org/) client.
|
||||
|
|
@ -21,15 +21,8 @@ The application catalog and its categories can be browsed directly from the weba
|
|||
|
||||
<center><a href="/apps" style="background: orange; border-color: orange;" class="btn btn-lg btn-error"><i class="fa fa-cubes"></i> Applications catalog</a></center>
|
||||
|
||||
### Useful applications
|
||||
|
||||
If you already have a website ready to be deployed, consider using a **Custom Webapp**. It allows you to easily setup a directoty into which you can upload your HTML, PHP, CSS, JS files with SFTP, and a database if needed.
|
||||
|
||||
If you want to use YunoHost as a reverse proxy, i.e. serve an app from another server or an internal web server (think NodeJS, ruby, Python, ...), you can use the **Redirect app**. The Redirect app can also simply create shortcuts for your users in their SSO page.
|
||||
|
||||
For more information on these apps, and for more application use cases, have a look to the [Tutorials](/tutorials) section.
|
||||
|
||||
! Be careful to stay reasonable on the number of installed applications. Each additional installation increases the attack surface and the risk of failure. Ideally, if you want to test, do it with another instance for example in [a virtual machine](/install/hardware:virtualbox).
|
||||
! Be careful and stay reasonable on the number of installed applications. Each additional installation increases the attack surface and the risk of failure. Ideally, if you want to test, do it with another instance for example in [a virtual machine](/install/hardware:virtualbox).
|
||||
|
||||
|
||||
## Installing an app
|
||||
|
|
|
|||
26
pages/01.administer/06.admin_guide/08.nginx/nginx.md
Normal file
26
pages/01.administer/06.admin_guide/08.nginx/nginx.md
Normal file
|
|
@ -0,0 +1,26 @@
|
|||
---
|
||||
title: Web server with NGINX
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/web_server'
|
||||
---
|
||||
|
||||
YunoHost ships [NGINX](https://www.nginx.com/), a web server and reverse proxy software. That's the keystone that enables your apps and YunoHost services to be accessible online.
|
||||
|
||||
Most of the web applications installed with YunoHost will automatically have their own configuration file created for NGINX.
|
||||
|
||||
## Manually installing apps, or exposing existing apps
|
||||
|
||||
Generally, you should refrain from manually tinkering and installing apps, except if you are sure they will not interfere with your server. YunoHost proposes two generic apps to help you out:
|
||||
|
||||
- If you already have a website ready to be deployed, consider using a **Custom Webapp**. It allows you to easily setup a directory into which you can upload your HTML, PHP, CSS, JS files with SFTP, and a database if needed.
|
||||
|
||||
- If you want to use YunoHost as a reverse proxy, i.e. serve an app from another server or an internal web server (think NodeJS, Ruby, Python, ...), you can use the **Redirect app** in proxy mode.
|
||||
|
||||
- The **Redirect app** can also simply run in redirect mode, for example to create shortcuts for your users in their SSO page, or redirect `www.yourdomain.tld` to `yourdomain.tld`.
|
||||
|
||||
For more information on these apps, and for more application use cases, have a look to the [Tutorials](/tutorials) section.
|
||||
|
||||
!! Do not try to install Apache or other public web servers. This will break your system.
|
||||
30
pages/01.administer/06.admin_guide/09.xmpp/XMPP.es.md
Normal file
30
pages/01.administer/06.admin_guide/09.xmpp/XMPP.es.md
Normal file
|
|
@ -0,0 +1,30 @@
|
|||
---
|
||||
title: Chatcon XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP_server'
|
||||
---
|
||||
|
||||
|
||||
|
||||
YunoHost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).
|
||||
|
||||
XMPP es un protocolo abierto y extensible que también permite crear salones de discusión, compartir status y datos, echar llamadas en VoIP y hacer videoconferencias.
|
||||
|
||||
Todas las aplicaciones basadas en XMPP son compatibles entre ellas : cuando utilizas un cliente XMPP puedes discutir con cualquier persona que tenga una cuenta XMPP/Jabber. Este protocolo ya es utilizado por millones de personas en el mundo.
|
||||
|
||||
## Cuenta XMPP/Jabber
|
||||
|
||||
Una cuenta XMPP/Jabber está basada en un ID bajo la forma `usuario@dominio.tld`, así como una contraseña. La contraseña es la de la cuenta del usuario de YunoHost.
|
||||
|
||||
Si desea saber más sobre el uso de XMPP, consulte el [Manual del usuario](/XMPP).
|
||||
|
||||
## Incompatibilidad con Prosody
|
||||
|
||||
Prosody, un servidor XMPP alternativo, está empaquetado para YunoHost.
|
||||
|
||||
En particular, lo utilizan el plugin de chat Peertube y Jitsi para las videoconferencias. Estas aplicaciones instalará Prosody, que requiere que Metronome esté desactivado para funcionar.
|
||||
|
||||
! En pocas palabras, la instalación de Prosody o de una aplicación que dependa de ella desactivará el servidor XMPP.
|
||||
32
pages/01.administer/06.admin_guide/09.xmpp/XMPP.fr.md
Normal file
32
pages/01.administer/06.admin_guide/09.xmpp/XMPP.fr.md
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
---
|
||||
title: Chat avec XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP_server'
|
||||
---
|
||||
|
||||
|
||||
|
||||
YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom de Jabber).
|
||||
|
||||
Ce protocole est déjà utilisé par des millions de personnes dans le monde - c'est un protocole ouvert. Toutes les applications basées sur XMPP sont compatibles entre elles : lorsque vous utilisez un client XMPP, vous pouvez interagir avec quiconque possède un compte XMPP.
|
||||
|
||||
XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent configurer des « extensions » pour les salons de discussions, partager des messages et des fichiers, et passer des appels voix et vidéo en utilisant XMPP.
|
||||
|
||||
## Compte XMPP
|
||||
|
||||
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prend la forme `utilisateur@votre.domaine.tld`, ainsi qu’un mot de passe.
|
||||
|
||||
Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse email principale de l'utilisateur ainsi que son mot de passe.
|
||||
|
||||
Si vous souhaitez en savoir plus sur l'utilisation de XMPP, référez-vous au [Guide de l'utilisateur](/XMPP).
|
||||
|
||||
## Incompatibilité avec Prosody
|
||||
|
||||
Prosody, un serveur XMPP alternatif, est packagé pour YunoHost.
|
||||
|
||||
Il est notamment utilisé par le plugin de chat de Peertube, et Jitsi pour des vidéoconférences. Installer ces apps installera Prosody, qui nécessite de désactiver Metronome pour fonctionner.
|
||||
|
||||
! En résumé, installer Prosody ou une app en dépendant désactivera le serveur XMPP.
|
||||
34
pages/01.administer/06.admin_guide/09.xmpp/XMPP.md
Normal file
34
pages/01.administer/06.admin_guide/09.xmpp/XMPP.md
Normal file
|
|
@ -0,0 +1,34 @@
|
|||
---
|
||||
title: Chat with XMPP
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/XMPP_server'
|
||||
---
|
||||
|
||||
|
||||
|
||||
By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).
|
||||
|
||||
This protocol is already used by millions of people around the world—it is an open protocol.
|
||||
All applications based on XMPP are compatible with each other: When using an XMPP client, you can interact with anybody who has an XMPP account.
|
||||
|
||||
XMPP is an extensible protocol—this means users can configure "extensions" to chatrooms, share messages and files, and make voice and video calls using XMPP.
|
||||
|
||||
## XMPP account
|
||||
|
||||
To use an XMPP account you need a username, in the format: `user@domain.tld`, and a password.
|
||||
|
||||
With YunoHost, an XMPP account is created for all YunoHost users automatically.
|
||||
The XMPP account credentials corresponds to the user's main e-mail address and password.
|
||||
|
||||
If you wish to know more about using XMPP, refer to the [User guide](/XMPP).
|
||||
|
||||
## Incompatibility with Prosody
|
||||
|
||||
Prosody, an alternative XMPP server, is packaged for YunoHost.
|
||||
|
||||
It is notably used by Peertube's chat feature, and Jitsi for video conferences. Installing these apps will install Prosody, which needs to disable Metronome to work properly.
|
||||
|
||||
! In summary, installing Prosody or an app relying on it will disable the XMPP server.
|
||||
Loading…
Reference in a new issue