برای وصل شدن به وب پروکسی تلگرام فقط دو مقدار لازم دارید: آدرس سرور (hostname) و secret. پورت لازم نیست و حالت اتصال را هم پروفایل سرور تعیین می‌کند، نه شما. در این مطلب می‌بینید چه چیزهایی باید آماده باشد، لینک اشتراک چه شکلی است و اگر وصل نشد کجا را بررسی کنید.
اگر هنوز نمی‌دانید وب پروکسی چیست، اول وب پروکسی تلگرام (WEB-Proxy) چیست؟ را بخوانید.
پیش از شروع: چه چیزهایی لازم است؟
- نسخه مناسب تلگرام دسکتاپ. وب پروکسی با سری ۷.۱ به تلگرام دسکتاپ آمد. نسخه‌های قدیمی‌تر آن را نمی‌شناسند؛ اول برنامه را به‌روز کنید.
- آدرس سرور. یک نام دامنه مثل
proxy.example.com، بدونhttps://و بدون پورت. - secret. یک رشته ۳۲ نویسه‌ای هگزادسیمال. این مقدار مثل رمز عبور است.
هر دو مقدار را باید از کسی بگیرید که سرور را راه‌اندازی کرده است. وب پروکسی بدون سرور کار نمی‌کند و ما فهرست عمومی از آن نداریم.
لینک اشتراک وب پروکسی چه شکلی است؟
طبق مستندات رسمی پروژه، لینک اشتراک این شکل را دارد:
https://t.me/webproxy?server=proxy.example.com&secret=...
اگر این لینک را دارید، روی آن بزنید تا تلگرام دسکتاپ پیشنهاد افزودن پروکسی را نشان بدهد و آن را تأیید کنید. مستندات خودشان هشدار می‌دهند که مسیر tg://webproxy هنوز روی فرانت‌اند عمومی t.me ثبت نشده؛ یعنی ممکن است باز شدن لینک در بعضی دستگاه‌ها مستقیم کار نکند.
اگر لینک باز نشد
در این مرحله باید صادق باشیم: نام دقیق منوهای تلگرام برای افزودن وب پروکسی را ما روی نسخه ۷.۱ تلگرام دسکتاپ تأیید نکرده‌ایم و چون برنامه در حال تغییر است، مسیر ثابتی نمی‌نویسیم. راه کلی این است:
- به تنظیمات اتصال و پروکسی تلگرام دسکتاپ بروید (همان‌جا که پروکسی‌های MTProto را اضافه می‌کنید؛ آموزش در وصل شدن به پروکسی تلگرام در اندروید، آیفون و ویندوز آمده است).
- اگر نسخه شما نوع «WEB» را دارد، آن را انتخاب کنید و فقط آدرس سرور و secret را وارد کنید.
- اگر چنین گزینه‌ای نمی‌بینید، احتمالاً نسخه برنامه قدیمی است.
اگر وصل نشد یا گیر کرد
- نسخه برنامه را بررسی کنید. شایعترین دلیل نبودن گزینه یا خطا، نسخه قدیمی تلگرام دسکتاپ است.
- آدرس را دوباره بررسی کنید. آدرس باید فقط نام دامنه باشد، بدون
https://، بدون پورت و بدون فاصله اضافه. - secret را دوباره وارد کنید. یک نویسه اشتباه کافی است تا اتصال برقرار نشود.
- «وصل میشود ولی داده نمی‌آید»؟ مستندات رسمی می‌گویند تنظیم اشتباه NAT روی سرور (رایج روی EC2، GCE و شبکه‌های کانتینری) باعث میشود اتصال برقرار شود ولی جریانها بدون خطا متوقف بمانند. این مشکل از سمت صاحب سرور حل میشود، نه شما.
- بعد از ری‌استارت سرور. نشست‌های فعال قطع می‌شوند و ادامه پیدا نمی‌کنند؛ یک بار قطع و وصل کنید.
- هنوز نشد؟ شاید سرور خراب باشد. راهنمای عمومی چرا پروکسی تلگرام وصل نمی‌شود؟ را هم ببینید یا از یک پروکسی MTProto سالم از لیست زنده استفاده کنید.
اندروید و آیفون چه؟
طبق مستندات رسمی پروژه، وب پروکسی روی دسکتاپ پیاده‌سازی کامل‌تری دارد؛ نسخه اندروید «آزمایشی» و نسخه iOS هنوز «برنامه‌ریزی‌شده» توصیف شده است. اگر روی گوشی هستید و فوری پروکسی می‌خواهید، پروکسی MTProto ساده‌ترین راه است.
اگر خودتان سرور دارید
راه‌اندازی سرور کار فنی است و در این مطلب آموزش کامل نمی‌دهیم؛ مرجع درست مستندات رسمی tproxy-server در GitHub است. فقط برای اینکه بدانید با چه چیزی طرف هستید، این‌ها پیش‌نیازهای ذکرشده‌اند:
- یک سرور Ubuntu 22.04 به بالا یا Debian 12 (معماری x86_64).
- یک دامنه اختصاصی با رکورد DNS درست.
- یک سایت واقعی روی همان دامنه، چون پروژه سایتی همراه خودش نمی‌دهد.
- باز بودن پورت‌های ۸۰ و ۴۴۳.
- یک secret تصادفی ۱۶بایتی.
مستندات هشدار می‌دهند که اسکریپت نصب برای سرور تازه طراحی شده و تنظیمات فعلی Caddy را جایگزین می‌کند؛ روی سروری که سایت‌های دیگر هم دارد باید از روش دستی استفاده شود.
نکات امنیتی
- لینک و secret را عمومی منتشر نکنید؛ هر کسی آن را داشته باشد میتواند از سرور استفاده کند.
- مثل هر پروکسی، مدیر سرور آدرس IP شما را می‌بیند. جزئیات در آیا پروکسی تلگرام امن است؟ آمده است.
- لینکی که از شما شماره تلفن یا کد تأیید بخواهد پروکسی نیست؛ فیشینگ است.
نقش ProxyBolt کجاست؟
ProxyBolt پروکسی‌های MTProto را از داخل ایران تست می‌کند. وب پروکسی را تست نمی‌کنیم و فهرستی از آن نداریم. اگر می‌خواهید بدانید کدام نوع برایتان مناسب‌تر است، وب پروکسی یا MTProto؟ را ببینید.
سوالات متداول
برای وب پروکسی تلگرام چه چیزهایی لازم است؟
یک نسخه از تلگرام دسکتاپ که وب پروکسی را پشتیبانی کند (سری ۷.۱ به بعد)، آدرس سرور (hostname) و secret پروکسی که ۳۲ نویسه هگزادسیمال است. هر دو را باید از کسی بگیرید که سرور را راه‌اندازی کرده است.
لینک وب پروکسی چه شکلی است؟
طبق مستندات رسمی پروژه، شکل لینک اشتراک https://t.me/webproxy?server=...&secret=... است. مسیر tg://webproxy هنوز روی فرانت‌اند عمومی t.me ثبت نشده، پس ممکن است لینک در بعضی شرایط مستقیماً در برنامه باز نشود.
چرا وصل میشود ولی پیامها نمیآیند؟
شایعترین دلیل در سمت سرور، تنظیم اشتباه NAT است: اتصال برقرار میشود ولی جریانها بدون هیچ خطایی متوقف میمانند. این مشکل را فقط صاحب سرور میتواند حل کند.
