> For the complete documentation index, see [llms.txt](https://docs.ipcheck.ing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipcheck.ing/developer/fr/welcome.md).

# Bienvenue

**MyIP** est une boîte à outils IP open source : recherche d'IP à partir de plusieurs sources, tests de connectivité, détection des fuites WebRTC et DNS, test de vitesse, tests de latence globale et MTR, Whois, résolveur DNS, vérifications de censure, empreinte du navigateur, et plus encore — le tout dans une seule application auto-hébergeable, fournie sous la forme d'une image Docker unique.

<button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">Poser une question…</button>

<button type="button" class="button secondary" data-action="ask" data-query="How do I deploy MyIP with Docker?" data-icon="docker">Déployer avec Docker</button><button type="button" class="button secondary" data-action="ask" data-query="How do I set up MaxMind GeoLite2 for MyIP?" data-icon="database">Configurer MaxMind</button><button type="button" class="button secondary" data-action="ask" data-query="How do I add a new tool to MyIP?" data-icon="wand-magic-sparkles">Ajouter un nouvel outil</button><button type="button" class="button secondary" data-action="ask" data-query="How do I contribute to MyIP?" data-icon="code-pull-request">Contribuer</button>

{% hint style="success" icon="globe" %}
**Le voir en direct** — l'instance officielle fonctionne sur [ipcheck.ing](https://ipcheck.ing). Tout ce que vous y voyez est ce que vous obtenez lorsque vous l'auto-hébergez.
{% endhint %}

## Par où commencer

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-rocket-launch" style="color:$primary;">:rocket-launch:</i></h3></td><td><h4><strong>Premiers pas</strong></h4></td><td>Déployez votre propre instance avec Docker ou Node.js.</td><td><a href="/pages/7ccf5f1c8a7278d633e2a7f11d211aaf09c11717">/pages/7ccf5f1c8a7278d633e2a7f11d211aaf09c11717</a></td></tr><tr><td><h3><i class="fa-sliders" style="color:$success;">:sliders:</i></h3></td><td><h4><strong>Configuration</strong></h4></td><td>Clés API, sécurité, journalisation, surveillance — tout est facultatif.</td><td><a href="/pages/7cb6bc7e696e18ef0de0a3aa55411ae99c39f126">/pages/7cb6bc7e696e18ef0de0a3aa55411ae99c39f126</a></td></tr><tr><td><h3><i class="fa-sitemap" style="color:$warning;">:sitemap:</i></h3></td><td><h4><strong>Architecture</strong></h4></td><td>Comment le frontend, le backend et les couches de données s'articulent.</td><td><a href="/pages/4060a3f988ef82d730020e167b595befde9b1e59">/pages/4060a3f988ef82d730020e167b595befde9b1e59</a></td></tr><tr><td><h3><i class="fa-code" style="color:$info;">:code:</i></h3></td><td><h4><strong>Développement</strong></h4></td><td>Conventions, i18n, tests et ajout de vos propres outils.</td><td><a href="/pages/ed9f34ccbed3d27d1a4d3127683d8bc38b7aeafb">/pages/ed9f34ccbed3d27d1a4d3127683d8bc38b7aeafb</a></td></tr><tr><td><h3><i class="fa-code-pull-request" style="color:$danger;">:code-pull-request:</i></h3></td><td><h4><strong>Contribution</strong></h4></td><td>Discipline des branches, directives pour les PR et style des commits.</td><td><a href="/pages/2656974b52856a6636e717935bb8cc5afc948628">/pages/2656974b52856a6636e717935bb8cc5afc948628</a></td></tr><tr><td><h3><i class="fa-book-open" style="color:$primary;">:book-open:</i></h3></td><td><h4><strong>Référence</strong></h4></td><td>Chaque variable d'environnement, chaque point de terminaison API et la FAQ.</td><td><a href="/pages/7a836d26bb5fd182d9df643136874f8caea9928c">/pages/7a836d26bb5fd182d9df643136874f8caea9928c</a></td></tr></tbody></table>

{% columns %}
{% column width="50%" %}

## Déployez en quelques minutes

MyIP est fourni sous la forme d'une seule image Docker contenant les deux parties de l'application : le **Vue 3** frontend monopage et le **Express 5** API backend.

La seule exigence incontournable est une paire de **MaxMind GeoLite2** identifiants gratuits — ils alimentent la géolocalisation IP et les recherches ASN dans toute l'application.

{% hint style="warning" icon="triangle-exclamation" %}
**Ne faites pas l'impasse sur MaxMind.** Un conteneur vierge sans identifiants MaxMind démarre correctement, mais la géolocalisation IP et les badges de pays restent en panne. La configuration prend cinq minutes et ne coûte rien — voir [Configuration de MaxMind](/developer/fr/getting-started/maxmind-setup.md).
{% endhint %}

{% hint style="info" icon="server" %}
**Vous préférez le bare metal ?** Vous pouvez exécuter MyIP directement avec Node.js et pnpm, avec une gestion de processus pm2 facultative — voir [Déployer avec Node.js](/developer/fr/getting-started/deploy-with-nodejs.md).
{% endhint %}

<a href="/pages/7ccf5f1c8a7278d633e2a7f11d211aaf09c11717" class="button primary" data-icon="rocket-launch">Démarrage rapide</a> <a href="/pages/7a836d26bb5fd182d9df643136874f8caea9928c" class="button secondary" data-icon="gear">Variables d'environnement</a>
{% endcolumn %}

{% column width="50%" %}
{% stepper %}
{% step %}

#### Obtenir les identifiants MaxMind

Créez un [compte GeoLite2 gratuit](https://www.maxmind.com/en/geolite2/signup) et générez une clé de licence.
{% endstep %}

{% step %}

#### Démarrer le conteneur

{% code overflow="wrap" %}

```bash
docker run -d -p 18966:18966 \
  -e MAXMIND_ACCOUNT_ID="YOUR_ACCOUNT_ID" \
  -e MAXMIND_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e MAXMIND_AUTO_UPDATE="true" \
  --name myip --restart always \
  jason5ng32/myip:latest
```

{% endcode %}
{% endstep %}

{% step %}

#### Ouvrez votre instance

Visitez `http://localhost:18966` — les bases de données GeoLite2 se téléchargent automatiquement en environ une minute lors du premier démarrage.
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}

## Pages populaires

{% columns %}
{% column %}

### Pour ceux qui déploient

{% content-ref url="/pages/84a2f1979ad26ac759285b19f9252a53d2437dd6" %}
[Déployer avec Docker](/developer/fr/getting-started/deploy-with-docker.md)
{% endcontent-ref %}

{% content-ref url="/pages/8d37838269c4de29e6e7c5b4de03c5151fe18af9" %}
[Configuration de MaxMind (obligatoire)](/developer/fr/getting-started/maxmind-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/73661187be9d8079c58d31c99cf7785449817d8d" %}
[Proxy inverse et domaines](/developer/fr/getting-started/reverse-proxy-and-domains.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}

### Pour les développeurs

{% content-ref url="/pages/4c942f8024bd66fb7ba65d3f9d9ce21929534d4a" %}
[Ajouter un nouvel outil](/developer/fr/development/adding-a-new-tool.md)
{% endcontent-ref %}

{% content-ref url="/pages/2f2200247d0e631182c7e2c0e347de4750526450" %}
[Sources de données IP](/developer/fr/architecture/ip-data-sources.md)
{% endcontent-ref %}

{% content-ref url="/pages/d7008c480f753cbd11f1040004809d5d421272a4" %}
[Points de terminaison de l'API](/developer/fr/reference/api-endpoints.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}

### En cas de blocage

{% content-ref url="/pages/9b19322032ab5551e2923ae4c57bc9d078003a8b" %}
[FAQ](/developer/fr/reference/faq.md)
{% endcontent-ref %}

{% content-ref url="/pages/8f226ab59a8f295fb2f23e33e73ff09991684028" %}
[Fonctionnalités liées à IPCheck.ing](/developer/fr/configuration/features-tied-to-ipcheck-ing.md)
{% endcontent-ref %}

{% content-ref url="/pages/b285fc557071201a5e3535a7f9650ff6957dcb28" %}
[Signaler des issues](/developer/fr/contributing/reporting-issues.md)
{% endcontent-ref %}
{% endcolumn %}
{% endcolumns %}

<h2 align="center">Un projet open source, développé en toute transparence</h2>

<p align="center">MyIP est sous licence MIT et vit sur GitHub. Mettez-lui une étoile, forkez-le ou envoyez votre première PR.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-github">:github:</i></h4></td><td><strong>GitHub</strong></td><td>Code source, tickets et pull requests. Toutes les contributions, petites ou grandes, sont les bienvenues.</td><td><a href="https://github.com/jason5ng32/MyIP" class="button secondary">Ouvrir le dépôt</a></td><td><a href="https://github.com/jason5ng32/MyIP">https://github.com/jason5ng32/MyIP</a></td></tr><tr><td><h4><i class="fa-docker">:docker:</i></h4></td><td><strong>Docker Hub</strong></td><td>L'image officielle, reconstruite à chaque version. Un seul pull, les deux moitiés de l'application.</td><td><a href="https://hub.docker.com/r/jason5ng32/myip" class="button secondary">Télécharger l'image</a></td><td><a href="https://hub.docker.com/r/jason5ng32/myip">https://hub.docker.com/r/jason5ng32/myip</a></td></tr></tbody></table>

***

Vous cherchez de l'aide **pour utiliser** l'application — ce que fait chaque outil, comment diagnostiquer les problèmes réseau, les concepts de réseau ? Rendez-vous sur la **Base de connaissances** à la place ; ces pages sont destinées aux personnes qui déploient, forquent ou contribuent à MyIP.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ipcheck.ing/developer/fr/welcome.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.