Merge pull request #1 from denpiligrim/dp-fix

Stable release v1.0

Author: denpiligrim

README.md

@@ -1,63 +1,168 @@
-[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>
+
+![Version](https://img.shields.io/badge/version-1.0-blue.svg) [![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=flat&logo=telegram&logoColor=white)](https://t.me/denpiligrim_web) [![YouTube Channel Subscribers](https://img.shields.io/youtube/channel/subscribers/UCOv2tFFYDY4mXOM60PVz8zw)](https://www.youtube.com/@denpiligrim)
 
 # 3DP-MANAGER
 
-> [!WARNING]
-> **Это бета-версия!**
->
-> Программа находится в активной разработке. Возможны баги, нестабильность и изменения API.
-> Используйте с осторожностью.
+Утилита для автогенерации инбаундов к панели [3x-ui](https://github.com/MHSanaei/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` доменов
+- Автоматическая настройка перенаправления трафика (опционально)
 
-3DP-MANAGER — утилита, которая позволяет регулярно генерировать входящие подключения для панели 3X-UI на основе списка разрешённых доменов (whitelist). Белый список общий, но вы также можете добавить свой собственный список, назвав его `my_whitelist.txt` и поместив его в папку `/opt/3dp-manager/app` на вашем сервере.
-Обсуждения доступны в Телеграм канале: [@denpiligrim_web](https://t.me/denpiligrim_web/719)
+## Требования
+
+- Ubuntu 20.04 (и выше)
+- Панель `3x-ui`
+- Домен + SSL сертификат (опционально)
+
+---
+
+## Установка
+
+Установите проект на сервер командой:
 
-### Установка
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/install.sh)
 ```
 
-### Обновление
+<small>Краткое описание: запускает скрипт установки и разворачивает контейнеры и сервисы.</small>
+
+## Обновление
+
+Обновление до последней версии:
+
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/update.sh)
 ```
 
-### Удаление
+<small>Краткое описание: подтягивает последние изменения и перезапускает контейнеры.</small>
+
+## Удаление
+
+Полное удаление сервиса:
+
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/delete.sh)
 ```
 
+<small>Краткое описание: удаляет контейнеры и файлы конфигурации, возвращая систему к состоянию до установки.</small>
+
 ---
 
-Сервис подписок и перенаправления входящего трафика работает совместно с **3DP-MANAGER** и позволяет перенаправлять весь входящий трафик с промежуточного сервера на основной сервер. Перенаправляются те же порты: `443`, `8443` и диапазон `10000-60000`. Сервис также создаёт ссылку на подписку, автоматически заменяя IP-адрес или домен в конфигурациях. Перенаправления настраиваются добавлением правил iptables в конфигурационный файл ufw, что обеспечивает стабильную работу в сочетании с файрволом. Рекомендуется устанавливать сервис на чистый сервер без ранее настроенных правил.
+## Установка сервиса перенаправления (forwarding)
+
+Сервис перенаправления позволяет проксировать входящие порты с промежуточного сервера на основной.
 
-### Установка перенаправления
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/forwarding_install.sh)
 ```
 
-### Удаление перенаправления
+<small>Краткое описание: добавляет правила перенаправления и создает сервис для обновления подписки.</small>
+
+## Удаление перенаправления
+
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/forwarding_delete.sh)
 ```
 
+<small>Краткое описание: удаляет правила и отключает сервис перенаправления.</small>
+
 ---
 
-### Показать URL подписки
+## Показать 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>Краткое описание: добавляет ваш файл доменов в контейнер приложения. Чтобы сразу же сгенерировать инбаунды с новыи списком, выполните `docker exec -it node sh` и затем `node index.js`.</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 в данном репозитории

README_CN.md

@@ -0,0 +1,167 @@
+[Русский](/README.md) | [English](/README_EN.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>
+
+![Version](https://img.shields.io/badge/version-1.0-blue.svg) [![License](https://img.shields.io/badge/license-GPL%20V3-blue.svg?longCache=true)](https://www.gnu.org/licenses/gpl-3.0) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=flat&logo=telegram&logoColor=white)](https://t.me/denpiligrim_web) [![YouTube Channel Subscribers](https://img.shields.io/youtube/channel/subscribers/UCOv2tFFYDY4mXOM60PVz8zw)](https://www.youtube.com/@denpiligrim)
+
+# 3DP-MANAGER
+
+这是一个用于为 `3x-ui` 面板自动生成入站连接、生成统一订阅并将流量从中继服务器转发到主服务器的实用工具。
+
+**支持项目**
+
+- 捐助/支付信息：
+  - MIR 卡: `2204320436318077`
+  - MasterCard: `5395452209474530`
+  - PayPal: `vasiljevdenisx@gmail.com`
+  - USDT | ETH (ERC20 | BEP20): `0x6fe140040f6Cdc1E1Ff2136cd1d60C0165809463`
+  - USDT | TRX (TRC20): `TEWxXmJxvkAmhshp7E61XJGHB3VyM9hNAb`
+  - 比特币: `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
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/install.sh)
+```
+
+<small>简要说明：运行安装脚本并部署容器和服务。</small>
+
+## 更新
+
+更新到最新版本：
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/update.sh)
+```
+
+<small>简要说明：拉取最新更改并重启容器。</small>
+
+## 删除
+
+彻底删除服务：
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/delete.sh)
+```
+
+<small>简要说明：删除容器和配置文件，恢复到安装前状态。</small>
+
+---
+
+## 安装转发服务（forwarding）
+
+转发服务允许将中继服务器的入站端口代理到主服务器。
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/forwarding_install.sh)
+```
+
+<small>简要说明：添加转发规则并创建用于更新订阅的服务。</small>
+
+## 删除转发
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/main/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`。
+
+```bash
+node get_domains.js
+```
+
+<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 上 fork 仓库。
+2. 创建有意义的分支名，例如 `feature/add-README` 或 `fix/whitelist-load`。
+3. 提交更改并添加简短的提交信息。
+4. 在本地运行检查（如有）。
+5. 推送分支到您的 fork 并创建 Pull Request。
+
+<small>建议：在 PR 中说明更改和测试步骤；较大更改请拆成小提交。</small>
+
+---
+
+## 讨论
+
+- Telegram: [@denpiligrim_web](https://t.me/denpiligrim_web)
+- Issues