شروع سریع با کتابخانه v2socks

کتابخانه v2socks یک ابزار سبک، عمومی و چندسکویی (Cross-Platform) برای پایتون است که کانفیگ‌های V2Ray (شامل VLESS، VMess، Trojan و Reality) را به پروکسی‌های محلی SOCKS5 تبدیل می‌کند.

این کتابخانه به صورت خودکار فایل اجرایی هسته Xray را در اولین اجرا دانلود کرده و در مسیر مشترک سیستم (~/.v2socks/bin/) قرار می‌دهد و پروسه اجرای پروکسی محلی را مدیریت می‌کند.

---

نصب کتابخانه

نصب پکیج از طریق ترمینال با pip:

pip install v2socks

---

شروع سریع

یک پروکسی روی پورت دلخواه یا آزاد بالا بیاورید و آی‌پی پروکسی خود را دریافت کنید:

import requests
from v2socks import V2Socks

# استفاده از Context Manager برای اجرا و بستن خودکار پروکسی
with V2Socks("your-v2ray-config-link-here") as proxy:
    print(f"Proxy is running on local port: {proxy.port()}")

    # تنظیمات پروکسی برای کتابخانه requests
    proxies = {"http": proxy.socks_url, "https": proxy.socks_url}

    # ارسال درخواست HTTP از طریق پروکسی
    ip_info = requests.get("http://ip-api.com/json", proxies=proxies).json()
    print(f"Connected! Country: {ip_info.get('country')}")