From afb68a6e9b02de6f2ca347f09473c916ea31ef0a Mon Sep 17 00:00:00 2001
From: Denis Vasilev <89912505+vasiljevdenis@users.noreply.github.com>
Date: Tue, 23 Dec 2025 11:44:44 +0300
Subject: [PATCH] all languages
---
README_CN.md | 167 +++++++++++++++++++++++++++++++++++++++++++++++++++
README_EN.md | 149 ++++++++++++++++++++++++++++++++++++++-------
README_IR.md | 167 +++++++++++++++++++++++++++++++++++++++++++++++++++
README_TK.md | 155 +++++++++++++++++++++++++++++++++++++++++++++++
4 files changed, 616 insertions(+), 22 deletions(-)
create mode 100644 README_CN.md
create mode 100644 README_IR.md
create mode 100644 README_TK.md
diff --git a/README_CN.md b/README_CN.md
new file mode 100644
index 0000000..5740aad
--- /dev/null
+++ b/README_CN.md
@@ -0,0 +1,167 @@
+[Русский](/README.md) | [English](/README_EN.md) | [فارسی](/README_IR.md) | [Türkmençe](/README_TK.md)
+
+
+
+ [](https://www.gnu.org/licenses/gpl-3.0) [](https://t.me/denpiligrim_web) [](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/dp-fix/install.sh)
+```
+
+简要说明：运行安装脚本并部署容器和服务。
+
+## 更新
+
+更新到最新版本：
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)
+```
+
+简要说明：拉取最新更改并重启容器。
+
+## 删除
+
+彻底删除服务：
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)
+```
+
+简要说明：删除容器和配置文件，恢复到安装前状态。
+
+---
+
+## 安装转发服务（forwarding）
+
+转发服务允许将中继服务器的入站端口代理到主服务器。
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)
+```
+
+简要说明：添加转发规则并创建用于更新订阅的服务。
+
+## 删除转发
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)
+```
+
+简要说明：删除规则并禁用转发服务。
+
+---
+
+## 显示订阅 URL
+
+在容器环境中打印当前订阅 URL 的命令：
+
+```bash
+cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2
+```
+
+简要说明：打印可在客户端使用的静态订阅 URL，适用于主服务器和中继服务器。
+
+## 从多订阅收集域名
+
+该工具可从订阅中提取域名并为生成器构建 `whitelist`。
+
+```bash
+node get_domains.js
+```
+
+简要说明：在脚本中添加多订阅链接并运行命令 — 输出为域名列表。运行脚本需要 `Node.js`。
+
+## 使用自定义白名单
+
+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
+```
+
+简要说明：将您的域名文件添加到应用容器中。
+
+---
+
+## 注意与当前限制
+
+- 共享的域名列表可能并非对所有提供商都有效；建议准备并使用自定义 `whitelist`。
+
+---
+
+## 贡献
+
+欢迎贡献！简单的贡献流程：
+
+1. 在 GitHub 上 fork 仓库。
+2. 创建有意义的分支名，例如 `feature/add-README` 或 `fix/whitelist-load`。
+3. 提交更改并添加简短的提交信息。
+4. 在本地运行检查（如有）。
+5. 推送分支到您的 fork 并创建 Pull Request。
+
+建议：在 PR 中说明更改和测试步骤；较大更改请拆成小提交。
+
+---
+
+## 讨论
+
+- Telegram: [@denpiligrim_web](https://t.me/denpiligrim_web)
+- Issues
\ No newline at end of file
diff --git a/README_EN.md b/README_EN.md
index eadb1f4..e37473a 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -1,62 +1,167 @@
-[Русский](https://github.com/denpiligrim/3dp-manager/blob/dp-fix/README.md)
+[Русский](/README.md) | [中文](/README_CN.md) | [فارسی](/README_IR.md) | [Türkmençe](/README_TK.md)
+
+
+
+ [](https://www.gnu.org/licenses/gpl-3.0) [](https://t.me/denpiligrim_web) [](https://www.youtube.com/@denpiligrim)
# 3DP-MANAGER
-> [!WARNING]
-> **This is a beta version!**
->
-> The program is currently under active development. Bugs, instability, and API changes are possible.
-> Use with caution.
+A utility for auto-generating inbound connections for the [3x-ui](https://github.com/MHSanaei/3x-ui) panel, creating a single subscription URL, and configuring traffic forwarding from an intermediate server to the main server.
-3DP-MANAGER is a utility that allows you to regularly generate inbound connections for the 3X-UI panel based on a whitelist of domains. The whitelist is shared, but you can also add your own list by naming it `my_whitelist.txt` and adding it to the `/opt/3dp-manager/app` folder on your server.
-Discussions are available on the Telegram channel: [@denpiligrim_web](https://t.me/denpiligrim_web/719)
+**Support the project**
+
+- Donation / payment details:
+ - MIR card: `2204320436318077`
+ - MasterCard: `5395452209474530`
+ - PayPal: `vasiljevdenisx@gmail.com`
+ - USDT | ETH (ERC20 | BEP20): `0x6fe140040f6Cdc1E1Ff2136cd1d60C0165809463`
+ - USDT | TRX (TRC20): `TEWxXmJxvkAmhshp7E61XJGHB3VyM9hNAb`
+ - Bitcoin: `bc1qctntwncsv2yn02x2vgnkrqm00c4h04c0afkgpl`
+ - TON: `UQCZ3MiwyYHXftPItMMzJRYRiKHugr16jFMq2nfOQOOoemLy`
+ - Bybit ID: `165292278`
+
+## Description
+
+The main goal of the utility is to make your traffic appear non-uniform. The bot generates 10 connection entries at a configured interval with varying parameters:
+
+- Protocols: `vless`, `vmess`, `shadowsocks`, `trojan`;
+- Ports: `443`, `8443` (fixed) and random ports from the range `10000-60000`;
+- Transport: `tcp`, `websocket`, `grpc`, `xhttp`;
+- SNI values are taken from a whitelist of domains (`whitelist`); you can use your own list.
+
+All generated connections are combined into a single subscription with a static URL. The bot works with the `3x-ui` panel using its public API and does not directly modify the panel internals.
+
+The secondary goal is connection stability: the client receives 10 alternate connection options and can choose any of them.
+
+Additionally, the bot can be used in a cascading setup. The forwarding service will automatically configure the subscription and traffic redirection to the main server.
+
+Recommendations:
+
+- Use HTTPS for the subscription (domain + SSL certificate).
+- Set the generation interval to ≥ 10 minutes; for stability, once per day (1440 minutes) is recommended.
+- Configure the client to check for updates more frequently (for example, hourly) to stay synchronized with the server.
+
+## Features
+
+- Generates 10 diverse connection entries
+- Creates a single subscription with a static URL
+- Supports custom `whitelist` domains
+- Optional automatic configuration of traffic forwarding
+
+## Requirements
+
+- Ubuntu 20.04 or newer
+- `3x-ui` panel
+- Domain + SSL certificate (optional)
+
+---
+
+## Installation
+
+Install the project on your server with:
-### Install
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/install.sh)
```
-### Update
+Short description: runs the installer script and deploys containers and services.
+
+## Update
+
+Update to the latest version:
+
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)
```
-### Delete
+Short description: pulls the latest changes and restarts containers.
+
+## Removal
+
+Remove the service completely:
+
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)
```
+Short description: removes containers and configuration files, restoring the system to the pre-install state.
+
---
-The subscription and inbound redirection service works in conjunction with **3DP-MANAGER** and allows you to redirect all inbound traffic from the intermediate server to the main server. The same ports are redirected, namely `443`, `8443`, and the range `10000-60000`. The service also creates a link to the subscription, automatically replacing the IP address or domain in the configurations. Redirects are configured by adding iptables rules to the ufw configuration file, which ensures stable operation in conjunction with the firewall. It is recommended to install the service on a clean server without any previously installed rules.
-### Install forwarding
+## Install forwarding service
+
+The forwarding service allows proxying incoming ports from the intermediate server to the main server.
+
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)
```
-### Delete forwarding
+Short description: adds forwarding rules and creates a service to update the subscription.
+
+## Remove forwarding
+
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)
```
+Short description: removes rules and disables the forwarding service.
+
---
-### Show sub URL
+## Show subscription URL
+
+Command to print the current subscription URL from the container environment:
+
```bash
cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2
```
----
+Short description: prints the static subscription URL that can be used in clients. Works on both main and intermediate servers.
+
+## Collect domains from multi-subscriptions
+
+The utility extracts domains from subscriptions and builds a `whitelist` for the generator.
-### Utility for collecting domains from multi-subscriptions
-Allows you to collect domains from subscriptions with multiple configurations. There are many similar configuration lists circulating on the internet that use white SNI. The tool allows you to extract domains and prepare a ready-made list for further use in the inbound generator.
-Insert a subscription link into the script and run the command in the `Node.js` environment.
```bash
node get_domains.js
```
-### Use your whitelist
-The file should have a structure similar to `whitelist.txt`. Rename the file to `my_whitelist.txt`. Upload the file to the `/opt/3dp-manager/app` folder on the server and run the command:
+Short description: add a multi-subscription link to the script and run the command — the output will be a list of domains. `Node.js` is required to run the script.
+
+## Use your own whitelist
+
+1. Prepare a file in the format of `whitelist.txt`.
+2. Rename it to `my_whitelist.txt` and copy it into `/opt/3dp-manager/app`.
+
```bash
cd /opt/3dp-manager && docker cp ./app/my_whitelist.txt node:/app/my_whitelist.txt
-```
\ No newline at end of file
+```
+
+Short description: adds your domain file into the application container.
+
+---
+
+## Notes and current limitations
+
+- The shared domain list may not work with all providers; it is recommended to prepare and use your own `whitelist`.
+
+---
+
+## Contributing
+
+Contributions are welcome! Simple contributor workflow:
+
+1. Fork the repository on GitHub.
+2. Create a branch with a meaningful name, e.g. `feature/add-README` or `fix/whitelist-load`.
+3. Make changes and add a short commit message.
+4. Run local checks if available.
+5. Push the branch to your fork and create a Pull Request to the main repository.
+
+Tips: describe changes and testing steps in the PR. For large changes, split into smaller commits.
+
+---
+
+## Discussion
+
+- Telegram: [@denpiligrim_web](https://t.me/denpiligrim_web)
+- Issues
\ No newline at end of file
diff --git a/README_IR.md b/README_IR.md
new file mode 100644
index 0000000..22dd4ef
--- /dev/null
+++ b/README_IR.md
@@ -0,0 +1,167 @@
+[Русский](/README.md) | [English](/README_EN.md) | [中文](/README_CN.md) | [Türkmençe](/README_TK.md)
+
+
+
+ [](https://www.gnu.org/licenses/gpl-3.0) [](https://t.me/denpiligrim_web) [](https://www.youtube.com/@denpiligrim)
+
+# 3DP-MANAGER
+
+ابزاری برای تولید خودکار اتصالهای inbound برای پنل `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/dp-fix/install.sh)
+```
+
+توضیح کوتاه: اسکریپت نصب را اجرا کرده و کانتینرها و سرویسها را راهاندازی میکند.
+
+## بهروزرسانی
+
+برای بهروزرسانی به آخرین نسخه:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)
+```
+
+توضیح کوتاه: تغییرات جدید را میکشد و کانتینرها را ریاستارت میکند.
+
+## حذف
+
+برای حذف کامل سرویس:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)
+```
+
+توضیح کوتاه: کانتینرها و فایلهای پیکربندی را حذف میکند و سیستم را به وضعیت پیش از نصب برمیگرداند.
+
+---
+
+## نصب سرویس فورواردینگ (forwarding)
+
+سرویس فورواردینگ امکان پراکسی کردن پورتهای ورودی از سرور واسط به سرور اصلی را فراهم میکند.
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)
+```
+
+توضیح کوتاه: قوانین فورواردینگ را اضافه کرده و سرویسی برای بهروزرسانی اشتراک ایجاد میکند.
+
+## حذف فورواردینگ
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)
+```
+
+توضیح کوتاه: قوانین را حذف کرده و سرویس فورواردینگ را غیرفعال میکند.
+
+---
+
+## نمایش URL اشتراک
+
+دستور برای نمایش URL اشتراک فعلی در محیط کانتینر:
+
+```bash
+cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2
+```
+
+توضیح کوتاه: URL ثابت اشتراک را نمایش میدهد که میتوان در کلاینتها استفاده کرد. هم در سرور اصلی و هم در سرور واسط کار میکند.
+
+## جمعآوری دامنهها از چندین اشتراک
+
+ابزار دامنهها را از اشتراکهای دارای چندین پیکربندی استخراج کرده و `whitelist` تولید میکند.
+
+```bash
+node get_domains.js
+```
+
+توضیح کوتاه: لینک چندین اشتراک را در اسکریپت قرار داده و فرمان را اجرا کنید — خروجی فهرست دامنهها خواهد بود. نیازمند `Node.js` است.
+
+## استفاده از whitelist شخصی
+
+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
+```
+
+توضیح کوتاه: فایل دامنه شما را به کانتینر برنامه اضافه میکند.
+
+---
+
+## نکات و محدودیتهای فعلی
+
+- لیست عمومی دامنهها برای همه ارائهدهندگان کار نمیکند؛ پیشنهاد میشود `whitelist` خود را تهیه و استفاده کنید.
+
+---
+
+## مشارکت
+
+از هرگونه مشارکت در توسعه پروژه خوشحال میشوم! روند ساده برای مشارکتکنندگان:
+
+1. مخزن را در GitHub fork کنید.
+2. شاخهای با نام معنادار ایجاد کنید مانند `feature/add-README` یا `fix/whitelist-load`.
+3. تغییرات را اعمال کرده و یک پیام کوتاه در کامیت اضافه کنید.
+4. در صورت وجود، بررسیهای محلی را اجرا کنید.
+5. شاخه را به fork خود پوش کرده و Pull Request ایجاد کنید.
+
+نکات: تغییرات را در PR شرح دهید و مراحل تست را بنویسید. در صورت تغییرات بزرگ، آنها را به کامیتهای کوچک تقسیم کنید.
+
+---
+
+## بحث
+
+- تلگرام: [@denpiligrim_web](https://t.me/denpiligrim_web)
+- Issues
\ No newline at end of file
diff --git a/README_TK.md b/README_TK.md
new file mode 100644
index 0000000..656e48e
--- /dev/null
+++ b/README_TK.md
@@ -0,0 +1,155 @@
+[Русский](/README.md) | [English](/README_EN.md) | [中文](/README_CN.md) | [فارسی](/README_IR.md)
+
+
+
+ [](https://www.gnu.org/licenses/gpl-3.0) [](https://t.me/denpiligrim_web) [](https://www.youtube.com/@denpiligrim)
+
+# 3DP-MANAGER
+
+Bu gural `3x-ui` paneli üçin awtomatiki ýagdaýda inbound baglanyşlaryny döredýär, birleşdirilen abunany (subscription) döretmäge we aragatnaşyk serwerinden esasy servere trafigiň ugradylyşyny sazlamaga kömek edýär.
+
+**Taslamany goldaň**
+
+- Töleg / goşant maglumatlary:
+ - MIR kart: `2204320436318077`
+ - MasterCard: `5395452209474530`
+ - PayPal: `vasiljevdenisx@gmail.com`
+ - USDT | ETH (ERC20 | BEP20): `0x6fe140040f6Cdc1E1Ff2136cd1d60C0165809463`
+ - USDT | TRX (TRC20): `TEWxXmJxvkAmhshp7E61XJGHB3VyM9hNAb`
+ - Bitcoin: `bc1qctntwncsv2yn02x2vgnkrqm00c4h04c0afkgpl`
+ - TON: `UQCZ3MiwyYHXftPItMMzJRYRiKHugr16jFMq2nfOQOOoemLy`
+ - Bybit ID: `165292278`
+
+## Düşündiriş
+
+Esasy maksady trafigiňizi birmeňzeş bolmaz ýaly etmekdir. Bot bellenen aralykda dürli parametrler bilen 10 sany baglanyşygy döredýär:
+
+- Protokollar: `vless`, `vmess`, `shadowsocks`, `trojan`;
+- Portlar: `443`, `8443` (hemişelik) we `10000-60000` aralygyndan tötänleýin portlar;
+- Transport: `tcp`, `websocket`, `grpc`, `xhttp`;
+- SNI `whitelist` domen sanawyndan alynýar; öz sanawyňyzy hem ulanyp bilersiňiz.
+
+Ähli döredilen baglanyşyklary biri-birine birleşdirip, statik URL bilen bir abuna döredilýär. Bot `3x-ui` paneliniň açyk API-sini ulanýar we paneliň içki konfigurasiýasyna gönüden-göni aralaşmaýar.
+
+Ikinji maksady baglanyşygyň durnuklylygyny ýokarlandyrmakdyr: müşderi 10 dürli baglanyşyk opsiýasyny alýar we islese haýsyny islese saýlap bilýär.
+
+Göçürme (forwarding) hyzmaty bilen birleşdirilende, bot abonnament we trafik diňe esasy servere ugradylyşyny awtomatiki sazlar.
+
+Maslahatchylyklar:
+
+- Abuna üçin HTTPS ulanyň (domain + SSL şahadatnamasy).
+- Dörediş aralygyny ≥ 10 minut goýuň; durnuklylyk üçin her gün bir gezek (1440 minut) maslahat berilýär.
+- Müşderide awtomatiki täzelenmäni ýygylaşdyryň (meselem, her sagat) — serwera sazlaşyklylyk üçin.
+
+## Imkançylyklar
+
+- 10 dürli baglanyşygy öndürýär
+- Statik URL bilen bir abuna döredýär
+- Öz `whitelist` domenleriňizi goldaýar
+- Trafigiň awtomatik forwarding sazlamalary (islege bagly)
+
+## Talaplar
+
+- Ubuntu 20.04 ýa-da täze
+- `3x-ui` paneli
+- Domain + SSL şahadatnamasy (islege bagly)
+
+---
+
+## Gurnama
+
+Taslamany serwera gurnamak üçin şu komandany ýerine ýetiriň:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/install.sh)
+```
+
+Gysgaça: gurnama skripti işledilýär we konteýnerler we hyzmatlar döredilýär.
+
+## Täzelik
+
+Soňky wersiýa çenli täzeläň:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/update.sh)
+```
+
+Gysgaça: iň soňky üýtgeşmeleri çekýär we konteýnerleri gaýtadan işledýär.
+
+## Pozmak
+
+Hyzmaty doly pozmak üçin:
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/delete.sh)
+```
+
+Gysgaça: konteýnerleri we konfigurasiýa faýllaryny pozup, systemany gurnamadan öňki ýagdaýyna getirer.
+
+---
+
+## Forwarding hyzmatyny gurnamak
+
+Forwarding hyzmaty aragatnaşyk serwerinden esasy servere gelýän portlary proxy arkaly geçirýär.
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_install.sh)
+```
+
+## Forwarding-i pozmak
+
+```bash
+bash <(curl -fsSL https://raw.githubusercontent.com/denpiligrim/3dp-manager/dp-fix/forwarding_delete.sh)
+```
+
+---
+
+## Abuna URL-ni görkezmek
+
+Konteýner gurşawynda häzirki abuna URL-ni görkezýän komanda:
+
+```bash
+cd /opt/3dp-manager && docker compose exec node env | grep SUB_URL | cut -d'=' -f2
+```
+
+## Multi-abunalardan domenleri toplamak
+
+Gural birden köp konfigurasiýa içeren abunalardan domenleri çykaryp `whitelist` düzýär.
+
+```bash
+node get_domains.js
+```
+
+## Öz `whitelist`-iňizi ulanmak
+
+1. `whitelist.txt` bilen meňzeş struktura eýe faýl taýýarlaň.
+2. Ony `my_whitelist.txt` diýip atlandyryp `/opt/3dp-manager/app` içine göçüriň.
+
+```bash
+cd /opt/3dp-manager && docker cp ./app/my_whitelist.txt node:/app/my_whitelist.txt
+```
+
+---
+
+## Bellikler we çäklendirmeler
+
+- Umumy domen sanawy ähli üpjün edijilerde işlemeýär; öz `whitelist`-iňizi düzmegiňizi maslahat berýäris.
+
+---
+
+## Goşanty
+
+Proýekte goşant bermäge hoş geldiňiz! Goşant prosesi ýönekeý:
+
+1. GitHub-da repo-ny fork ediň.
+2. Meni manly at bilen şahamça (branch) dörediň, meselem `feature/add-README` ýa-da `fix/whitelist-load`.
+3. Üýtgeşmeleri giriziň we gysga commit ýazmagy unutmaň.
+4. Lokal barlaglary işlediň (bardy bolsa).
+5. Şahamçany fork-a iteriň we Pull Request dörediň.
+
+---
+
+## Çeperdeşlik
+
+- Telegram: [@denpiligrim_web](https://t.me/denpiligrim_web)
+- Issues
\ No newline at end of file