🧅 Web3 Tor Browser - Revolutionary Telegram Web App

Полноценный анонимный Tor браузер прямо в Telegram с поддержкой множественных пользователей и Web3 интеграцией

📖 Обзор проекта

Web3 Tor Browser - это прорывное решение, которое объединяет анонимность Tor сети, удобство Telegram Web App и мощь Web3 технологий. Проект создает полноценный браузер, работающий прямо в интерфейсе Telegram, обеспечивая максимальную приватность и безопасность для множественных пользователей одновременно.

🎆 Революционные особенности:

🔥 Нативная интеграция с Telegram - Полноценный браузер без внешних приложений
👥 Масштабируемая мультипользовательская архитектура - До 50 изолированных сессий
🔒 Абсолютная Tor анонимность - Весь трафик только через Tor сеть
🌍 Enterprise-grade Web3 - Полная поддержка криптокошельков и DeFi
🚫 Zero-logs политика - Никаких сохранений данных или истории
⚡ Автоматическое управление - Интеллектуальная очистка и оптимизация

🎯 Цель: Создание первого в мире полноценного многопользовательского анонимного браузера, интегрированного напрямую в Telegram с поддержкой Web3 экосистемы.

🌟 Ключевые особенности

👥 Множественные пользователи

Одновременные сессии: До 50 общих сессий, по 3 на пользователя
Изоляция: Каждая сессия полностью изолирована
Управление лимитами: Гибкая настройка ограничений
Автоочистка: Автоматическое удаление неактивных сессий

🧅 Telegram Web App

Нативная интеграция: Работает прямо в Telegram без VNC
Мобильная оптимизация: Адаптивный интерфейс для всех устройств
Быстрый запуск: Мгновенное создание браузерных сессий
Полный UI: Адресная строка, навигация, скриншоты

🔒 Безопасность и приватность

100% Tor трафик: Весь трафик через Tor сеть
Блокировка трекеров: Автоматическая защита от аналитики
Отсутствие логов: Никаких сохранений истории
Временные сессии: Полная очистка после завершения

🌍 Web3 интеграция

MetaMask поддержка: Подключение криптокошельков
Multi-chain: Ethereum, Polygon, BSC, Arbitrum
DeFi готовность: Работа с децентрализованными приложениями

🏗️ Архитектура

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Telegram Bot  │───▶│   Node.js API    │───▶│  Docker Engine  │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │                         │
                                ▼                         ▼
                       ┌──────────────────┐    ┌─────────────────┐
                       │   Web3 Service   │    │  Tor Containers │
                       └──────────────────┘    └─────────────────┘
                                                         │
                                                         ▼
                                              ┌─────────────────┐
                                              │   VNC Server    │
                                              └─────────────────┘

📋 Требования

Системные требования

ОС: Ubuntu 20.04+ / Debian 11+ / CentOS 8+
RAM: Минимум 4GB (рекомендуется 8GB+)
CPU: 2+ ядра
Диск: 20GB+ свободного места
Сеть: Стабильное интернет-соединение

Программное обеспечение

Docker 20.10+
Docker Compose 2.0+
Node.js 18+
Git

🚀 Быстрая установка

1. Клонирование репозитория

git clone https://github.com/yourusername/web3-tor-browser-app.git
cd web3-tor-browser-app

2. Установка зависимостей

# Установка Node.js зависимостей
npm install

# Установка Docker (если не установлен)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

3. Настройка конфигурации

# Копирование примера конфигурации
cp .env.example .env

# Редактирование конфигурации
nano .env

4. Создание Telegram бота

Найдите @BotFather в Telegram
Отправьте /newbot
Следуйте инструкциям для создания бота
Получите токен и добавьте в файл .env:

TELEGRAM_BOT_TOKEN=your_bot_token_here

5. Сборка Docker образа

# Сборка образа Tor браузера
docker build -t tor-browser-app -f docker/Dockerfile .

# Или использование Docker Compose
docker-compose build

6. Запуск приложения

# Запуск в режиме разработки
npm run dev

# Или запуск через Docker Compose
docker-compose up -d

⚙️ Детальная настройка

Переменные окружения

Основные настройки

# Основные параметры
NODE_ENV=production
PORT=3000
BASE_URL=https://yourdomain.com

# Telegram Bot
TELEGRAM_BOT_TOKEN=your_telegram_bot_token

Web3 настройки

# RPC провайдеры (опционально)
ETHEREUM_RPC=https://mainnet.infura.io/v3/YOUR_PROJECT_ID
POLYGON_RPC=https://polygon-rpc.com/
BSC_RPC=https://bsc-dataseed.binance.org/
ARBITRUM_RPC=https://arb1.arbitrum.io/rpc

Безопасность

# Секретные ключи
JWT_SECRET=your_32_character_secret_key_here
ENCRYPTION_KEY=your_32_character_encryption_key
REDIS_PASSWORD=your_secure_redis_password

Настройка SSL/TLS

Получите SSL сертификат (Let's Encrypt рекомендуется):

sudo apt install certbot
sudo certbot certonly --standalone -d yourdomain.com

Настройте Nginx конфигурацию:

server {
    listen 443 ssl http2;
    server_name yourdomain.com;
    
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
    
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

📱 Использование Telegram бота

Основные команды

/start - Начать работу с ботом
/launch - Запустить Tor браузер (десктоп разрешение)
/mobile - Запустить в мобильном режиме (390x844)
/desktop - Запустить в десктопном режиме (1920x1080)
/status - Проверить статус сессий
/stop - Остановить активную сессию
/web3 - Web3 функции
/help - Справка по командам

Пример использования

Найдите вашего бота в Telegram
Отправьте /start для инициализации
Нажмите "🧅 Запустить Tor Browser"
Дождитесь запуска (1-2 минуты)
Получите ссылку для доступа к браузеру
Откройте ссылку в любом браузере

🔧 API Документация

Основные эндпоинты

GET /api/status

Получение статуса всех сервисов

{
  "telegram": true,
  "web3": true,
  "tor": true,
  "vnc": true,
  "activeSessions": 2
}

POST /api/web3/connect

Подключение Web3 кошелька

{
  "address": "0x742d35Cc6634C0532925a3b8D95D22ac528B30c"
}

GET /api/session/:sessionId

Получение информации о сессии

{
  "sessionId": "123456_1640995200000",
  "status": "running",
  "accessUrl": "http://yourdomain.com/vnc/123456_1640995200000",
  "createdAt": "2024-01-01T00:00:00.000Z"
}

🐳 Docker развертывание

Простое развертывание

# Запуск всех сервисов
docker-compose up -d

# Просмотр логов
docker-compose logs -f

# Остановка
docker-compose down

Продакшн развертывание

version: '3.8'
services:
  web3-tor-app:
    image: your-registry/web3-tor-app:latest
    restart: unless-stopped
    environment:
      - NODE_ENV=production
      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
    ports:
      - "3000:3000"
      - "5900-5950:5900-5950"
      - "6080-6130:6080-6130"

🔒 Безопасность

Настройка файрвола

# UFW (Ubuntu)
sudo ufw allow 22/tcp      # SSH
sudo ufw allow 80/tcp      # HTTP
sudo ufw allow 443/tcp     # HTTPS
sudo ufw allow 3000/tcp    # App
sudo ufw allow 5900:5950/tcp  # VNC
sudo ufw allow 6080:6130/tcp  # Web VNC
sudo ufw enable

Мониторинг

# Просмотр активных сессий
docker ps | grep tor-browser

# Мониторинг ресурсов
docker stats

# Логи приложения
tail -f logs/app.log

🧪 Тестирование

Запуск тестов

# Unit тесты
npm test

# Интеграционные тесты
npm run test:integration

# E2E тесты
npm run test:e2e

Тестирование API

# Проверка статуса
curl http://localhost:3000/api/status

# Проверка healthcheck
curl http://localhost:3000/health

📊 Мониторинг и логирование

Структура логов

logs/
├── app.log          # Основные логи приложения
├── error.log        # Ошибки
├── telegram.log     # Логи Telegram бота
├── web3.log         # Web3 операции
└── access.log       # HTTP запросы

Интеграция с мониторингом

Prometheus - метрики
Grafana - визуализация
Sentry - отслеживание ошибок
ELK Stack - анализ логов

🚨 Устранение неполадок

Частые проблемы

Tor браузер не запускается

# Проверка Docker
docker ps
docker logs tor-browser-sessionId

# Проверка ресурсов
df -h
free -m

VNC не подключается

# Проверка портов
netstat -tlnp | grep 59
ss -tlnp | grep 6080

# Проверка файрвола
sudo ufw status

Telegram бот не отвечает

# Проверка токена
echo $TELEGRAM_BOT_TOKEN

# Проверка соединения
curl -X GET "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe"

Диагностические команды

# Полная диагностика
./scripts/diagnose.sh

# Проверка зависимостей
./scripts/check-deps.sh

# Очистка
./scripts/cleanup.sh

📈 Производительность

Оптимизация

Ограничение ресурсов Docker контейнеров:

services:
  tor-browser:
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: '1.0'

Настройка Redis кеширования
Оптимизация VNC сжатия
Балансировка нагрузки

Масштабирование

# Горизонтальное масштабирование
docker-compose up --scale web3-tor-app=3

# Кластер с Docker Swarm
docker swarm init
docker stack deploy -c docker-stack.yml web3-tor

🤝 Вклад в проект

Как внести вклад

Fork репозитория
Создайте feature ветку
Внесите изменения
Добавьте тесты
Создайте Pull Request

Стандарты кода

# Форматирование
npm run format

# Линтинг
npm run lint

# Проверка типов
npm run type-check

📜 Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для подробностей.

📞 Поддержка

GitHub Issues: Создать issue
Telegram: @ReliableSecurity
Email: ReliableSecurity@protonmail.com

🙏 Благодарности

Tor Project за анонимность
Telegram за API
Docker за контейнеризацию
Node.js сообщество

🗓️ Changelog

v1.0.0 (2024-01-01)

✨ Первый релиз
🧅 Интеграция с Tor браузером
📱 Telegram бот
🌐 Web3 поддержка
🖥️ VNC доступ

⚠️ Отказ от ответственности: Этот проект предназначен только для законного использования. Пользователи несут полную ответственность за соблюдение местного законодательства.

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
.github/workflows		.github/workflows
docker		docker
frontend		frontend
scripts		scripts
src		src
tests		tests
.babelrc		.babelrc
.env.example		.env.example
.eslintignore		.eslintignore
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
GITHUB_DEPLOYMENT.md		GITHUB_DEPLOYMENT.md
LICENSE		LICENSE
MIGRATION_REPORT.md		MIGRATION_REPORT.md
MULTI_USER_GUIDE.md		MULTI_USER_GUIDE.md
PROJECT_OVERVIEW.md		PROJECT_OVERVIEW.md
README-DOCKER.md		README-DOCKER.md
README.md		README.md
README_WEBAPP.md		README_WEBAPP.md
RELEASE-v2.0.0-SUMMARY.md		RELEASE-v2.0.0-SUMMARY.md
TESTING.md		TESTING.md
deploy.sh		deploy.sh
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.production.yml		docker-compose.production.yml
docker-compose.yml		docker-compose.yml
jest.config.js		jest.config.js
package-lock.json		package-lock.json
package.json		package.json
test-components.js		test-components.js
test-multi-users.js		test-multi-users.js
test-server.js		test-server.js
web3-tor-browser-v2.0.0-release.tar.gz		web3-tor-browser-v2.0.0-release.tar.gz
web3-tor-v2.0.0.bundle		web3-tor-v2.0.0.bundle

License

ReliableSecurity/web3-tor-browser-app

Folders and files

Latest commit

History

Repository files navigation