English version

                            yellowtds
    _            __     __  _ _             __          __  _
   | |           \ \   / / | | |            \ \        / / | |
   | |__  _   _   \ \_/ /__| | | _____      _\ \  /\  / /__| |__
   | '_ \| | | |   \   / _ \ | |/ _ \ \ /\ / /\ \/  \/ / _ \ '_ \
   | |_) | |_| |    | |  __/ | | (_) \ V  V /  \  /\  /  __/ |_) |
   |_.__/ \__, |    |_|\___|_|_|\___/ \_/\_/    \/  \/ \___|_.__/
           __/ |
          |___/             https://yellowweb.top

If you like this script, PLEASE DONATE!

Support this project

YellowTDS — TDS для маршрутизации трафика по правилам кампаний. Проект включает движок фильтрации и распределения трафика, SQLite-хранилище, админ-панель, статистику, click logs, postback-обработку и несколько режимов интеграции.

Система принимает входящий трафик и для каждого запроса решает, что нужно отдать пользователю:

• Safe Page для нежелательного или отфильтрованного трафика
• offer funnel для целевого трафика
• trafficback, если кампания не найдена или не подходит

Ключевые возможности:

• кампании с привязкой по доменам
• Safe Page и offer-funnel логика
• multi-step funnels и flows
• equal, weighted и Thompson Sampling distribution
• JS bot detection
• S2S postbacks
• статистика, custom tables и click views
• JS Connect и PHP Connect

Для чистого Debian/Ubuntu VPS можно использовать автоустановщик:

curl -fsSL https://raw.githubusercontent.com/dvygolov/YellowTDS/multipleconfigs/code/install.sh | sudo bash

Скрипт спросит домен, проверит DNS-привязку к VPS, поставит nginx/PHP/HTTPS, C-расширение MMDB и скачает геобазы из sapics/ip-location-db.

Автоустановщик предназначен для чистого VPS без панели управления хостингом. Если обнаружена FastPanel, Plesk, cPanel/WHM, DirectAdmin, HestiaCP, VestaCP, aaPanel, ISPmanager, CyberPanel или CloudPanel, скрипт остановится до изменения конфигурации сервера. Для такого сервера используйте отдельную инструкцию Установка через панели управления.

Чтобы добавить к уже установленному инстансу несколько новых доменов:

curl -fsSL https://raw.githubusercontent.com/dvygolov/YellowTDS/multipleconfigs/code/install.sh | sudo bash -s -- --add-domain

Домены можно вводить через запятую: tds1.example.com,tds2.example.com.

Подробнее: Установка на VPS.

1. Скопируйте содержимое каталога code/ в document root сайта.
2. Откройте settings.php и задайте как минимум:
   • adminPassword
   • dbConnection
   • debug (false для production)
   • adminDomain при необходимости
   • adminIp при необходимости: один или несколько IP через запятую
3. Убедитесь, что PHP может писать в:
   • db/
   • logs/
   • caching/
4. Откройте /admin/.
5. Создайте кампанию, добавьте домены, настройте Safe Page и Flows, сохраните.

• code/index.php — основной runtime entry point
• code/js/index.php — JS Connect
• code/api/phpconnect.php — PHP Connect API
• code/api/postback.php — входящие постбэки
• code/send.php — отправка лид-форм
• code/next.php — переходы по шагам воронки
• code/admin/ — админ-панель

• code/ — самостоятельный дистрибутив YellowTDS; для развёртывания нужен только этот каталог;
• docs/ — пользовательская документация RU/EN, скриншоты и OpenAPI;
• tests/ — engine, application, browser/load tests и диагностические инструменты;
• temp/ — локальные временные и IDE-файлы, которые не входят в дистрибутив.

Полная двуязычная документация находится в репозитории:

• Русская документация
• English documentation

Рекомендуемый порядок чтения:

1. Обзор продукта
2. Как это работает
3. Вход в админку
4. Кампании и настройки
5. Статистика