
globalping-probe v0.50.0
Le code de la sonde globalping qui s'exécute sur votre matériel et se connecte au réseau communautaire mondial de sondes
Sonde Globalping
La plateforme Globalping s'appuie sur un réseau mondial de sondes hébergées par la communauté, permettant à quiconque d'exécuter des commandes de test réseau comme ping ou traceroute depuis n'importe quel endroit.
Rejoignez la communauté des sondes Globalping
Globalping prospère grâce à la contribution de sa communauté – avec votre soutien, nous pouvons continuellement améliorer la plateforme et fournir des résultats de mesure fiables et améliorés à tous les utilisateurs gratuitement. Nous serions ravis de vous accueillir dans notre communauté en hébergeant une sonde !
Configurer une nouvelle sonde
Pour rejoindre le réseau de sondes Globalping, il vous suffit d'exécuter notre conteneur Docker, qui fonctionne à la fois sur les architectures x86 et ARM.
Recommandé : Assistant du tableau de bord pour Docker et Podman
[!TIP] Nous vous recommandons d'utiliser notre assistant du tableau de bord pour commencer. Il génère une commande qui inclut votre jeton d'adoption unique afin que la sonde soit automatiquement ajoutée à votre compte.
Alternative n°1 : Docker avec adoption optionnelle/manuelle
docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe
Si vous avez un compte Globalping, n'oubliez pas d'ajouter votre jeton d'adoption pour générer des crédits et augmenter vos limites de débit -e GP_ADOPTION_TOKEN=XXX
[!TIP] Pour l'automatisation, envisagez d'utiliser notre script d'installation universel pour serveurs Linux et de l'adapter selon vos besoins.
Alternative n°2 : Podman avec adoption optionnelle/manuelle
Pour les utilisateurs optant pour Podman, suivez les instructions ici pour vous assurer que le conteneur démarre automatiquement au démarrage. Vérifiez également les journaux du conteneur pour voir s'il a démarré avec succès, car Podman peut encore nécessiter des autorisations supplémentaires. Exécutez le conteneur avec la commande suivante :
sudo podman run --cap-add=NET_RAW -d --network host --restart=always --name globalping-probe globalping/globalping-probe
Registre alternatif
Si le registre principal Docker Hub est inaccessible à votre serveur pour une raison quelconque, vous pouvez utiliser notre miroir officiel GitHub Packages.
docker run -d --log-driver local --network host --restart=always --name globalping-probe ghcr.io/jsdelivr/globalping-probe
Notez que ghcr.io ne prend pas en charge IPv6 pour le moment.
Adoptez vos sondes
Chaque nouvelle sonde qui se connecte est d'une grande aide pour notre plateforme et la communauté, et nous voulons encourager tout le monde à lancer de nouvelles sondes sur chaque matériel disponible !
Si vous êtes également un utilisateur actif de Globalping qui a besoin de limites supérieures aux limites gratuites, nous vous recommandons de vous inscrire sur le Tableau de bord Globalping et d'adopter vos sondes.
Chaque sonde adoptée générera des crédits quotidiens supplémentaires que vous pourrez utiliser pour effectuer encore plus de tests.
En savoir plus sur les crédits Globalping
Adoption automatisée
Vous pouvez également rendre le processus d'adoption entièrement automatisé en définissant une variable d'environnement
GP_ADOPTION_TOKEN sur votre jeton d'adoption unique. Consultez simplement le Tableau de bord pour obtenir une commande personnalisée qui inclut le jeton.
Notez que toute personne connaissant votre jeton d'adoption pourra enregistrer de nouvelles sondes sous votre compte.
Où exécuter
Vous pouvez exécuter la sonde virtuelle sur tout ce qui peut exécuter un conteneur Docker, prenant en charge les architectures x86 et ARM. Cela inclut tout serveur Linux hébergé chez un fournisseur de cloud, votre serveur domestique, ou même un Raspberry Pi qui traîne dans votre bureau.
Aucune configuration n'est nécessaire ; exécutez simplement le conteneur avec une connexion Internet stable.
Comment mettre à jour
Vous n'avez pas à vous soucier des mises à jour : la sonde se met automatiquement à jour vers la dernière version dès qu'elle est disponible. Elle est téléchargée directement depuis GitHub et installée dans le conteneur.
[!NOTE] Le conteneur lui-même n'est pas mis à jour automatiquement, seul le code qu'il exécute.
Optionnel : Mise à jour du conteneur
Comme la mise à jour automatique ne met pas à jour le conteneur, nous vous recommandons de tirer régulièrement une version fraîche du conteneur.
Pour mettre à jour le conteneur, exécutez la commande suivante :
docker pull globalping/globalping-probe
docker stop globalping-probe
docker rm globalping-probe
docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe
Limitations
- Vous ne pouvez exécuter qu'une seule (1) sonde par adresse IP.
- Nous déconnectons les sondes que nous ne pouvons pas résoudre de manière fiable à un emplacement physique.
- Nous bloquons les sondes dont le trafic est acheminé via des proxys anonymes, des nœuds de sortie Tor ou des services VPN.
Sécurité
- La sonde se connecte uniquement à notre API via une connexion sécurisée ; elle n'ouvre pas de ports sur votre appareil et n'accepte aucune connexion entrante.
- Nous utilisons des listes et bases de données régulièrement mises à jour de domaines et adresses IP associés à des logiciels malveillants ou contenus potentiellement dangereux et les bannissons au niveau de l'API.
- Nous bloquons les adresses IP privées en tant que cibles.
- Nous limitons le débit de tous les utilisateurs au niveau de l'API pour éviter les abus réseau.
Ajustement du nombre de tests
Le nombre de tests de mesure que votre sonde peut traiter évolue en fonction des cœurs CPU disponibles et de la charge CPU moyenne des dernières minutes. Notre code est très léger et ne consomme pas trop de ressources, donc dans la plupart des cas, nous recommandons d'exécuter notre sonde telle quelle.
Cependant, si vous souhaitez tout de même contrôler l'utilisation des ressources, ajoutez le paramètre Docker --cpuset-cpus="0-2" à votre commande docker run et définissez le nombre de CPU entre guillemets.
Sondes matérielles
En tant que sponsor GitHub contribuant à hauteur de 10 $ ou plus par mois, vous pouvez demander une sonde matérielle et l'installer chez vous ou dans votre bureau.
Comment ça marche ?
Connectez la sonde à votre commutateur ou routeur, et le tour est joué ! Pas besoin de configurer vous-même le conteneur Docker ou d'avoir un ordinateur allumé 24h/24 et 7j/7.
Le package de sonde matérielle comprend tout ce dont vous avez besoin pour commencer :
- Mini-ordinateur basé sur ARM dans un boîtier métallique
- Alimentation
- Carte SD avec système d'exploitation et conteneur de sonde préinstallés
- Câble Ethernet de brassage
Pour demander une sonde, devenez sponsor GitHub et remplissez ce formulaire.
[!TIP] Vous pouvez également explorer le firmware de la sonde matérielle et construire votre propre version. En savoir plus ici.
Devenez fournisseur de sondes matérielles
Nous offrons aux entreprises la possibilité de parrainer des sondes matérielles co-marquées à distribuer lors de conférences ou à expédier à leurs utilisateurs, avec leurs propres autocollants et goodies inclus.
En savoir plus sur devenir fournisseur de sondes matérielles.
Support et commentaires
Si vous êtes bloqué ou souhaitez nous donner votre avis, veuillez ouvrir un nouveau ticket.
Développement
Veuillez vous référer à CONTRIBUTING.md pour plus d'informations.