readme, fix inbound link, auto url
This commit is contained in:
Denis Vasilev
@@ -1,63 +1,167 @@
|
||||
[English](https://github.com/denpiligrim/3dp-manager/blob/main/README_EN.md)
|
||||
[English](/README_EN.md) | [中文](/README_CN.md) | [فارسی](/README_IR.md) | [Türkmençe](/README_TK.md)
|
||||
|
||||
<p><img src="https://denpiligrim.ru/storage/images/3dp-manager.png" alt="3dp-manager preview"></p>
|
||||
|
||||
 [](https://www.gnu.org/licenses/gpl-3.0) [](https://t.me/denpiligrim_web) [](https://www.youtube.com/@denpiligrim)
|
||||
|
||||
# 3DP-MANAGER
|
||||
|
||||
> [!WARNING]
|
||||
> **Это бета-версия!**
|
||||
>
|
||||
> Программа находится в активной разработке. Возможны баги, нестабильность и изменения API.
|
||||
> Используйте с осторожностью.
|
||||
Утилита для автогенерации инбаундов к панели [3x-ui](https://github.com/MHSanaei/3x-ui), формирования единой подписки и настройки перенаправления трафика с промежуточного сервера на основной.
|
||||
|
||||
3DP-MANAGER — утилита, которая позволяет регулярно генерировать входящие подключения для панели 3X-UI на основе списка разрешённых доменов (whitelist). Белый список общий, но вы также можете добавить свой собственный список, назвав его `my_whitelist.txt` и поместив его в папку `/opt/3dp-manager/app` на вашем сервере.
|
||||
Обсуждения доступны в Телеграм канале: [@denpiligrim_web](https://t.me/denpiligrim_web/719)
|
||||
**Поддержать проект**
|
||||
|
||||
### Установка
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/install.sh)
|
||||
```
|
||||
- Реквизиты / донаты:
|
||||
- Карта МИР: `2204320436318077`
|
||||
- Карта MasterCard: `5395452209474530`
|
||||
- PayPal: `vasiljevdenisx@gmail.com`
|
||||
- USDT | ETH (ERC20 | BEP20): `0x6fe140040f6Cdc1E1Ff2136cd1d60C0165809463`
|
||||
- USDT | TRX (TRC20): `TEWxXmJxvkAmhshp7E61XJGHB3VyM9hNAb`
|
||||
- Bitcoin: `bc1qctntwncsv2yn02x2vgnkrqm00c4h04c0afkgpl`
|
||||
- TON: `UQCZ3MiwyYHXftPItMMzJRYRiKHugr16jFMq2nfOQOOoemLy`
|
||||
- Bybit ID: `165292278`
|
||||
|
||||
### Обновление
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/update.sh)
|
||||
```
|
||||
## Описание
|
||||
|
||||
### Удаление
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/delete.sh)
|
||||
```
|
||||
Главная цель утилиты — сделать так, чтобы ваш трафик не выглядел одинаковым. Бот генерирует по заданному интервалу 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 сертификат (опционально)
|
||||
|
||||
---
|
||||
|
||||
Сервис подписок и перенаправления входящего трафика работает совместно с **3DP-MANAGER** и позволяет перенаправлять весь входящий трафик с промежуточного сервера на основной сервер. Перенаправляются те же порты: `443`, `8443` и диапазон `10000-60000`. Сервис также создаёт ссылку на подписку, автоматически заменяя IP-адрес или домен в конфигурациях. Перенаправления настраиваются добавлением правил iptables в конфигурационный файл ufw, что обеспечивает стабильную работу в сочетании с файрволом. Рекомендуется устанавливать сервис на чистый сервер без ранее настроенных правил.
|
||||
## Установка
|
||||
|
||||
Установите проект на сервер командой:
|
||||
|
||||
### Установка перенаправления
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/forwarding_install.sh)
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/install.sh)
|
||||
```
|
||||
|
||||
### Удаление перенаправления
|
||||
<small>Краткое описание: запускает скрипт установки и разворачивает контейнеры и сервисы.</small>
|
||||
|
||||
## Обновление
|
||||
|
||||
Обновление до последней версии:
|
||||
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/forwarding_delete.sh)
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)
|
||||
```
|
||||
|
||||
<small>Краткое описание: подтягивает последние изменения и перезапускает контейнеры.</small>
|
||||
|
||||
## Удаление
|
||||
|
||||
Полное удаление сервиса:
|
||||
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)
|
||||
```
|
||||
|
||||
<small>Краткое описание: удаляет контейнеры и файлы конфигурации, возвращая систему к состоянию до установки.</small>
|
||||
|
||||
---
|
||||
|
||||
### Показать URL подписки
|
||||
## Установка сервиса перенаправления (forwarding)
|
||||
|
||||
Сервис перенаправления позволяет проксировать входящие порты с промежуточного сервера на основной.
|
||||
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)
|
||||
```
|
||||
|
||||
<small>Краткое описание: добавляет правила перенаправления и создает сервис для обновления подписки.</small>
|
||||
|
||||
## Удаление перенаправления
|
||||
|
||||
```bash
|
||||
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)
|
||||
```
|
||||
|
||||
<small>Краткое описание: удаляет правила и отключает сервис перенаправления.</small>
|
||||
|
||||
---
|
||||
|
||||
## Показать URL подписки
|
||||
|
||||
Команда для вывода текущего URL подписки из среды контейнера:
|
||||
|
||||
```bash
|
||||
cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2
|
||||
```
|
||||
|
||||
---
|
||||
<small>Краткое описание: выводит статичный URL подписки, который можно использовать в клиентах. Работает как на оснвном, так и на промежуточном сервере.</small>
|
||||
|
||||
## Сбор доменов из мульти-подписок
|
||||
|
||||
Утилита извлекает домены из подписок и формирует `whitelist` для генератора.
|
||||
|
||||
### Утилита для сбора доменов из мульти-подписок
|
||||
Позволяет собирать домены из подписок с несколькими конфигурациями. В интернете встречается много подобных списков конфигураций, использующих белый SNI. Инструмент позволяет извлечь домены и подготовить готовый список для дальнейшего использования в генераторе входящих подключений.
|
||||
Вставьте ссылку на подписку в скрипт и запустите команду в окружении `Node.js`.
|
||||
```bash
|
||||
node get_domains.js
|
||||
```
|
||||
|
||||
### Использовать свой белый список
|
||||
Файл должен иметь структуру аналогичную `whitelist.txt`. Переименуйте имя файла на `my_whitelist.txt`. Загрузите файл в папку `/opt/3dp-manager/app` на сервере и выполните команду:
|
||||
<small>Краткое описание: добавьте ссылку на мульти-подписку в скрипт и запустите команду — на выходе получите список доменов. Неободим `Node.js` для работы скрипта.</small>
|
||||
|
||||
## Использование собственного белого списка
|
||||
|
||||
1. Подготовьте файл в формате `whitelist.txt`.
|
||||
2. Переименуйте на `my_whitelist.txt` и скопируйте в папку `/opt/3dp-manager/app`.
|
||||
|
||||
```bash
|
||||
cd /opt/3dp-manager && docker cp ./app/my_whitelist.txt node:/app/my_whitelist.txt
|
||||
```
|
||||
```
|
||||
|
||||
<small>Краткое описание: добавляет ваш файл доменов в контейнер приложения.</small>
|
||||
|
||||
---
|
||||
|
||||
## Замечания и текущие ограничения
|
||||
|
||||
- Общий список доменов работает не у всех провайдеров, поэтому рекомендуется составить и использовать свой whitelist.
|
||||
|
||||
---
|
||||
|
||||
## Внести вклад
|
||||
|
||||
Буду рад любому вкладу в разработку проекта! Простой процесс для контрибьюторов:
|
||||
|
||||
1. Форкните репозиторий на GitHub.
|
||||
2. Создайте ветку с осмысленным именем, например `feature/add-README` или `fix/whitelist-load`.
|
||||
3. Внесите изменения и добавьте короткое описание в коммите.
|
||||
4. Запустите локально базовые проверки (если есть).
|
||||
5. Отправьте ветку в ваш форк и создайте Pull Request в основной репозиторий.
|
||||
|
||||
<small>Советы: описывайте изменения в PR, указывайте цель и тестовые шаги. Если изменения большие — разделяйте на маленькие коммиты.</small>
|
||||
|
||||
---
|
||||
|
||||
## Обсуждение
|
||||
|
||||
- Телеграм: [@denpiligrim_web](https://t.me/denpiligrim_web)
|
||||
- Раздел Issues в данном репозитории
|
||||
Reference in New Issue
Block a user