PrivateFlare Docs

HTTP API

Thu, 22 Jan 2026 00:00:00 +0000

Obtention de la clé#

Récupérez votre token dans les paramètres utilisateur.

Et copiez la clé obtenue.

Spécification#

URL de base : https://api.privateflare.com

Pour l’autorisation, il est nécessaire de transmettre l’en-tête X-Auth-Key avec la valeur de la clé API.

Méthodes disponibles#

Méthode	Chemin	Description
GET	`/me`	Informations sur l’utilisateur
GET	`/domains/`	Liste des domaines
GET	`/domains/{domain}`	Détails du domaine sélectionné
POST	`/domains/`	Créer un nouveau domaine
PATCH	`/domains/{domain}`	Mettre à jour les paramètres du domaine
DELETE	`/domains/{domain}`	Supprimer un domaine
GET	`/domains/{domain}/uptime`	Statistiques de temps de réponse du serveur
GET	`/tasks/`	Tâches actives de génération de certificats
GET	`/security/iplist/`	Liste des listes d’IP
POST	`/security/iplist/`	Créer une liste d’IP
PATCH	`/security/iplist/{listid}`	Mettre à jour une liste d’IP
DELETE	`/security/iplist/{listid}`	Supprimer une liste d’IP
PUT	`/security/iplist/{listid}/{ip}`	Ajouter une IP à la liste de blocage
DELETE	`/security/iplist/{listid}/{ip}`	Supprimer une IP de la liste de blocage
GET	`/nodes/`	Liste des noeuds
GET	`/domains/{domain}/dnsrecords`	Enregistrements DNS du domaine
POST	`/domains/{domain}/dnsrecords`	Créer un enregistrement DNS
PATCH	`/domains/{domain}/dnsrecords/{id}`	Mettre à jour un enregistrement DNS
DELETE	`/domains/{domain}/dnsrecords/{id}`	Supprimer un enregistrement DNS
GET	`/domains/{domain}/certexport`	Export du certificat SSL (ZIP)
GET	`/domains/{domain}/activatens`	Activer les enregistrements NS
GET	`/domains/{domain}/deactivatens`	Désactiver les enregistrements NS

Informations#

# exemple pour cURL
curl --location 'https://api.privateflare.com/me/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Liste des domaines#

# exemple pour cURL
curl --location 'https://api.privateflare.com/domains/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Un domaine#

# exemple pour cURL
curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Création d’un domaine#

# exemple pour cURL
curl --location 'https://api.privateflare.com/domains/' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
 "enabled": true,
 "domain": "domain.com",
 "mask": "yandex.info",
 "ssl": true,
 "tags": ["tag1","tag2"],
 "backend": "127.0.0.1",
 "fhttps": true,
 "cachelevel": 1
}'

Champ	Type	Description
`enabled`	bool	Activité du domaine
`domain`	string	Nom du domaine
`mask`	string	Masque du domaine
`ssl`	bool	Activité SSL
`tags`	string[]	Liste des tags
`backend`	string	IP du backend
`failover`	string	IP du backend de secours
`fhttps`	bool	Redirection forcée de http vers https
`cachelevel`	int	Niveau de mise en cache (0-3)
`sjschallenge`	bool	JS Challenge (équivalent d’Under Attack)
`baseprotection`	bool	Protection WAF de base
`bwlimit`	int	Limite de bande passante, Ko/s (0 = sans limitation)
`geomode`	int	Filtrage géographique : 0=désactivé, 1=autoriser uniquement, 2=bloquer
`geolist`	string[]	Liste des codes pays (ISO 3166-1 alpha-2)
`bind_node`	int[]	Association à des noeuds spécifiques (vide = tous les noeuds)
`cachelargefiles`	bool	Mise en cache des gros fichiers sur les noeuds

Modification des paramètres du domaine#

# exemple pour cURL
curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
 "enabled": true
}'

Notez que vous pouvez transmettre UNIQUEMENT LES PARAMETRES A MODIFIER.

Script de configuration d'hébergement web

Tue, 20 May 2025 00:00:00 +0000

Le script a rencontré un accueil étonnamment positif de la part de la communauté ; apparemment, un guide de configuration avancée s’impose.

Avertissement : le script est entièrement fonctionnel, les configurations ont été affinées au fil des années et éprouvées sur des centaines de VPS et serveurs dédiés. L’auteur les utilise personnellement au quotidien. Cependant, beaucoup dépend de votre hébergeur, de ses configurations et d’autres facteurs externes indépendants. Veuillez vérifier le bon fonctionnement avant toute mise en production !

Comment cela fonctionne

Wed, 14 May 2025 00:00:00 +0000

Option 1 : Le trafic arrive directement sur les noeuds.#

Le mode de fonctionnement par défaut, tel qu’il a été conçu.

Inconvénients :

Vos domaines auront une seule IP et pourront être trouvés via un service d’espionnage
Un individu malveillant peut lancer une attaque (mais le backend sera préservé)

Option 2 : Via CloudFlare#

Inconvénients :

Cloudflare peut causer des problèmes de manière inattendue

Avantages :

Les domaines bénéficient de la protection cloud de Cloudflare

Script de monitoring et de remplacement automatique d'IP

Sun, 18 May 2025 00:00:00 +0000

Ce contenu a été rédigé avec la participation active de réseaux neuronaux et le texte peut contenir des erreurs !

Le script ci-joint a été vérifié et débogué — il est utilisable en production. Il est fourni tel quel. Vous l’utilisez à vos propres risques !

Remplacement automatique d’IP#

PrivateFlare n’est pas seulement une infrastructure pour l’arbitrage, mais aussi un outil intelligent de tolérance aux pannes. Aujourd’hui, nous vous présentons une nouvelle fonctionnalité : le remplacement automatique de l’adresse IP en cas d’indisponibilité du noeud.

Mais pourquoi en aurais-je besoin...

Wed, 14 May 2025 00:00:00 +0000

Cette question, je l’ai entendue souvent. Mais chaque fois avec une fin différente. Passons en revue les plus fréquentes.

“…s’il y a CloudFlare ?”#

Oui, question pertinente, mais uniquement pour les arbitragistes peu expérimentés. CEPENDANT !

Depuis un certain temps déjà, CloudFlare et Google sont devenus partenaires officiels (preuve). Donc, techniquement, rien ne garantit que Google n’a pas accès aux VRAIES adresses IP des serveurs cachés derrière CloudFlare. De plus, selon les retours d’acheteurs de différentes verticales, ces dernières années, envoyer du trafic sur des domaines sous CloudFlare équivaut quasi certainement à un bannissement. Est-ce dû au backend « sale » (on ne change pas son serveur tracker tous les jours, n’est-ce pas ?) ou au simple fait d’utiliser CloudFlare — difficile à dire. Mais c’est un fait.

Keitaro : comment connecter les domaines

Wed, 11 Sep 2024 00:00:00 +0000

Suivez le guide standard.

N’oubliez pas de désactiver la redirection forcée vers HTTPS !

C’est normal :

En effet, les certificats sont désormais gérés par PF et Keitaro ne peut pas les émettre. Utilisez simplement les domaines comme d’habitude.

Démarrage rapide

Tue, 13 Jan 2026 00:00:00 +0000

Guide pas à pas : de l’inscription à un domaine fonctionnel en 10 minutes.

Comment cela fonctionne#

Avant de commencer, il est important de comprendre le schéma de base. PrivateFlare est un reverse proxy. Il reçoit le trafic de vos visiteurs et le transmet à votre serveur (backend), en dissimulant son adresse IP réelle.

Le schéma est simple :

Visiteur → Votre domaine → Noeud PrivateFlare → Votre backend (serveur)

Résolution de problèmes : les certificats ne se génèrent pas

Tue, 26 Dec 2023 00:00:00 +0000

Vous serez notifié de tout problème sur le service presque immédiatement. Si vous n’avez pas reçu de notification, cela signifie que tout fonctionne correctement. Passons maintenant au sujet.

Vérification rapide#

Tout domaine du service répond aux pings du service de génération de certificats à l’adresse :

http://<domaine>/.well-known/acme-challenge/ping il doit répondre pong

Cela peut être utilisé pour une vérification rapide de la bonne configuration du domaine.

Noeud#

Vérifiez la disponibilité du noeud.

Ajout de domaines

Wed, 14 May 2025 00:00:00 +0000

Avant de commencer#

La mise à jour des enregistrements NS peut prendre un certain temps. Pour une prise en compte la plus rapide possible, nous recommandons d’indiquer AU PREALABLE l’IP du noeud dans les enregistrements A chez votre registraire.

Par exemple, vous avez un backend (tracker) avec l’IP xx.xx.xx.xx et vous avez loué un VPS noeud avec l’IP yy.yy.yy.yy. Dans ce cas, l’enregistrement A doit contenir l’IP yy.yy.yy.yy, et dans les propriétés du domaine le backend xx.xx.xx.xx.

Service DNS et GeoDNS

Thu, 19 Mar 2026 00:00:00 +0000

Serveurs NS propres#

PrivateFlare fournit ses propres serveurs DNS :

ns1.privateflare.com
ns2.privateflare.com

Vous pouvez diriger vos domaines vers nos serveurs de noms chez votre registraire et gérer tous les enregistrements DNS directement depuis le panneau de contrôle.

Types d’enregistrements pris en charge#

Type	Description
A	Adresse IPv4
AAAA	Adresse IPv6
CNAME	Alias de domaine
MX	Serveur de messagerie
TXT	Enregistrement texte (SPF, DKIM, etc.)
NS	Délégation de zone
SOA	Début de zone
SRV	Enregistrement de service

GeoDNS#

La fonctionnalité clé du service DNS est le routage géographique (GeoDNS). Pour un même domaine, vous pouvez configurer différentes adresses IP pour différents pays ou continents.

Facturation et paiement

Thu, 15 Jan 2026 00:00:00 +0000

Facturation#

Le service facture le nombre de domaines actifs simultanément dans votre espace (créneaux). Vous pouvez consulter votre limite dans le panneau de contrôle.

L’abonnement est prélevé en parts égales quotidiennement, à hauteur de 1/30 de votre forfait.

Le nombre de noeuds (VPS) est illimité.

Rechargement du solde.#

Le rechargement du solde est possible via le panneau de contrôle.

En accédant à cette section, l’assistant sera lancé automatiquement. Pour créer manuellement une nouvelle facture, cliquez sur le bouton vert en haut à droite.

Monitoring des domaines et notifications

Wed, 14 May 2025 00:00:00 +0000

Fonctionnalité expérimentale ! Des faux positifs peuvent se produire. Nous nous en excusons — nous travaillons assidûment sur le service. En cas de dysfonctionnement, veuillez contacter le support.

Comment cela fonctionne.#

Tous vos domaines EN LIGNE sont vérifiés en termes de disponibilité toutes les 5 minutes. En cas d’indisponibilité, la fréquence des vérifications passe à une vérification par minute.

Lorsque le domaine est disponible, le temps de réponse est enregistré. Vous pouvez ainsi évaluer la stabilité de l’hébergement de votre noeud.

Notifications

Wed, 29 Oct 2025 00:00:00 +0000

Notifications : Telegram et Webhook#

PrivateFlare peut vous notifier des changements de statut des domaines et des noeuds de deux manières :

via Telegram — une simple notification dans un chat ;
via Webhook — un outil flexible d’automatisation qui permet de déclencher votre propre logique en fonction d’un événement.

Webhook#

Un Webhook est une requête HTTP GET que PrivateFlare envoie à votre URL lors d’un changement de statut d’un domaine ou d’un noeud.

Recommandations d'hébergeurs

Wed, 14 May 2025 00:00:00 +0000

AnonHost#

Liens d’inscription : sans parrainage #

Le choix de certains de nos clients pour l’hébergement de thématiques sujettes aux signalements. Très tolérants envers les proxys et notre logiciel.

Prix acceptables
Bon support
Bons débits et matériel
Large choix de localisations et de configurations

Contact du support

inferno.name#

Liens d’inscription : parrainage, sans parrainage #

Dans l’ensemble, un très bon hébergeur non seulement pour la protection, mais aussi pour un usage courant.

Support extrêmement tolérant et compétent

FAQ

Wed, 14 May 2025 00:00:00 +0000

Questions générales#

Q : Qu’est-ce que PrivateFlare en termes simples ?#

R : C’est comme Cloudflare, mais sur votre propre équipement. Vous installez notre logiciel sur vos VPS (noeuds), et tout le trafic passe par eux — protégeant ainsi votre serveur principal. Nous ne voyons ni ne stockons votre trafic.

Q : Quels sont les forfaits disponibles ?#

R : Les forfaits sont déterminés par le nombre de domaines actifs simultanément (créneaux) :

PrivateFlare Docs

HTTP API

Obtention de la clé#

Spécification#

Méthodes disponibles#

Informations#

Liste des domaines#

Un domaine#

Création d’un domaine#

Modification des paramètres du domaine#

Script de configuration d'hébergement web

Comment cela fonctionne

Option 1 : Le trafic arrive directement sur les noeuds.#

Option 2 : Via CloudFlare#

Script de monitoring et de remplacement automatique d'IP

Remplacement automatique d’IP#

Mais pourquoi en aurais-je besoin...

“…s’il y a CloudFlare ?”#

Keitaro : comment connecter les domaines

Démarrage rapide

Comment cela fonctionne#

Résolution de problèmes : les certificats ne se génèrent pas

Vérification rapide#

Noeud#

Ajout de domaines

Avant de commencer#

Service DNS et GeoDNS

Serveurs NS propres#

Types d’enregistrements pris en charge#

GeoDNS#

Facturation et paiement

Facturation#

Rechargement du solde.#

Monitoring des domaines et notifications

Comment cela fonctionne.#

Notifications

Notifications : Telegram et Webhook#

Webhook#

Recommandations d'hébergeurs

AnonHost#

Liens d’inscription : sans parrainage#

inferno.name#

Liens d’inscription : parrainage, sans parrainage#

FAQ

Questions générales#

Q : Qu’est-ce que PrivateFlare en termes simples ?#

Q : Quels sont les forfaits disponibles ?#

Liens d’inscription : sans parrainage #

Liens d’inscription : parrainage, sans parrainage #