PrivateFlare Docs

HTTP API

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

Получение ключа#

Получаем свой токен в настройках пользователя.

И копируем полученный ключ.

Спецификация#

Базовый URL: https://api.privateflare.com

Для авторизации необходимо передать заголовок X-Auth-Key со значением API ключа.

Доступные методы#

Метод	Путь	Описание
GET	`/me`	Информация о пользователе
GET	`/domains/`	Список доменов
GET	`/domains/{domain}`	Детали по выбранному домену
POST	`/domains/`	Создать новый домен
PATCH	`/domains/{domain}`	Обновить параметры домена
DELETE	`/domains/{domain}`	Удалить домен
GET	`/domains/{domain}/uptime`	Статистика по времени ответа сервера
GET	`/tasks/`	Активные задачи на генерацию сертификатов
GET	`/security/iplist/`	Список списков IP
POST	`/security/iplist/`	Создать список IP
PATCH	`/security/iplist/{listid}`	Обновить список IP
DELETE	`/security/iplist/{listid}`	Удалить список IP
PUT	`/security/iplist/{listid}/{ip}`	Добавить IP в список блокировки
DELETE	`/security/iplist/{listid}/{ip}`	Удалить IP из списка блокировки
GET	`/nodes/`	Список нод
GET	`/domains/{domain}/dnsrecords`	DNS записи домена
POST	`/domains/{domain}/dnsrecords`	Создать DNS запись
PATCH	`/domains/{domain}/dnsrecords/{id}`	Обновить DNS запись
DELETE	`/domains/{domain}/dnsrecords/{id}`	Удалить DNS запись
GET	`/domains/{domain}/certexport`	Экспорт SSL сертификата (ZIP)
GET	`/domains/{domain}/activatens`	Активировать NS записи
GET	`/domains/{domain}/deactivatens`	Деактивировать NS записи

Информация#

# пример для cURL
curl --location 'https://api.privateflare.com/me/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Список доменов#

# пример для cURL
curl --location 'https://api.privateflare.com/domains/' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Один домен#

# пример для cURL
curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx'

Создание домена#

# пример для 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
}'

Поле	Тип	Описание
`enabled`	bool	Активность домена
`domain`	string	Имя домена
`mask`	string	Маска домена
`ssl`	bool	Активность SSL
`tags`	string[]	Список тегов
`backend`	string	IP бекенда
`failover`	string	IP резервного бекенда
`fhttps`	bool	Принудительный редирект с http на https
`cachelevel`	int	Уровень кеширования (0-3)
`sjschallenge`	bool	JS Challenge (аналог Under Attack)
`baseprotection`	bool	Базовая WAF защита
`bwlimit`	int	Лимит пропускной способности, KB/s (0 = без ограничений)
`geomode`	int	Гео-фильтрация: 0=выкл, 1=разрешить только, 2=заблокировать
`geolist`	string[]	Список кодов стран (ISO 3166-1 alpha-2)
`bind_node`	int[]	Привязка к конкретным нодам (пустой = все ноды)
`cachelargefiles`	bool	Кеширование больших файлов на нодах

Модификация параметров домена#

# пример для cURL
curl --location 'https://api.privateflare.com/domains/domain.com' \
--header 'Content-Type: application/json' \
--header 'X-Auth-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
--data '{
 "enabled": true
}'

Обратите внимание, что можно передавать ТОЛЬКО ИЗМЕНЯЕМЫЕ параметры.

Скрипт сетапа вебхостинга

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

Итак, скрипт нашел неожиданно положительный отклик у сообщества, видимо, инструкции по тонкой настройке - быть.

Дисклеймер: скрипт полностью рабочий, конфиги - выстраданы годами и проверены сотнями впс и дедиков. Автор сам ежедневно пользуется ими. Но много зависит от вашего хостера, его конфигов и прочих внешних, не зависящих факторов. Пожалуйста, проверяйте работоспособность перед запуском в продакшн!

Информация#

Что делает#

Полностью автоматически настраивает с 0 впс или дедик для работы веб-сервера.

Ставит:

How it works

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

Вариант 1: Трафик заходит напрямую на ноды.#

Дефолтный режим работы, как он задумывался.

Минусы:

Ваши домены будут иметь один ип и их можно найти в спай сервисе
Негодяй может устроить атаку (но бекенд уцелеет)

Вариант 2: через CloudFlare#

Минусы:

Cloudflare может подкинуть проблем на ровном месте

Плюсы:

Домены будут под облачной защитой Cloudflare
Автоматический CDN
Абузы упадут на ноду, а не бекенд

Вариант 3: через NS-серверы PrivateFlare#

Вы можете направить домены на наши NS-серверы (ns1.privateflare.com, ns2.privateflare.com) и управлять DNS-записями из панели.

Скрипт мониторинга и автоматической замены IP

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

Материал составлен с активным участием нейросетей и текст может содержать опечатки!

Сам приложенный скрипт проверен и продебажен - применим для продакшен применения. Поставляется как есть. Используете на свой страх и риск!

Автоматическая смена IP#

PrivateFlare — это не просто инфраструктура для арбитража, но и умный инструмент отказоустойчивости. Сегодня рассказываем о новой фиче: автоматическая смена IP-адреса при недоступности ноды.

Зачем это нужно?#

Сценарий знаком каждому, кто работает с трафиком:

Сайт или лендинг внезапно перестаёт отвечать
Причина — нода заблокирована или недоступна
Трафик сливается впустую, пока вы вручную не поменяете A-запись в Cloudflare

Теперь этого больше не нужно делать вручную.

А зачем оно мне...

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

Этот вопрос я слышал часто. Но каждый раз - с разными окончаниями. Давайте пробежимся по наиболее частым.

“…если есть CloudFlare?”#

Да, резонный вопрос, но только для не очень опытных арбитранов. НО!

Достаточно давно CloudFlare и Google стали официальными партнерами (пруф). Так что, технически - нет никакой гарантии, что гугл не имеет доступа к РЕАЛЬНЫМ ип серверов, спрятанных за CloudFlare. К тому же, по отзывам баеров из разных вертикалей, последние несколько лет залив на домены на CloudFlare - это почти гарантированный бан. Из-за “грязного” бекенда (не каждый же день сервер трекера меняем, да?) или самого факта использования CloudFlare - непонятно. Но это факт.

Keitaro: как подключить домены

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

Делайте все по стандартной инструкции.

не забудьте отключить принудительный редирект на HTTPS!

Это нормально:

Потому что сертификаты теперь управляются PFом и кейтаро не может их выпустить. Просто используйте домены как обычно.

Быстрый старт

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

Пошаговая инструкция: от регистрации до работающего домена за 10 минут.

Как это работает#

Прежде чем начать, важно понять базовую схему. PrivateFlare — это обратный прокси. Он принимает трафик ваших посетителей и пересылает его на ваш сервер (бекенд), скрывая его реальный IP.

Схема простая:

Посетитель → Ваш домен → Нода PrivateFlare → Ваш бекенд (сервер)

В этой цепочке участвуют три элемента:

Что	Зачем
Бекенд	Ваш реальный сервер — трекер, лендинг, CMS. Его IP прячем.
Нода	VPS с установленным клиентом PrivateFlare. Принимает трафик, фильтрует, проксирует на бекенд. Может быть несколько.
Домен	Ваш домен. В DNS указывает на IP ноды, а не бекенда.

Посетитель заходит на ваш домен, попадает на ноду, нода пересылает запрос на бекенд и возвращает ответ. Посетитель не знает реальный IP вашего сервера.

Решение проблем: не генерируются сертификаты

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

О любых проблемах на сервисе вы будете оповещены практически сразу. Если вы не получили оповещение - значит все работает как надо. А теперь к сути.

Быстрая проверка#

Любой домен в сервисе отвечает на пинги сервиса генерации сертификатов по адресу:

http://<домен>/.well-known/acme-challenge/ping тут он должен ответить pong

Это можно использовать для бглой проверки правильности настройки домена.

Нода#

Проверяем доступность ноды

Для этого в браузере просто открываем ип ноды.

Это хороший ответ: нода жива, подключена к мастеру и готова обслуживать трафик.

Добавление доменов

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

Перед началом#

Обновление NS записей может занимать продолжительное время. Для максимально быстрого рекомендуем ЗАРАНЕЕ указать в А записях у регистратора IP ноды.

Например, у вас есть бекенд (трекер) с ип xx.xx.xx.xx и вы арендовали впс ноду с IP yy.yy.yy.yy. В таком случае, в А записи должен быть указан IP yy.yy.yy.yy, а в свойствах домена бекенд xx.xx.xx.xx.

Обзор#

IP адрес бекенда (веб-сервера, AlterCPA, Binom, Keitaro и т.д.)
Список тегов через запятую

DNS-сервис и GeoDNS

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

Собственные NS-серверы#

PrivateFlare предоставляет собственные DNS-серверы:

ns1.privateflare.com
ns2.privateflare.com

Вы можете направить свои домены на наши неймсерверы у регистратора и управлять всеми DNS-записями прямо из панели управления.

Поддерживаемые типы записей#

Тип	Описание
A	IPv4 адрес
AAAA	IPv6 адрес
CNAME	Алиас домена
MX	Почтовый сервер
TXT	Текстовая запись (SPF, DKIM и т.д.)
NS	Делегирование зоны
SOA	Начало зоны
SRV	Сервисная запись

GeoDNS#

Ключевая возможность DNS-сервиса — географическая маршрутизация (GeoDNS). Для одного домена можно настроить разные IP-адреса для разных стран или континентов.

Биллинг и оплата

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

Биллинг#

В сервисе тарифицируется количество одновременно активных доменов в кабинете (слотов). Увидеть свой лимит вы можете в панели управления.

Абонентская плата списывается равными частями ежесуточно в размере 1/30 от вашего тарифа.

Количество нод (впс) - не ограничено.

Пополнение баланса.#

Пополнение баланса возможно через панель управления.

При переходе в этот раздел мастер будет вызван автоматически. Чтобы вручную создать новый счет - кликните зеленую кнопку в правом верхнем углу.

Мониторинг доменов и оповещения

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

Экспериментальная фича! Могут быть ложно положительные срабатывания. Приносим свои извинения - мы усердно работаем над сервисом. В случае любых неполадок, пожалуйста сообщайте в саппорт.

Как это работает.#

Все ваши ОНЛАЙН домены проверяются на доступность раз в 5 минут. В случае недоступности - частота проверок увеличивается до ежеминутной проверки.

В случае доступности домена, время ответа фиксируется. Так вы можете оценить стабильность вашего хостинга ноды.

Например, на этом скриншоте видно, что на моем хостинге были какие то проблемы.

Оповещения

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

Уведомления: Telegram и Webhook#

PrivateFlare умеет уведомлять вас о смене статусов доменов и нод двумя способами:

через Telegram — просто уведомление в чат;
через Webhook — гибкий инструмент автоматизации, который позволяет запускать свою логику по событию.

Webhook#

Webhook — это HTTP GET-запрос, который PrivateFlare отправляет на ваш URL при смене статуса домена или ноды.

На своей стороне вы можете реализовать любую реакцию: смену ноды, перезапуск сервиса, обновление записи в DNS и так далее.

FAQ

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

Общие вопросы#

Q: Что такое PrivateFlare простыми словами?#

A: Это как Cloudflare, но на вашем собственном оборудовании. Вы ставите наше ПО на свои VPS (ноды), и весь трафик проходит через них — защищая ваш основной сервер. Мы не видим и не храним ваш трафик.

Q: Какие тарифы доступны?#

A: Тарифы определяются количеством одновременно активных доменов (слотов):

100 доменов — $15/мес
300 доменов — $30/мес
Безлимит — $135/мес

Количество нод (серверов) не ограничено на любом тарифе. Оплата списывается ежедневно в размере 1/30 от стоимости.

PrivateFlare Docs

HTTP API

Получение ключа#

Спецификация#

Доступные методы#

Информация#

Список доменов#

Один домен#

Создание домена#

Модификация параметров домена#

Скрипт сетапа вебхостинга

Информация#

Что делает#

How it works

Вариант 1: Трафик заходит напрямую на ноды.#

Вариант 2: через CloudFlare#

Вариант 3: через NS-серверы PrivateFlare#

Скрипт мониторинга и автоматической замены IP

Автоматическая смена IP#

Зачем это нужно?#

А зачем оно мне...

“…если есть CloudFlare?”#

Keitaro: как подключить домены

Быстрый старт

Как это работает#

Решение проблем: не генерируются сертификаты

Быстрая проверка#

Нода#

Добавление доменов

Перед началом#

Обзор#

DNS-сервис и GeoDNS

Собственные NS-серверы#

Поддерживаемые типы записей#

GeoDNS#

Биллинг и оплата

Биллинг#

Пополнение баланса.#

Мониторинг доменов и оповещения

Как это работает.#

Оповещения

Уведомления: Telegram и Webhook#

Webhook#

Рекомендации хостингов

AnonHost#

Ссылки на регистрацию: не реф#

inferno.name#

Ссылки на регистрацию: реф, не реф#

FAQ

Общие вопросы#

Q: Что такое PrivateFlare простыми словами?#

Q: Какие тарифы доступны?#

Ссылки на регистрацию: не реф #

Ссылки на регистрацию: реф, не реф #