Pangolin pour Omarchy : vos connexions depuis le bureau

Autres langues : Deutsch · English

La connexion au réseau privé est-elle active ? Où était le lien vers ce service ? Avec omarchy-pangolin, ces informations sont accessibles depuis le bureau Omarchy. Mon plugin communautaire rassemble l’état de la connexion et les ressources du compte Pangolin actif dans un petit panneau.

Il permet de se connecter ou de se déconnecter, d’ouvrir des services web et de copier des adresses. Pour un service utilisé régulièrement, on peut installer une application web ou ouvrir une application correspondante déjà installée. Le panneau reprend les couleurs du thème Omarchy actif. Présentation des fonctions

À qui s’adresse ce plugin ?

Le plugin s’adresse aux personnes qui utilisent Omarchy comme environnement de bureau et Pangolin pour accéder à leurs services ou à des ressources partagées avec elles. Il est surtout utile lorsqu’on passe régulièrement d’une application à l’autre : une archive documentaire, un tableau de bord ou un environnement de développement interne. Ce sont des exemples d’utilisation, pas des intégrations préconfigurées avec ces applications.

Si vous gérez un homelab, vous connaissez probablement déjà vos services et leurs adresses. Vous pouvez néanmoins vouloir les ouvrir sans rechercher l’URL à chaque fois. Le panneau affiche les ressources autorisées pour votre compte Pangolin. Les services web fréquents peuvent être installés comme applications web, puis ouverts dans leur propre fenêtre.

Le plugin peut aussi servir aux membres d’une petite équipe qui ne gèrent aucun serveur. Il faut un bureau Omarchy compatible et des ressources accordées par la personne responsable de l’administration. Pangolin détermine les services disponibles et les droits d’accès. Le plugin les rend accessibles depuis le poste de travail ; il n’accorde pas de droits supplémentaires. Modèle d’accès et présentation

Deux exemples au quotidien

Accéder à ses services depuis un ordinateur portable

Imaginons que vous souhaitiez ouvrir votre archive documentaire auto-hébergée pendant un déplacement. Si elle est configurée comme ressource web publique dans Pangolin, vous pouvez ouvrir son lien depuis le panneau. L’authentification et les contrôles d’accès du service continuent de s’appliquer. Cet accès par navigateur ne nécessite pas forcément la même connexion cliente privée qu’une ressource interne.

Pour une cible située sur un réseau privé, vérifiez d’abord l’état de la connexion et connectez Pangolin si nécessaire, puis ouvrez le service configuré. Cette distinction compte : un portail web accessible ne prouve pas qu’un hôte privé l’est aussi. La documentation explique les deux chemins d’accès.

Garder un environnement de développement à portée de main

Une équipe pourrait partager une préversion interne de son application web comme ressource. Si vous l’ouvrez plusieurs fois par jour, le menu de la ressource permet de l’installer comme application web. Le plugin peut aussi ouvrir une application correspondante déjà installée. Cela évite de passer à chaque fois d’une liste de favoris au terminal.

Une ressource de type hôte n’est pas nécessairement un site web. Dans ce cas, la fonction de copie permet de reprendre son adresse dans l’outil adapté au service. Un port TCP autorisé ne dit pas au plugin s’il faut utiliser HTTP ou HTTPS. Pour l’ouvrir dans un navigateur, il peut donc être nécessaire de préciser l’URL ou le protocole. Ouverture et configuration des ressources

Ce qu’indique l’état de la connexion

Le vert indique une connexion confirmée. L’orange signale notamment un état inconnu ou en attente, ou un avertissement. Le rouge indique une déconnexion ou une erreur. Les animations discrètes ne fonctionnent que lorsque le panneau est ouvert et que la connexion vient d’être confirmée. Elles s’arrêtent si cet état n’est plus confirmé. Commandes et affichage de l’état

L’indicateur décrit la connexion locale. Il ne vérifie pas le fonctionnement de chaque application derrière celle-ci. Un service peut être arrêté alors que le tunnel est connecté. Un diagnostic HTTPS ne prouve pas non plus la connectivité UDP ni le bon fonctionnement d’une application. Limites du diagnostic

Les liens web et les ressources privées ont des prérequis différents. Les ressources privées nécessitent une connexion Pangolin active et une résolution DNS des alias fonctionnelle. Une adresse d’hôte ne signifie pas qu’un service web s’y trouve. Une URL complète ou un schéma connu peut être configuré pour ces ressources. Configuration

Avant de commencer

Le plugin nécessite Omarchy Quattro avec l’API de plugins Quickshell adaptée, Python 3.10 ou plus récent et la CLI Pangolin avec un socket OLM local accessible en lecture. L’installation du plugin n’installe pas ces dépendances. L’authentification et la connexion se configurent séparément ; l’installation ne déclenche aucune connexion automatique. Prérequis

Une fois les prérequis remplis, installez et activez le plugin avec :

omarchy plugin add https://github.com/PatrickIsenegger/omarchy-pangolin.git --enable

Cette commande installe le plugin. Le guide lié décrit la configuration séparée du client Pangolin. La liste des ressources exige une session utilisateur authentifiée et une organisation sélectionnée. Un client machine qui utilise uniquement un identifiant client et un secret ne suffit pas.

Après la configuration, ouvrez le panneau depuis son icône dans la barre, ou avec cette commande dans le terminal :

omarchy-shell shell toggle community.pangolin

Cette commande ouvre ou ferme uniquement le panneau, sans modifier la connexion. Si vous changez d’organisation active dans la CLI, rouvrez le panneau pour actualiser les ressources. Installation et utilisation

À savoir avant de l’essayer

Ce plugin est conçu pour Omarchy Quattro. Sans environnement Pangolin existant, il faut d’abord obtenir un accès à un serveur adapté ou à un compte Cloud. Le plugin utilise cette configuration. Pour un seul lien web rarement ouvert, un favori peut suffire. Le panneau devient plus utile lorsque vous souhaitez réunir l’état de la connexion et plusieurs ressources.

Les réglages se modifient actuellement dans un éditeur JSON. Les ressources web s’ouvrent avec Chromium et leur liste s’actualise à l’ouverture du panneau ou sur demande. L’interface est en anglais. Ces conditions sont à prendre en compte si vous souhaitez l’installer sur le poste d’une autre personne.

Le compte CLI actif détermine le serveur et l’organisation. L’adaptateur de compte prend en charge Pangolin Cloud et les serveurs auto-hébergés. Des tests synthétiques couvrent les comptes et les requêtes pour les deux variantes ; selon le README du projet, l’accès Cloud authentifié n’a pas encore été vérifié de bout en bout. Cela ne signifie pas non plus que toutes les combinaisons de versions serveur et client ont été testées en intégration. Compatibilité

Le code source, les instructions d’installation et les exemples se trouvent dans le dépôt omarchy-pangolin. Il s’agit d’un plugin communautaire indépendant. Pour signaler un problème, utilisez des ressources fictives et retirez les identifiants d’accès ainsi que les adresses privées des captures d’écran et des journaux.

L’image de l’article est une illustration générée par IA. Elle ne représente ni une interface réelle ni une topologie réseau réelle.

Le plugin figure aussi dans la rubrique Mes projets de la page des outils.