لوکالت

راهنمای کلاینت

شروع سریع

روی سیستم خودتان: ثبت‌نام، دانلود باینری، اجرای سرویس لوکال، و اتصال با localet client.

  1. ثبت‌نام کنید و از پنل یک API Token بسازید.
  2. با یک دستور از صفحه دانلود نصب کنید (لینوکس/مک: curl …/download/install.sh | sh — ویندوز: curl.exe …/download/install.cmd).
  3. سرویس لوکال را روی یک پورت اجرا کنید (مثلاً ۳۰۰۰).
  4. با دستور localet client وصل شوید (بخش بعد).

اتصال کلاینت

توکن را از پنل بگیرید و به یکی از دو شکل زیر به کلاینت بدهید:

shell LTR
# روش ۱ — توکن با فلگ
./localet client --server tunnel.localet.ir --token "$LOCALET_TOKEN" --port 3000 --transport ws

# روش ۲ — توکن از متغیر محیطی
export LOCALET_TOKEN='lt_...'
./localet client --server tunnel.localet.ir --port 3000 --transport ws
  • --server آدرس سرور تانل (tunnel.localet.ir)
  • --token / LOCALET_TOKEN احراز هویت کلاینت
  • --port پورت سرویس لوکال شما (مثلاً ۳۰۰۰)
  • --transport یکی از ws، quic، tcp یا auto (جزئیات پایین)
  • --subdomain ساب‌دامین ثابت (فقط پلن حرفه‌ای)

ترنسپورت‌ها

با --transport مسیر اتصال را انتخاب کنید. پیش‌فرض auto است.

ws
WebSocket + yamux — معمولاً بهترین گزینه پشت فایروال
quic
کم‌تأخیر؛ اتصال مستقیم به سرور
tcp
TCP + mTLS؛ نیاز به گواهی و کلید کلاینت
auto
به‌ترتیب امتحان می‌کند: ws → quic → tcp

ساب‌دامین ثابت

در پلن حرفه‌ای می‌توانید با --subdomain myapp آدرس ثابت بگیرید: https://myapp.localet.ir

بدون این فلگ، ساب‌دامین تصادفی به شما داده می‌شود.