Bridge Core

تونل TCP روی WebRTC

Bridge Core یک تونل TCP است که روی WebRTC کار می‌کند: نرم‌افزار شما به یک پورت محلی وصل می‌شود و ترافیک از طریق یک اتصال رمزنگاری‌شدهٔ WebRTC به سرویسی می‌رسد که اپراتور روی سرور خود منتشر کرده است. عبور از NAT و فایروال‌های سخت با سرور سیگنالینگ و در صورت نیاز سرور TURN انجام می‌شود.

نسخه: —

Bridge Core چیست؟

این سرویس دو نقش دارد: یک «هاست» که سرویس شما را روی سرور اجرا می‌کند و یک «کلاینت» که همان سرویس را روی رایانهٔ شما در 127.0.0.1 باز می‌کند. هر دو طرف از طریق سرور سیگنالینگ هم را پیدا می‌کنند و سپس داده مستقیم یا از طریق رلهٔ TURN منتقل می‌شود. برای کاربر نهایی نتیجه ساده است: یک پورت محلی که به سرویس راه دور وصل است.

دانلود

فایل‌ها با همان نسخهٔ سرویس ساخته می‌شوند. پس از دانلود، اثر انگشت SHA-256 را بررسی کنید (مرحلهٔ ۲ در راهنما).

اپلیکیشن اندروید هنوز وجود ندارد. در حال حاضر فقط کلاینت ویندوز و لینوکس ارائه می‌شود.

همهٔ اثر انگشت‌ها (SHA256SUMS)

راهنمای راه‌اندازی

  1. 1حساب خود را از مدیر بگیرید

    مدیر برای شما سه چیز می‌سازد: شناسهٔ پایهٔ شما (base ID)، یک توکن و شناسهٔ همتای مقصد (peer/host ID).

    base ID
    <your_id>
    token
    <token> (فقط یک بار نمایش داده می‌شود)
    peer ID
    <host_id>
  2. 2دانلود و بررسی SHA-256

    پس از دانلود، اثر انگشت فایل را با مقداری که در بخش دانلود آمده مقایسه کنید.

    Linux
    sha256sum bridger-client-linux-amd64
    Windows (PowerShell)
    Get-FileHash .\bridger-client-windows-amd64.exe -Algorithm SHA256
  3. 3کلاینت را اجرا کنید

    این دستور سرویس راه دور را روی 127.0.0.1:27777 در رایانهٔ شما باز می‌کند:

    Linux
    bridger-client -m client -i <your_id> -p <host_id> -s https://bridger.pttp.me -token <token> -l 127.0.0.1:27777
    Windows
    .\bridger-client.exe -m client -i <your_id> -p <host_id> -s https://bridger.pttp.me -token <token> -l 127.0.0.1:27777

    مقادیر <your_id>، <host_id> و <token> را با مقادیر حساب خود جایگزین کنید.

  4. 4برنامه یا مرورگر را به پورت محلی وصل کنید

    هر برنامه‌ای که TCP می‌فهمد می‌تواند به 127.0.0.1:27777 وصل شود؛ این پورت همان سرویسی است که سمت هاست منتشر شده. مثلاً:

    Linux
    curl http://127.0.0.1:27777/
  5. 5سمت هاست (کار اپراتور)

    اپراتور روی سرور، سرویس مورد نظر را با حالت host منتشر می‌کند. پارامتر -t آدرس محلی همان سرویس روی سرور است:

    Host
    bridger-client -m host -i <host_id> -p <your_id> -s https://bridger.pttp.me -token <host_token> -t 127.0.0.1:8080
  6. 6اگر کار نکرد

    • ۴۰۱ یا ۴۰۳: توکن اشتباه، باطل‌شده یا منقضی است. از مدیر توکن تازه بگیرید.
    • ۴۲۹: درخواست‌ها بیش از حد مجاز بوده. چند لحظه صبر کنید و دوباره اجرا کنید.
    • «no live connection»: طرف مقابل (هاست) آنلاین نیست یا شناسهٔ peer اشتباه است.
    • اگر اتصال برقرار نمی‌شود، اپراتور باید فایروال سرور را برای UDP/TCP پورت TURN (پیش‌فرض ۳۴۷۹) و بازهٔ رله باز کند.

پارامترهای مفید

پارامتر توضیح
-mحالت اجرا: client یا host
-i, -pشناسهٔ خودتان و شناسهٔ همتای مقصد
-sآدرس سرور سیگنالینگ (پیش‌فرض در این سرویس: https://bridger.pttp.me)
-tokenتوکن احراز هویت (Authorization: Bearer)
-lدر حالت client: آدرس محلی برای شنود (پیش‌فرض localhost:27777)
-tدر حالت host: آدرس TCP سرویسی که منتشر می‌شود
-cتعداد اتصال‌های موازی (پیش‌فرض ۸)
-reportفاصلهٔ گزارش آمار به سرور به ثانیه (۰ = خاموش)
-stunسرورهای STUN، جداشده با ویرگول؛ خالی = بدون STUN
-turn, -turnu, -turncآدرس سرور TURN و نام/رمز آن، برای وقتی مسیر مستقیم بسته است
-configفایل JSON تنظیمات؛ اگر داده شود بقیهٔ پارامترها نادیده گرفته می‌شوند
-statsآدرس محلی برای سرو کردن آمار JSON روی /stats (مثلاً 127.0.0.1:6060)
-versionنمایش نسخه و خروج

نکته‌های مهم

رلهٔ TURN خودکار نیست: کلاینت فعلاً اعتبارنامهٔ رله را از سرور نمی‌گیرد. اگر شبکهٔ شما بسیار محدود است و مسیر مستقیم بسته می‌ماند، از مدیر بخواهید آدرس TURN و اعتبارنامه را بدهد و با پارامترهای -turn و -turnu و -turnc اجرا کنید. این یک محدودیت شناخته‌شده است و در نسخه‌های بعدی خودکار می‌شود.