ntb-67-client 0.1.0__tar.gz

ntb_67_client-0.1.0/LICENSE

@@ -0,0 +1,25 @@
+NTB-67 SOURCE-AVAILABLE COMMERCIAL LICENSE
+Copyright (c) 2026 Timur Zolotov (netbiom)
+
+1. PERMITTED USE
+The Licensor hereby grants permission to individuals, educational institutions, 
+and non-profit organizations to use, copy, modify, and distribute the source 
+code of ntb-67 free of charge solely for personal, educational, or hobby use.
+
+2. COMMERCIAL RESTRICTIONS
+Any use of this software for commercial purposes, including but not limited to:
+- Running the software within the IT infrastructure of corporate entities, startups, or legal domains;
+- Using the software to provide paid services to third parties;
+is strictly PROHIBITED without a valid Paid Subscription (Commercial License).
+
+3. PRICING AND INQUIRIES
+The cost of the Commercial License is determined by the Licensor. Current subscription 
+rates, volume discounts, and accepted payment methods (including stablecoins like USDT/USDC) 
+are provided upon request. 
+
+To inquire about purchasing a Commercial License or to request a crypto invoice, please contact:
+- Telegram: https://t.me/netbiom
+
+4. TERMINATION
+Any commercial use of this software without an active paid subscription constitutes 
+copyright infringement and automatically terminates all rights granted under this license.

ntb_67_client-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: ntb-67-client
+Version: 0.1.0
+Summary: Asyncio Tunneling Proxy Client — alternative for ngrok/localtunnel
+Author-email: "Timur Zolotov (netbiom)" <helloworldbooo@gmail.com>
+License: NTB-67 Source-Available Commercial License
+Project-URL: Homepage, https://github.com/TZbooo/ntb-67
+Project-URL: Telegram Support, https://t.me/netbiom
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ntb-67
+
+[English](#english) | [Русский](#русский)
+
+---
+
+## English
+
+### 🚧 Under Construction (Work in Progress)
+
+This project is currently in the **active development stage**. It is essentially a clean canvas where core mechanics, architecture, and features are being built from scratch. 
+
+* **No docs yet:** We haven't written detailed instructions, setup guides, or user manuals because everything is shifting and changing daily.
+* **No UX guarantees:** The project is absolutely not ready for end-users or a smooth user experience. Expect bugs, broken endpoints, and incomplete features.
+* **For developers:** If you stumbled upon this repository, feel free to look around the source code, but do so at your own risk. 
+
+As soon as the foundation becomes stable, a proper, comprehensive `README.md` with installation and usage instructions will be provided. Thanks for understanding!
+
+---
+
+## Русский
+
+### 🚧 В процессе разработки (Work in Progress)
+
+Этот проект сейчас находится в стадии **активной чистой разработки**. На данном этапе закладывается архитектура, базовая логика и ключевой функционал.
+
+* **Инструкций пока нет:** Мы намеренно не пишем подробные руководства по установке и настройке, так как кодовая база и структура проекта меняются каждый день.
+* **Никаких гарантий стабильности:** Проект абсолютно не готов для конечного пользователя (UX). Всё может ломаться, падать или быть недописанным — это нормальное состояние для текущего этапа.
+* **Для любопытных:** Если вы заглянули в этот репозиторий, вы можете изучить исходный код, но учитывайте, что «из коробки» сейчас ничего стабильно не работает.
+
+Как только проект обретет стабильную форму и базовый каркас будет готов, мы обязательно добавим полноценный `README.md` с инструкциями по запуску. Спасибо за понимание!

ntb_67_client-0.1.0/README.md

@@ -0,0 +1,31 @@
+# ntb-67
+
+[English](#english) | [Русский](#русский)
+
+---
+
+## English
+
+### 🚧 Under Construction (Work in Progress)
+
+This project is currently in the **active development stage**. It is essentially a clean canvas where core mechanics, architecture, and features are being built from scratch. 
+
+* **No docs yet:** We haven't written detailed instructions, setup guides, or user manuals because everything is shifting and changing daily.
+* **No UX guarantees:** The project is absolutely not ready for end-users or a smooth user experience. Expect bugs, broken endpoints, and incomplete features.
+* **For developers:** If you stumbled upon this repository, feel free to look around the source code, but do so at your own risk. 
+
+As soon as the foundation becomes stable, a proper, comprehensive `README.md` with installation and usage instructions will be provided. Thanks for understanding!
+
+---
+
+## Русский
+
+### 🚧 В процессе разработки (Work in Progress)
+
+Этот проект сейчас находится в стадии **активной чистой разработки**. На данном этапе закладывается архитектура, базовая логика и ключевой функционал.
+
+* **Инструкций пока нет:** Мы намеренно не пишем подробные руководства по установке и настройке, так как кодовая база и структура проекта меняются каждый день.
+* **Никаких гарантий стабильности:** Проект абсолютно не готов для конечного пользователя (UX). Всё может ломаться, падать или быть недописанным — это нормальное состояние для текущего этапа.
+* **Для любопытных:** Если вы заглянули в этот репозиторий, вы можете изучить исходный код, но учитывайте, что «из коробки» сейчас ничего стабильно не работает.
+
+Как только проект обретет стабильную форму и базовый каркас будет готов, мы обязательно добавим полноценный `README.md` с инструкциями по запуску. Спасибо за понимание!

ntb_67_client-0.1.0/client/__init__.py

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom

ntb_67_client-0.1.0/client/cli.py

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom

ntb_67_client-0.1.0/client/tunnel_client.py

@@ -0,0 +1,179 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom
+
+"""Клиентское приложение для динамического подключения к серверу маршрутизации.
+
+Данный модуль отвечает за авторизацию поддомена на сервере, обработку сигналов
+выделения дата-каналов и проброс входящих пакетов на локальный порт разработчика.
+"""
+
+import argparse
+import asyncio
+import sys
+
+from common.utils import close_writer, pipe
+
+
+class NTBClient:
+    """Клиент туннелирования с поддержкой динамических поддоменов."""
+
+    def __init__(self, server_host: str, server_port: int, local_port: int) -> None:
+        """Инициализирует NTBClient."""
+
+        self.server_host = server_host
+        self.server_port = server_port
+        self.local_port = local_port
+        self.subdomain = None
+
+    async def open_connection(self) -> tuple[asyncio.StreamReader, asyncio.StreamWriter]:
+        """Хелпер для быстрого открытия TCP-соединения до сервера."""
+
+        return await asyncio.open_connection(self.server_host, self.server_port)
+
+    async def start(self) -> None:
+        """Запускает бесконечный цикл удержания управляющего соединения."""
+
+        while True:
+            try:
+                await self._start_tunnel()
+            except Exception as e:
+                print(f"❌ Ошибка соединения с сервером: {e}")
+                print("⏳ Переподключение через 5 секунд...")
+                await asyncio.sleep(5)
+
+    async def _start_tunnel(self) -> None:
+        """Устанавливает управляющий канал и слушает команды от сервера."""
+
+        reader, writer = await self.open_connection()
+        
+        if self.subdomain:
+            # Отправляем запрос на инициализацию с указанием поддомена
+            writer.write(f"INIT:{self.subdomain}\n".encode('utf-8'))
+            await writer.drain()
+        else:
+            # Отправляем запрос на инициализацию без указания поддомена
+            writer.write(b"INIT\n")
+            await writer.drain()
+
+        # Ждем ответ от сервера с назначенным UUID/хэшем
+        response_bytes = await reader.readline()
+        if not response_bytes:
+            await close_writer(writer)
+            return
+
+        response = response_bytes.decode('utf-8').strip()
+        if response.startswith("ASSIGNED:"):
+            self.subdomain = response.split(":", 1)[1].strip()
+            
+            print("\n" + "="*50)
+            print(f"🎉 Туннель успешно запущен!")
+            print(f"🔗 Публичный адрес:  https://{self.subdomain}.24tunl.ru")
+            print(f"🏠 Локальный порт:   http://127.0.0.1:{self.local_port}")
+            print("="*50 + "\n")
+        else:
+            print("❌ Сервер отказал в инициализации туннеля.")
+            await close_writer(writer)
+            return
+
+        # Запускаем фоновую задачу для пинга
+        heartbeat_task = asyncio.create_task(self.start_heartbeat(writer))
+
+        try:
+            while True:
+                line_bytes = await reader.readline()
+                if not line_bytes:
+                    break
+
+                cmd = line_bytes.decode('utf-8').strip()
+                if cmd == "REQUEST_CONN":
+                    # Ссылаемся на правильное имя метода: spawn_data_connection
+                    asyncio.create_task(self.spawn_data_connection())
+        finally:
+            heartbeat_task.cancel()
+            await close_writer(writer)
+
+    async def spawn_data_connection(self) -> None:
+        """Создает новый выделенный дата-канал для конкретного HTTP-запроса."""
+
+        try:
+            # Открываем сокет к серверу туннелирования
+            server_reader, server_writer = await self.open_connection()
+            
+            # Маркируем сокет, чтобы сервер понял, какому поддомену он принадлежит
+            server_writer.write(f"DATA:{self.subdomain}\n".encode('utf-8'))
+            await server_writer.drain()
+
+            # Открываем сокет к нашему локальному сайту/серверу (например, к порту 3000 или 80)
+            local_reader, local_writer = await asyncio.open_connection('127.0.0.1', self.local_port)
+
+        except Exception as e:
+            print(f"❌ Не удалось связать дата-каналы: {e}")
+            return
+
+        # Начинаем качать байты в обе стороны
+        await asyncio.gather(
+            pipe(server_reader, local_writer),
+            pipe(local_reader, server_writer)
+        )
+
+    async def start_heartbeat(self, writer: asyncio.StreamWriter) -> None:
+        """Каждые 10 секунд шлет PING, защищая сокет от молчаливого дропа файрволами."""
+
+        try:
+            while True:
+                await asyncio.sleep(10)
+                writer.write(b'PING\n')
+                await writer.drain()
+        except Exception:
+            pass
+
+
+def main() -> None:
+    """Точка входа для консольного запуска утилиты."""
+
+    parser = argparse.ArgumentParser(
+        description="ntb-67 — Скоростной асинхронный туннель для локальных портов."
+    )
+    # Позиционный аргумент: порт локального веб-сервера
+    parser.add_argument(
+        "local_port",
+        type=int,
+        help="Локальный порт, который необходимо пробросить наружу (например, 8000)"
+    )
+    # Опциональный аргумент для смены хоста сервера туннелей
+    parser.add_argument(
+        "--host",
+        type=str,
+        default="24tunl.ru",
+        help="Хост удаленного сервера NTB (дефолт: 24tunl.ru)"
+    )
+    # Опциональный аргумент для порта сервера туннелей
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=9000,
+        help="Управляющий порт удаленного сервера NTB (дефолт: 9000)"
+    )
+
+    args = parser.parse_args()
+
+    try:
+        client = NTBClient(
+            server_host=args.host,
+            server_port=args.port,
+            local_port=args.local_port
+        )
+        asyncio.run(client.start())
+    except KeyboardInterrupt:
+        print("\n👋 Туннель закрыт пользователем. До встречи!")
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

ntb_67_client-0.1.0/common/__init__.py

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom

ntb_67_client-0.1.0/common/protocol.py

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom

ntb_67_client-0.1.0/common/utils.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+# ntb-67 — Asyncio Tunneling Proxy Server
+# Copyright (c) 2026 Timur Zolotov (netbiom). All rights reserved.
+# 
+# This source code is licensed under the NTB-67 Source-Available Commercial License.
+# Commercial use requires a valid paid subscription. 
+# See the LICENSE file in the root directory for full terms and conditions.
+# For commercial inquiries, contact Telegram: https://t.me/netbiom
+
+import asyncio
+
+
+async def close_writer(writer: asyncio.StreamWriter) -> None:
+    """Безопасно закрывает StreamWriter, игнорируя возможные ошибки."""
+
+    writer.close()
+    try:
+        await writer.wait_closed()
+    except Exception:
+        pass
+
+
+async def pipe(reader: asyncio.StreamReader, writer: asyncio.StreamWriter) -> None:
+    """Односторонняя перекачка байт reader → writer до EOF или ошибки."""
+
+    try:
+        while True:
+            data = await reader.read(4096)
+            if not data:
+                break
+            writer.write(data)
+            await writer.drain()
+    except Exception:
+        pass
+    finally:
+        await close_writer(writer)

ntb_67_client-0.1.0/ntb_67_client.egg-info/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: ntb-67-client
+Version: 0.1.0
+Summary: Asyncio Tunneling Proxy Client — alternative for ngrok/localtunnel
+Author-email: "Timur Zolotov (netbiom)" <helloworldbooo@gmail.com>
+License: NTB-67 Source-Available Commercial License
+Project-URL: Homepage, https://github.com/TZbooo/ntb-67
+Project-URL: Telegram Support, https://t.me/netbiom
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ntb-67
+
+[English](#english) | [Русский](#русский)
+
+---
+
+## English
+
+### 🚧 Under Construction (Work in Progress)
+
+This project is currently in the **active development stage**. It is essentially a clean canvas where core mechanics, architecture, and features are being built from scratch. 
+
+* **No docs yet:** We haven't written detailed instructions, setup guides, or user manuals because everything is shifting and changing daily.
+* **No UX guarantees:** The project is absolutely not ready for end-users or a smooth user experience. Expect bugs, broken endpoints, and incomplete features.
+* **For developers:** If you stumbled upon this repository, feel free to look around the source code, but do so at your own risk. 
+
+As soon as the foundation becomes stable, a proper, comprehensive `README.md` with installation and usage instructions will be provided. Thanks for understanding!
+
+---
+
+## Русский
+
+### 🚧 В процессе разработки (Work in Progress)
+
+Этот проект сейчас находится в стадии **активной чистой разработки**. На данном этапе закладывается архитектура, базовая логика и ключевой функционал.
+
+* **Инструкций пока нет:** Мы намеренно не пишем подробные руководства по установке и настройке, так как кодовая база и структура проекта меняются каждый день.
+* **Никаких гарантий стабильности:** Проект абсолютно не готов для конечного пользователя (UX). Всё может ломаться, падать или быть недописанным — это нормальное состояние для текущего этапа.
+* **Для любопытных:** Если вы заглянули в этот репозиторий, вы можете изучить исходный код, но учитывайте, что «из коробки» сейчас ничего стабильно не работает.
+
+Как только проект обретет стабильную форму и базовый каркас будет готов, мы обязательно добавим полноценный `README.md` с инструкциями по запуску. Спасибо за понимание!

ntb_67_client-0.1.0/ntb_67_client.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+client/__init__.py
+client/cli.py
+client/tunnel_client.py
+common/__init__.py
+common/protocol.py
+common/utils.py
+ntb_67_client.egg-info/PKG-INFO
+ntb_67_client.egg-info/SOURCES.txt
+ntb_67_client.egg-info/dependency_links.txt
+ntb_67_client.egg-info/entry_points.txt
+ntb_67_client.egg-info/top_level.txt

ntb_67_client-0.1.0/ntb_67_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ntb_67_client-0.1.0/ntb_67_client.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ntb-client = client.tunnel_client:main

ntb_67_client-0.1.0/ntb_67_client.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+client
+common

ntb_67_client-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ntb-67-client"
+version = "0.1.0"
+description = "Asyncio Tunneling Proxy Client — alternative for ngrok/localtunnel"
+readme = "README.md"
+authors = [
+    { name = "Timur Zolotov (netbiom)", email = "helloworldbooo@gmail.com" }
+]
+license = { text = "NTB-67 Source-Available Commercial License" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.10"
+dependencies = [] # Если появятся внешние библиотеки вроде httpx, пишите их сюда
+
+[project.urls]
+Homepage = "https://github.com/TZbooo/ntb-67"
+"Telegram Support" = "https://t.me/netbiom"
+
+[project.scripts]
+ntb-client = "client.tunnel_client:main"
+
+[tool.setuptools]
+packages = ["client", "common"]

ntb_67_client-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+