Pick Regions & Fastest Exit Nodes
Ask your agent to benchmark latency and switch exits across Japan, Singapore, Hong Kong, or the US in one sentence.
سازگار با Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen — ایجنت به صورت خودکار تنظیمات را انجام داده، ۹۰ دقیقه تست رایگان را فعال و متصل میکند.
Read https://yivpn.net/vpn-api/llms.txt and auto-connect this environment to YIVPN (claim the free 90-min trial if needed).
Ask your agent to benchmark latency and switch exits across Japan, Singapore, Hong Kong, or the US in one sentence.
Rootless proxy never touches cloud VM default routes — internal DBs and SSH stay direct while external requests use YIVPN.
Toggle tunnel-level Cloudflare Security DoH and ad-tracker blocking to protect headless browsers and speed up page loads.
Compare direct vs. tunneled latency and exit IP anytime, check remaining free trial minutes, or generate a zero-account checkout link.
Click Copy on any card below and paste into Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen.
“Benchmark latency and switch my YIVPN proxy exit to the fastest Japan node, then confirm the new exit IP.”
“Enable smart split so internal databases and local networks stay direct while external APIs go through YIVPN.”
“Configure curl, git, and Python in this session to route through my local YIVPN proxy and test connectivity.”
“Turn on malware/phishing protection and ad-blocking on my YIVPN tunnel for cleaner headless browsing.”
“Check my YIVPN tunnel health and compare direct vs. proxied latency right now.”
“Check how much time is left on my free YIVPN trial, or get a link to unlock all US/JP/SG/HK nodes.”
Turn on Settings → Connection → Local MCP in YIVPN Desktop, then send to Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen to inspect status and manage split-tunnel routes.
Read https://yivpn.net/vpn-api/llms.txt, connect to my local YIVPN Desktop MCP service, check VPN status, and manage split-tunnel routes.
Your agent inspects all entitled nodes in your YIVPN Desktop app, tests latency, and switches to the fastest region on command.
Route blocked dev sites or specific apps through the VPN while keeping local messengers, banking, and game downloads at full ISP speed.
Every rule change is previewed first, applied to sing-box, and probed live — if anything fails, YIVPN auto-restores the last working snapshot.
Bound strictly to 127.0.0.1 with revocable per-agent tokens; disconnecting VPN or widening direct bypass requires your click in the app.
Click Copy on any card below and paste into Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen.
“Check which YIVPN node I am on right now, test latency, and switch me to the fastest Japan server.”
“huggingface.co and docker.io are failing to load — route both domains through YIVPN for me.”
“Keep my company intranet and local banking domains on direct connection so they do not detour through VPN.”
“Route Cursor and git through YIVPN, while keeping my games and large downloads on direct connection.”
“Why is api.openai.com loading slowly? Diagnose DNS, IPv6, and my current YIVPN route.”
“Something feels off after that last routing tweak — roll back YIVPN to my previous configuration.”
Most users only need the plain-language prompt above. Developers inspecting the 8 JSON-RPC 2.0 kernel tools or configuring MCP config files manually can expand the reference below:
| MCP Tool Name | Scope | Real Kernel Action & Verification | Safety Boundary & User Confirmation |
|---|---|---|---|
| get_capabilities | read | Returns OS platform, sing-box 1.14.3 kernel mode (TUN / Proxy), pre-authorized scopes, and 12 verified service presets | Read-only; explicitly reports unsupported rule types per mode |
| get_vpn_status | read | Reads live tunnel state, active node, verified exit IP, smart-split state, and optimistic policyVersion | Never exposes private keys, UUIDs, or subscription tokens |
| list_servers | read | Lists nodes the active paid account or local subscription is entitled to use (id, name, region, protocols) | Enforces live paid entitlement check; strips raw credentials |
| connect_vpn / disconnect_vpn | modify | Connects or disconnects the real desktop VPN tunnel and verifies exit connectivity (aligned with Cloud MCP tool names) | disconnect_vpn requires in-app user confirmation unless pre-authorized |
| diagnose_connection | diagnose | Runs DNS (A/AAAA), IPv6 reachability, TCP/HTTPS probe, and parses sing-box kernel outbound logs as evidence | Rate-limited (15 req/min) and body-capped (32 KB) |
| preview_routing_rules | modify | Validates proposed rules (domain, domain_suffix, ip_cidr, process_name, service_preset), outputs planId, diff & conflicts | Zero network mutation; blocks 0.0.0.0/0 & hallucinated presets |
| apply_routing_rules | modify | Checks basePolicyVersion & idempotencyKey, saves a safety snapshot, reloads sing-box, and verifies real route path | Automatically rolls back to the previous snapshot if verification fails |
| rollback_routing_rules | modify | Restores the previous or specified snapshotId configuration and re-verifies tunnel health locally | Works offline without AI intervention; never fails open to global direct |
# 1. Mainland China & Global Unified Bridge (v2.2 — GFW & ExecutionPolicy Safe)
mkdir -p ~/.yivpn-agent && curl -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o ~/.yivpn-agent/yivpn-agent.mjs
claude mcp add yivpn -e YIVPN_MCP_TOKEN=yivpn_mcp_<YOUR_AGENT_TOKEN> \
-- node ~/.yivpn-agent/yivpn-agent.mjs mcp
# 2. Claude Code — Direct Loopback Streamable HTTP (no Node.js wrapper needed)
claude mcp add --transport http yivpn http://127.0.0.1:38410/mcp \
--header "Authorization: Bearer yivpn_mcp_<YOUR_AGENT_TOKEN>"
# 3. OpenAI Codex (~/.codex/config.toml)
[mcp_servers.yivpn]
url = "http://127.0.0.1:38410/mcp"
http_headers = { "Authorization" = "Bearer yivpn_mcp_<YOUR_AGENT_TOKEN>" }
# 4. Universal Stdio (.mcp.json — Cursor / Windsurf / Claude Desktop)
{
"mcpServers": {
"yivpn": {
"command": "node",
"args": ["/Users/<you>/.yivpn-agent/yivpn-agent.mjs", "mcp"],
"env": {
"YIVPN_MCP_TOKEN": "yivpn_mcp_<YOUR_AGENT_TOKEN>"
}
}
}
}
127.0.0.1 and validates Host / Origin headers against DNS rebinding. Running node ~/.yivpn-agent/yivpn-agent.mjs mcp (v2.2) auto-discovers your local desktop port when active.سرویسهای سنتی VPN نیازمند ثبتنام ایمیلی و کلیک در رابط گرافیکی هستند. رابط برنامهنویسی YIVPN Agent API (https://yivpn.net/api/v1/vpn) کل چرخه را با درخواستهای استاندارد HTTP و امضای دیجیتال ed25519-v1 جایگزین میکند.
rail: "trial"، سازگار با پروکسیهای فعلی و سرورهای ابری)، یا ۴ منطقه جهانی را با Hosted Checkout یا پروتکل HTTP 402 بر بستر Base USDC (x402) فعال نمایید.GET /api/v1/vpn/config?mode=proxy را فراخوانی کنید.sing-box را روی 127.0.0.1:10808 (پشتیبانی همزمان HTTP و SOCKS5) اجرا کنید؛ بدون نیاز به CAP_NET_ADMIN و بدون قطع شدن اتصال SSH سرور ابری.# 1. Save Zero-Dependency First-Party CLI (v2.2 — GFW & ExecutionPolicy Safe)
mkdir -p ~/.yivpn-agent
curl -fsSL https://yivpn.net/vpn-api/yivpn-agent.mjs -o ~/.yivpn-agent/yivpn-agent.mjs
node ~/.yivpn-agent/yivpn-agent.mjs status
# 2. Connect (Cloud VM / SSH: 127.0.0.1:10808 only | Personal PC: add --system-proxy with auto-restore watchdog)
node ~/.yivpn-agent/yivpn-agent.mjs connect --auto-trial --system-proxy
curl -fsSL --noproxy "*" https://cloudflare.com/cdn-cgi/trace
curl -fsSL -x http://127.0.0.1:10808 https://cloudflare.com/cdn-cgi/trace
node ~/.yivpn-agent/yivpn-agent.mjs disconnect
# 3. Unified MCP Server (Auto-detects Zero-App Cloud Mode OR YIVPN Desktop Split-Tunnel Bridge)
claude mcp add yivpn -- node ~/.yivpn-agent/yivpn-agent.mjs mcp
claude mcp add yivpn -e YIVPN_MCP_TOKEN=yivpn_mcp_<YOUR_AGENT_TOKEN> -- node ~/.yivpn-agent/yivpn-agent.mjs mcp
# 4. Multi-Region Upgrade (US/JP/SG/HK, up to 5 concurrent sandboxes, Checkout or x402 USDC)
node ~/.yivpn-agent/yivpn-agent.mjs buy --months 1 --rail checkout
node ~/.yivpn-agent/yivpn-agent.mjs settings --guardrails malware,ads --region auto
اسکریپتهای معمول WireGuard نیازمند دسترسی root هستند، مسیر پیشفرض سرور مجازی را تغییر داده و باعث قطع ارتباط SSH میشوند و در شبکههای محدود به سادگی توسط فایروالهای DPI مسدود میگردند:
| قابلیت | YIVPN Agent API | سرویسهای خام WireGuard |
|---|---|---|
| امنیت SSH و کانتینرها | پروکسی محلی بدون روت روی 127.0.0.1:10808 به صورت پیشفرض + حالت اختیاری TUN | نیازمند root / CAP_NET_ADMIN؛ اغلب باعث قطع ارتباط SSH سرور میشود |
| مقاومت در برابر فیلترینگ و DPI | Hysteria2 (QUIC/UDP 443) + VLESS+REALITY (TLS 1.3/TCP 443) | بستههای خام UDP در WireGuard به سادگی شناسایی و مسدود میشوند |
| خروجیهای چندمنطقهای کمتاخیر | آمریکا (US)، ژاپن (JP)، سنگاپور (SG) و هنگکنگ (HK) | محدود به یک سرور ثابت در هر فایل کانفیگ |
| مدیریت چرخه حیات کلیدها | امضای ed25519-v1، چرخش آنی کلید (/rotate) و ابطال فوری | کلیدهای ثابت بدون محافظت در برابر حملات بازپخش (Replay) |
فیلترهای DNS سطح تونل را در لحظه با PUT /api/v1/vpn/settings تغییر دهید و دقیقاً با همان تعرفه شفاف YiPro پرداخت کنید:
| محافظ / دوره | سازوکار / قیمت (دلار) | کاربرد برای ایجنت |
|---|---|---|
| guardrails: malware (پیشفرض) | Cloudflare Security DoH (1.1.1.2) + مسدودسازی فیشینگ | محافظت از مرورگرهای Headless در برابر بدافزارها و دامنههای مخرب |
| guardrails: ads / adult | حذف ردیابهای تبلیغاتی / Family DoH (1.1.1.3) | سبکسازی درخت DOM و افزایش سرعت خودکارسازی Playwright |
| guardrails: smart_split | عبور مستقیم شبکههای داخلی و هدایت ترافیک خارجی از تونل رمزنگاریشده | حفظ اتصال مستقیم به دیتابیسهای داخلی کلود همزمان با عبور APIهای خارجی از VPN |
| تست رایگان (rail: "trial") | $0 (۹۰ دقیقه / ۱ گیگابایت · دوره تنفس ۲۴ ساعته) | تونل فوری US-Ohio بدون کارت بانکی (سازگار با پروکسی فعلی و سندباکسهای ابری) |
| پلنهای API (تا ۵ سندباکس همزمان) | ۱ ماهه $2.99 · ۳ ماهه $6.99 · ۶ ماهه $12.99 · ۱۲ ماهه $21.99 | دسترسی کامل به مناطق US/JP/SG/HK برای حداکثر ۵ کانتینر همزمان به ازای هر کلید |
/vpn-api/llms.txt · OpenAPI 3.1 · ابزار رسمی خط فرمان با مجوز MIT: yivpn-official/yivpn-agent-cli.بله. کافی است دستور بالای صفحه را به ایجنت هوش مصنوعی خود بدهید (یا دستور npx --yes github:yivpn-official/yivpn-agent-cli connect --auto-trial را اجرا کنید) تا بدون نیاز به کارت بانکی ۹۰ دقیقه / ۱ گیگابایت تونل US-Ohio دریافت کنید (هر ۲۴ ساعت یکبار، سازگار با پروکسیهای فعلی و محیطهای ابری).
خیر. تمام مراحل از طریق درخواستهای HTTPS REST و هسته متنباز sing-box در خط فرمان انجام میشود و نیازی به ثبتنام یا محیط گرافیکی نیست.
هرگز در حالت پیشفرض mode=proxy؛ زیرا فقط روی پورت محلی 127.0.0.1:10808 گوش میدهد و جدول مسیریابی سیستمعامل را تغییر نمیدهد.
با فراخوانی POST /api/v1/vpn/rotate زمان باقیمانده اشتراک به صورت اتمی به کلید عمومی جدید منتقل میشود، یا با DELETE /api/v1/vpn/entitlements فوراً باطل میگردد.
درگاه بدون حساب Hosted Checkout (کارتهای Visa، Mastercard، Apple Pay و Alipay) و همچنین تسویه خودکار HTTP 402 با رمزارز Base USDC (پروتکل x402) پشتیبانی میشوند.
اجرای دستور npx --yes github:yivpn-official/yivpn-agent-cli mcp (نسخه v2.2) محیط شما را خودکار تشخیص میدهد: در سرورهای لینوکسی و Docker یک پروکسی بدون روت روی 127.0.0.1:10808 راهاندازی میکند؛ و در ویندوز یا مک در صورت فعال بودن Local MCP دسکتاپ (127.0.0.1:38410) به هسته دسکتاپ متصل شده و پیشنمایش و بازگشت خودکار قوانین مسیریابی را مدیریت میکند.
نسخه رسمی YIVPN v1.0.6 را با هسته آفلاین sing-box و مسیریابی هوشمند Smart Split برای ویندوز، مک و اندروید دانلود کنید.
Up to 5 simultaneous devices · All global HY2/REALITY locations · Desktop AI MCP Server
Scan with the Alipay app. This page automatically detects confirmation and reveals your activation code in seconds.
Open in Alipay App →Enter this code under "Activation Code" in YIVPN for Windows, macOS, or Android for instant passwordless sign-in—or use it anytime to recover your password:
YIVP-XXXX-XXXX-XXXX
Please copy or download your YIVP activation code before closing so you do not lose access to your membership!
Sign in passwordlessly with your YIVP activation code, or use your username/email and password.
Every account also receives a dedicated YIVP activation code. Add an email to enable 6-digit password recovery.
Receive a 6-digit verification code via email, or reset immediately using your YIVP activation code.
YIVP-••••-••••-••••