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 впс або дедік для роботи веб-сервера.

Ставить:

Як це працює

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 і Keitaro не може їх випустити. Просто використовуйте домени як зазвичай.

Швидкий старт

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

Отримання ключа#

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

Доступні методи#

Інформація#

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

Один домен#

Створення домену#

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

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

Інформація#

Що робить#

Як це працює

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

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

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

Скрипт моніторингу та автоматичної заміни IP

Автоматична зміна IP#

Навіщо це потрібно?#

А навіщо воно мені...

“…якщо є CloudFlare?”#

Keitaro: як підключити домени

Швидкий старт

Як це працює#

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

Швидка перевірка#

Нода#

Додавання доменів

Перед початком#

Огляд#

DNS-сервіс та GeoDNS

Власні NS-сервери#

Підтримувані типи записів#

GeoDNS#

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

Білінг#

Поповнення балансу.#

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

Як це працює.#

Сповіщення

Сповіщення: Telegram та Webhook#

Webhook#

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

AnonHost#

Посилання на реєстрацію: не реф#

inferno.name#

Посилання на реєстрацію: реф, не реф#

FAQ

Загальні питання#

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

Q: Які тарифи доступні?#

Посилання на реєстрацію: не реф #

Посилання на реєстрацію: реф, не реф #