اشتراک پهنای باند · راهنمای راه‌اندازی

یک رایانه یا NAS را آنلاین نگه دارید تا یک خروجی در سرزمین اصلی فراهم شود. مراحل ①–③ را برای دانلود انجام دهید، سپس راهنمای مبتدیان زیر را دنبال کنید.

① ورود به Univista

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

ورود ثبت‌نام پنل کاربری نود خانگی · راه‌انداز نصب
② اشتراک خود را کپی کنید (به‌اختیار لینک Shadowrocket)

«داشبورد» را باز کنید و لینک «Shadowrocket / عمومی» را کپی کنید. کاربران خارج از کشور طبق معمول از آن استفاده می‌کنند؛ مشارکت‌کنندگان روی مرحلهٔ بعدی یعنی تونل تمرکز کنند.

③ نصب کلاینت frp و اتصال به سنگاپور

روی دستگاهی که همیشه روشن است، فقط frpc را دانلود و اجرا کنید (کلاینت — مطابق نسخهٔ جدول زیر). پس از ثبت‌نام از طریق «کسب درآمد → اشتراک پهنای باند» یا API، مقادیر serverAddr، token و remotePort را در frpc.toml قرار دهید. سند عملیاتی ۵۶ را ببینید. تا برقراری تونل، «نود فعالی نیست» طبیعی است.

نکات نصب عمومی (باز کردن بسته، تفاوت frpc و frps) در سایت مستندات پروژه آمده است: باز کردن مستندات رسمی — نصب

بستهٔ مناسب سیستم خود را انتخاب کنید (v0.61.0)

«دانلود مستقیم» فایل را فوراً دریافت می‌کند (بدون صفحهٔ ریلیزهای GitHub). اگر دانلود کند بود، دوباره تلاش کنید یا از مسیر شبکهٔ معمول خود استفاده کنید.

دستگاه / سناریو	نام فایل بسته	عملیات
ویندوز ۱۰/۱۱ ۶۴ بیتی (بیشتر رایانه‌ها)	frp_0.61.0_windows_amd64.zip	دانلود مستقیم
ویندوز ARM64 (مثلاً برخی مدل‌های Surface)	frp_0.61.0_windows_arm64.zip	دانلود مستقیم
macOS اپل سیلیکون (M1 / M2 / M3 / M4)	frp_0.61.0_darwin_arm64.tar.gz	دانلود مستقیم
macOS اینتل (مک‌های قدیمی)	frp_0.61.0_darwin_amd64.tar.gz	دانلود مستقیم
لینوکس دسکتاپ / سرور x86 / بسیاری از NASها (amd64)	frp_0.61.0_linux_amd64.tar.gz	دانلود مستقیم
لینوکس ARM64 (مثلاً رزبری‌پای ۶۴ بیتی، برخی NASهای ARM)	frp_0.61.0_linux_arm64.tar.gz	دانلود مستقیم
لینوکس ARM ۳۲ بیتی (تصاویر قدیمی ۳۲ بیتی رزبری‌پای و غیره)	frp_0.61.0_linux_arm.tar.gz	دانلود مستقیم

از frpc درون بسته استفاده کنید؛ frps را در خانه اجرا نکنید. این جدول با نسخهٔ سرور Univista هماهنگ است: v0.61.0

راهنمای مبتدیان: ثبت‌نام، پیکربندی، اجرا

فرض بر این است که می‌توانید Terminal را روی macOS باز کنید. در صورت نیاز از کسی بخواهید دستورها را برای شما اجرا کند. YOUR_EMAIL / YOUR_PASSWORD را با اطلاعات ورود Univista خود جایگزین کنید.

بسته را باز کنید و فایل frpc را پیدا کنید. frps را در خانه اجرا نکنید — آن فایل برای سمت سرور است.
اگر macOS گفت توسعه‌دهنده قابل تأیید نیست: یک بار اجرا کنید: xattr -cr /path/to/the/extracted/folder (پوشه باید شامل frpc باشد)، مثلاً xattr -cr ~/Downloads/frp_0.61.0_darwin_arm64. یا در Finder: روی frpc راست‌کلیک کنید → Open → دوباره Open.
در صورت نیاز chmod +x frpc را اجرا کنید تا ./frpc در Terminal کار کند.
از دستورهای زیر استفاده کنید. اگر قبلاً ثبت‌نام کرده‌اید، POST /register خطا برمی‌گرداند — به‌جای آن از GET /api/agent/config با همان توکن Bearer استفاده کنید. مقادیر frps_host، frps_port، virtual_port، frps_token را برای auth.token ذخیره کنید؛ remotePort باید برابر virtual_port باشد.
یک فایل متنی ساده با نام frpc.toml کنار frpc بسازید (اگر ویرایشگر .txt اضافه کرد، تغییر نام دهید).
نمونه را ویرایش کنید: auth.token را برابر frps_token و remotePort را برابر virtual_port قرار دهید (باید بین ۱۸۰۰۰ و ۱۹۹۹۹ باشد).
در یک ترمینال python3 -m http.server 8765 را اجرا کنید؛ در ترمینال دیگر ./frpc -c frpc.toml را اجرا کنید و دنبال login success / start proxy success بگردید.

در ترمینال اجرا کنید (ورود، سپس ثبت‌نام)

به Python 3 نیاز دارد. اگر خطای 404 گرفتید، ممکن است CN_AGENT_ENABLED روی سرور خاموش باشد.

curl -sS -X POST "https://univista.me/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'

TOKEN=$(curl -sS -X POST "https://univista.me/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

curl -sS -X POST "https://univista.me/api/agent/register" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"device_name":"home","region":""}'

قبلاً ثبت‌نام کرده‌اید؟ تنظیمات تونل را بگیرید (بدون ثبت‌نام دوباره)

از همان $TOKEN ورود استفاده کنید. JSON شامل frps_token و virtual_port برای frpc.toml است.

curl -sS "https://univista.me/api/agent/config" \
  -H "Authorization: Bearer $TOKEN"

نمونهٔ frpc.toml (از مقادیر پاسخ ثبت‌نام استفاده کنید)

اگر frps_host در JSON با نمونه فرق داشت، برای serverAddr مقدار JSON را استفاده کنید.

serverAddr = "139.180.184.227"
serverPort = 17980

auth.method = "token"
auth.token = "PASTE_frps_token_FROM_REGISTER_RESPONSE"

[[proxies]]
name = "test-tcp"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8765
remotePort = 18000

۱۸۰۰۰ را با virtual_port خود جایگزین کنید. auth.token باید دقیقاً با frps_token مطابقت داشته باشد (نه با توکن heartbeat ایجنت). خطای «token in login doesn't match» یعنی auth.token با توکن سرور برابر نیست.

اجرا (دو پنجرهٔ ترمینال)

cd /path/to/extracted/folder
python3 -m http.server 8765
# Second terminal:
./frpc -c frpc.toml

رفع اشکال

macOS می‌گوید frpc قابل تأیید نیست

بهترین راه: یک بار xattr -cr را روی پوشهٔ حاوی frpc اجرا کنید. یا Finder → راست‌کلیک روی frpc → Open. مراحل مبتدیان بالا را ببینید.
خطا: token in login doesn't match token from configuration

auth.token باید دقیقاً با frps_token از API ثبت‌نام مطابقت داشته باشد (همانند سرور frps). از JWT یا کلید heartbeat ایجنت استفاده نکنید. مراقب فاصله‌های اضافی باشید.
آیا می‌توانم از remotePort 6000 استفاده کنم؟

خیر. فقط ۱۸۰۰۰–۱۹۹۹۹، و باید برابر virtual_port اختصاص‌یافته به شما باشد.
لاگ‌ها کجا هستند؟

به‌طور پیش‌فرض، در همان ترمینالی که frpc را اجرا می‌کنید. یا: ./frpc -c frpc.toml 2>&1 | tee frpc.log

آیا رایانه باید همیشه روشن بماند؟

بله. هر دستگاهی که frpc و پراکسی محلی روی آن اجرا می‌شود باید آنلاین بماند (رایانه، NAS یا روتر). وقتی به خواب می‌رود یا خاموش است، دیگران نمی‌توانند از خط شما استفاده کنند.

همکاری در فروش