документация Reefox

Запускайте свой
VPN-сервис.

Reefox Panel — готовый VPN-сервис с продажей через Telegram: бот, Mini App, сайт и админка на вашем сервере и под вашим брендом. Здесь — как его установить, настроить и вести каждый день, со скриншотами и честными нюансами.

Установка

curl -fsSL https://store.reefox.ru/install.sh -o tmavpn-install.sh && sudo bash tmavpn-install.sh
Терминал

vpn.example.com/admin

Админка открыта!

sudo bash tmavpn-install.sh ◇ Ключ лицензии│ ●●●●●●●●●●●● ✓ принят◇ Домен│ vpn.example.com ✓ указывает на сервер◇ Токен бота│ ✓ @my_vpn_bot│◆ Установка [6/6]│ ✓ Готово! Ваш сервис работает.

Всё для продаж в Telegram.

Тарифы, оплата, пробный период, напоминания о продлении, рассылки и поддержка — уже внутри. Вы подключаете серверы и платёжку, остальное работает само.

Обзор Reefox Panel

Бот и Mini App

Приветствие, пробный период, покупка и подключение устройств прямо в Telegram.

СБП и карты

YooKassa и Platega с резервным провайдером. СБП всегда первый способ оплаты.

Автопродление

Подписка продлевается сама, если провайдер подтвердил рекуррентные платежи.

Одна ссылка подписки

Клиент добавляет её в Happ, INCY, v2RayTun или Karing и видит все локации.

Рефералы и промокоды

Бонусные дни или деньги за друзей, скидки, рекламные ссылки с антиботом.

Обновления одной кнопкой

Новая версия ставится из Telegram, VPN у клиентов при этом не прерывается.

Бот и Mini App

Приветствие, пробный период, покупка и подключение устройств прямо в Telegram.

СБП и карты

YooKassa и Platega с резервным провайдером. СБП всегда первый способ оплаты.

Автопродление

Подписка продлевается сама, если провайдер подтвердил рекуррентные платежи.

Одна ссылка подписки

Клиент добавляет её в Happ, INCY, v2RayTun или Karing и видит все локации.

Рефералы и промокоды

Бонусные дни или деньги за друзей, скидки, рекламные ссылки с антиботом.

Обновления одной кнопкой

Новая версия ставится из Telegram, VPN у клиентов при этом не прерывается.

Бот и Mini App

Приветствие, пробный период, покупка и подключение устройств прямо в Telegram.

СБП и карты

YooKassa и Platega с резервным провайдером. СБП всегда первый способ оплаты.

Автопродление

Подписка продлевается сама, если провайдер подтвердил рекуррентные платежи.

Одна ссылка подписки

Клиент добавляет её в Happ, INCY, v2RayTun или Karing и видит все локации.

Рефералы и промокоды

Бонусные дни или деньги за друзей, скидки, рекламные ссылки с антиботом.

Обновления одной кнопкой

Новая версия ставится из Telegram, VPN у клиентов при этом не прерывается.

Бот и Mini App

Приветствие, пробный период, покупка и подключение устройств прямо в Telegram.

СБП и карты

YooKassa и Platega с резервным провайдером. СБП всегда первый способ оплаты.

Автопродление

Подписка продлевается сама, если провайдер подтвердил рекуррентные платежи.

Одна ссылка подписки

Клиент добавляет её в Happ, INCY, v2RayTun или Karing и видит все локации.

Рефералы и промокоды

Бонусные дни или деньги за друзей, скидки, рекламные ссылки с антиботом.

Обновления одной кнопкой

Новая версия ставится из Telegram, VPN у клиентов при этом не прерывается.

Админка Reefox Panel: клиенты

Вся работа — в одной админке.

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

Проверить, что сервис жив, можно одной командой:

curl -sS https://vpn.example.com/health

{"status":"ok","service":"vpn-api"}

Для каждого, кто рядом с сервисом.

Владельцу — админка и деньги. Клиенту — бот, Mini App и одна ссылка подписки. Разработчику — API для Telegram Stars и Premium.

# 1. Ключ лицензии — в боте @reefox_store_bot
# 2. A-запись домена на IP сервера
dig +short vpn.example.com A @1.1.1.1

# 3. Установка одной командой
curl -fsSL https://store.reefox.ru/install.sh -o tmavpn-install.sh && sudo bash tmavpn-install.sh

# 4. Админка
https://vpn.example.com/admin/

Запуск за вечер.

Установщик сам ставит Docker, базу, HTTPS и бота, проверяя каждый ваш ответ. Дальше — мастер первого входа и настройка в браузере.

  • Сервер на Ubuntu или Debian, от 2 ГБ памяти
  • Свой домен и свой бот
  • VPN-серверы с 3x-ui подключаются по SSH
  • Пробный период лицензии — бесплатно
Быстрый старт

Под капотом.

Reefox Stars API

Пять методов на весь путь заказа: проверить получателя, узнать цену, создать заказ, следить за статусом и смотреть баланс.

Методы API
{
  "ok": true,
  "id": "ord_…",
  "status": "fulfillment_pending",
  "amount": { "value": "1.275", "currency": "TON" }
}

Любой способ оплаты

YooKassa, Platega, CryptoBot и Telegram Stars. Провайдеры идут по приоритету: если основной недоступен, платёж уходит резервному.

СБПКартыCryptoStars

Счёт, который не теряется.

Счёт живёт 15 минут → отменяется сам → новый по запросу. Поздняя оплата старого счёта всё равно засчитывается, а номер платежа для людей короткий, вида 7K3F-9QMZ.

Ожидает

Счёт создан, клиент платит.

Оплачен

Доступ выдан сразу после оплаты.

Отменён

Через 15 минут без оплаты.

Поздняя оплата

Старый счёт всё равно засчитывается.

Возврат

Отмечается в админке одной кнопкой.

Защита от дублей.

Каждый заказ Stars уходит с ключом идемпотентности: повтор того же запроса вернёт тот же заказ, а не создаст второй.

Повтор запроса
Idempotency-Key: checkout_7812

# тот же ключ, те же поля → исходный заказ
# тот же ключ, другие поля → 409 idempotency_conflict

Локации

🇳🇱 Нидерланды
online
🇩🇪 Германия
online
🇫🇮 Финляндия
online
🇸🇪 Швеция
online
Новый сервер
IP:   203.0.113.50
SSH:  root · ●●●●●●●●

✓ 3x-ui найдена сама
✓ ключи выданы клиентам

Ответ за пару секунд.

Поиск по всей документации — ⌘K в любом месте сайта: по заголовкам, тексту и командам.

Если что-то не работает
сертификат

Сайт не открывается или браузер ругается на сертификат

Если что-то не работает

Если HTTPS не заработал

Установка

Проверить, что запись видна

Сервер и домен

Как проверить, что домен смотрит на сервер

Статьи

Кабинет прямо в Telegram.

Mini App открывается кнопкой в боте: пробный период, оплата, устройства и ссылка подписки — без перехода на сайт.

Бот и Mini App
Главная Mini App: подписка, устройства и кнопкиОплата в Mini App

Начните сегодня.

Пробный период — бесплатно.

Ключ лицензии и команда установки приходят в боте за минуту. Один ключ — один сервер.

Reefox

ваш бренд, ваш сервер, ваши клиенты.

  • Обновления одной кнопкой.Новая версия ставится из Telegram, при ошибке — откат на прежнюю.
  • Бэкапы и переезд.Копии в Telegram или S3, перенос на новый сервер из админки.
  • За полчаса.Если сервер, домен и бот готовы, быстрый старт занимает около 30 минут.
  • Клиенты платят как привыкли.СБП первым, карты, криптовалюта и Telegram Stars.
  • Быстрый стартСтатьи