3dp-manager/README.md

English | 中文 | فارسی | Türkmençe

3DP-MANAGER

Утилита для автогенерации инбаундов к панели 3x-ui, формирования единой подписки и настройки перенаправления трафика с промежуточного сервера на основной.

Поддержать проект

• Реквизиты / донаты:
  • Карта МИР: 2204320436318077
  • Карта MasterCard: 5395452209474530
  • ЮМоney: 4100116897060652
  • PayPal: vasiljevdenisx@gmail.com
  • USDT | ETH (ERC20 | BEP20): 0x6fe140040f6Cdc1E1Ff2136cd1d60C0165809463
  • USDT | TRX (TRC20): TEWxXmJxvkAmhshp7E61XJGHB3VyM9hNAb
  • Bitcoin: bc1qctntwncsv2yn02x2vgnkrqm00c4h04c0afkgpl
  • TON: UQCZ3MiwyYHXftPItMMzJRYRiKHugr16jFMq2nfOQOOoemLy
  • Bybit ID: 165292278

Описание

Главная цель утилиты — сделать так, чтобы ваш трафик не выглядел одинаковым. Бот генерирует по заданному интервалу 10 подключений с разными параметрами:

• протоколы: vless, vmess, shadowsocks, trojan;
• порты: 443, 8443 (фиксированные) и случайные из диапазона 10000-60000;
• транспорт: tcp, websocket, grpc, xhttp;
• SNI берутся из белого списка доменов (whitelist); можно использовать свой список.

Все подключения объединяются в одну подписку со статичным URL. Бот работает с панелью 3x-ui и не вмешивается в её работу напрямую, используя открытое API панели.

Вторичная цель — стабильность подключения: клиент получает 10 вариантов поключений и может выбрать любое из них.

Дополнительно: бот можно использовать в каскадной схеме. Сервис перенаправления автоматически настроит переадресацию подписки и трафика к основному серверу.

Рекомендации:

• Используйте HTTPS для подписки (домен + SSL сертификат).
• Интервал генерации задавайте ≥ 10 минут; для стабильности рекомендуется — раз в сутки (1440 минут).
• В клиенте установите автообновление чаще (например, каждый час), чтобы была синхронизация с сервером.

Возможности

• Генерация 10 разнообразных подключений
• Формирование единой подписки со статичным URL
• Поддержка кастомного whitelist доменов
• Автоматическая настройка перенаправления трафика (опционально)

Требования

• Ubuntu 20.04 (и выше)
• Панель 3x-ui
• Домен + SSL сертификат (опционально)

---

Установка

Установите проект на сервер командой:

bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/install.sh)

Краткое описание: запускает скрипт установки и разворачивает контейнеры и сервисы.

Обновление

Обновление до последней версии:

bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)

Краткое описание: подтягивает последние изменения и перезапускает контейнеры.

Удаление

Полное удаление сервиса:

bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)

Краткое описание: удаляет контейнеры и файлы конфигурации, возвращая систему к состоянию до установки.

---

Установка сервиса перенаправления (forwarding)

Сервис перенаправления позволяет проксировать входящие порты с промежуточного сервера на основной.

bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)

Краткое описание: добавляет правила перенаправления и создает сервис для обновления подписки.

Удаление перенаправления

bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)

Краткое описание: удаляет правила и отключает сервис перенаправления.

---

Показать URL подписки

Команда для вывода текущего URL подписки из среды контейнера:

cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2

Краткое описание: выводит статичный URL подписки, который можно использовать в клиентах. Работает как на основном, так и на промежуточном сервере.

Сбор доменов из мульти-подписок

Утилита извлекает домены из подписок и формирует whitelist для генератора.

node get_domains.js

Краткое описание: добавьте ссылку на мульти-подписку в скрипт и запустите команду — на выходе получите список доменов. Неободим Node.js для работы скрипта.

Использование собственного белого списка

1. Подготовьте файл в формате whitelist.txt.
2. Переименуйте на my_whitelist.txt и скопируйте в папку /opt/3dp-manager/app.

cd /opt/3dp-manager && docker cp ./app/my_whitelist.txt node:/app/my_whitelist.txt

Краткое описание: добавляет ваш файл доменов в контейнер приложения. Чтобы сразу же сгенерировать инбаунды с новыи списком, выполните docker exec -it node sh и затем node index.js.

---

Замечания и текущие ограничения

• Общий список доменов работает не у всех провайдеров, поэтому рекомендуется составить и использовать свой whitelist.

---

Внести вклад

Буду рад любому вкладу в разработку проекта! Простой процесс для контрибьюторов:

1. Форкните репозиторий на GitHub.
2. Создайте ветку с осмысленным именем, например feature/add-README или fix/whitelist-load.
3. Внесите изменения и добавьте короткое описание в коммите.
4. Запустите локально базовые проверки (если есть).
5. Отправьте ветку в ваш форк и создайте Pull Request в основной репозиторий.

Советы: описывайте изменения в PR, указывайте цель и тестовые шаги. Если изменения большие — разделяйте на маленькие коммиты.

---

Обсуждение

• Телеграм: @denpiligrim_web
• Раздел Issues в данном репозитории