自由切換國家出口與最快線路
讓 AI 自動測速挑選最低延遲節點,或一句話指定切換至日本、新加坡、香港、美國出口。
支援 Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / 豆包工作版 / 千問 —— 傳過去後 AI 會自動完成設定、免費領 90 分鐘額度並連上加密網路。
請閱讀 https://yivpn.net/vpn-api/llms.txt,幫我把目前環境自動連上 YIVPN(若未開通請先免費領取 90 分鐘試用額度)。
讓 AI 自動測速挑選最低延遲節點,或一句話指定切換至日本、新加坡、香港、美國出口。
預設免 Root 代理絕不斷開雲端 SSH;開啟智慧分流後,內網資料庫直連,外部 API 走加密代理。
一句話開啟通道級 DNS 安全護欄,自動阻斷惡意程式與釣魚網域,過濾廣告加速網頁擷取。
隨時讓 AI 對比直連與代理出口 IP 及延遲,查詢 90 分鐘免費試用餘額,或產生免註冊付款連結。
點擊任意卡片右上角的「複製」,貼給 Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / 豆包工作版 / 千問 即可立即執行。
“幫我測一下延遲,把目前 YIVPN 代理出口切換到最快的日本節點,並確認新的出口 IP。”
“幫我開啟智慧分流模式,讓內網資料庫保持直連,外部 API 請求走加密代理。”
“幫我設定目前環境的 curl、git 與 Python 請求自動透過 YIVPN 本地代理連線。”
“幫我開啟惡意網站攔截與廣告過濾護欄,加速自動化網頁瀏覽。”
“幫我診斷目前 YIVPN 通道狀態,對比本地直連與走代理的連線延遲。”
“幫我查看免費試用還剩多久;如果想解鎖美日新港全部節點怎麼開通?”
先在 YIVPN 桌面版「設定 → 連線策略 → 本機 MCP」開啟開關,再貼給 Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / 豆包工作版 / 千問,即可幫你查狀態、測線路、改分流規則。
請閱讀 https://yivpn.net/vpn-api/llms.txt,連線我電腦上的 YIVPN 桌面版 MCP 服務,幫我檢查目前 VPN 狀態並管理分流規則。
AI 直接讀取桌面版帳戶下的可用節點,依真實延遲幫你一鍵切換至最快的日本、香港、新加坡或美國線路。
打不開的網站交給 VPN,本地通訊軟體、網銀與大型遊戲下載保持滿速直連。
每次修改先產生差異預覽,套用至 sing-box 核心後立即實測連線;若驗證失敗毫秒級自動恢復原狀。
僅限本機 127.0.0.1 存取,零訂閱密鑰外洩;若 AI 請求中斷 VPN 或擴大直連,桌面版會彈窗請你確認。
點擊任意卡片右上角的「複製」,貼給 Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / 豆包工作版 / 千問 即可立即執行。
“幫我看看現在連哪個節點,測一下延遲並切換到最快的日本節點。”
“我連不上 huggingface.co 和 docker.io,幫我把這兩個網站加進走 VPN 的分流規則。”
“幫我設定讓公司內網與網銀網站保持直連,不要走 VPN 繞路。”
“讓 Cursor 與終端機的 git 走 VPN,電腦上其他遊戲和下載全部保持直連。”
“為什麼連 api.openai.com 很慢?幫我檢查是 DNS 問題還是節點延遲過高。”
“剛才改完分流好像有點問題,幫我一鍵恢復到修改之前的設定。”
一般使用只需將上方那句話貼給 AI 即可自動接好。若需查閱底層 8 項受控核心工具或手動編寫設定檔,可參考下方技術規格:
| MCP 工具名称 | 所需权限域 | 核心能力与真实内核动作 | 安全边界与确认机制 |
|---|---|---|---|
| get_capabilities | read | 返回当前系统平台、sing-box 内核版本、活跃模式(TUN / Proxy)、预授权边界及 12 项内置已验证服务预设清单 | 只读查询,自动过滤平台不支持的规则类型 |
| get_vpn_status | read | 读取真实连接状态、当前节点、出口 IP、分流模式、策略版本号(policyVersion)与自定义规则数 | 零私钥、零订阅凭证暴露 |
| list_servers | read | 返回当前付费账户或本机有效订阅实际有权使用的节点列表(ID、名称、地区、协议簇) | 实时核验付费会员到期状态,脱敏底层连接密钥 |
| connect_vpn / disconnect_vpn | modify | 复用桌面端真实连接控制建立或断开加密隧道,返回连接后实测出口探测结果(与云端 CLI 工具同名对齐) | 断开 VPN 默认需用户在应用内手动点击批准 |
| diagnose_connection | diagnose | 对指定域名、IP 或 URL 执行 DNS(A/AAAA)、IPv6 可达性、TCP/HTTPS 延迟及 sing-box 真实出站日志核验 | 内置滑动窗口限流(15 次/分)与响应体积上限(32 KB) |
| preview_routing_rules | modify | 校验拟议规则(domain / domain_suffix / ip_cidr / process_name / service_preset),生成计划 ID、差异对比与冲突提示 | 纯预览不改网络;拦截 0.0.0.0/0 及未验证预设 |
| apply_routing_rules | modify | 校验 basePolicyVersion 与幂等键,保存安全快照后编译写入 sing-box 并验证目标路径真正生效 | 若内核重载或连接校验失败,本地自动回滚上一安全快照 |
| rollback_routing_rules | modify | 一键恢复上一份或指定 snapshotId 的安全分流配置,并重新验证内核状态 | 无需依赖 AI 再次联网,绝不降级为静默全局直连 |
# 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 並強制校驗 Host 與 Origin 標頭;透過同一個 yivpn-agent-cli v2.2 執行 mcp 時會自動偵測本機連接埠完成橋接。傳統 VPN 依賴人工註冊與圖形介面,難以整合進 CI/CD 或自主 AI 工作流。YIVPN Agent API(https://yivpn.net/api/v1/vpn)以純 REST 介面結合 ed25519-v1 密碼學簽章完成自動化存取。
rail: "trial" 立即領取 90 分鐘(1 GB)免費試用(相容既有代理與雲端環境);多區長期需求支援 Hosted Checkout(信用卡、Apple Pay、Alipay)與 HTTP 402 Base USDC(x402)。GET /api/v1/vpn/config?mode=proxy 秒級取得專屬設定檔。sing-box 監聽 127.0.0.1:10808(HTTP + SOCKS5),不修改預設路由,100% 確保遠端 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 API 需要容器具備 CAP_NET_ADMIN 權限並覆寫系統路由表,極易導致雲端伺服器 SSH 斷線;YIVPN 針對容器與受限網路提供原生工程解法:
| 架構維度 | YIVPN Agent API | 傳統 WireGuard API |
|---|---|---|
| 容器與 SSH 安全性 | 預設免 Root 本地代理 (127.0.0.1:10808),絕不斷開 SSH;亦支援 TUN 模式 | 強制要求 Root 權限並改寫預設路由,容易切斷 SSH |
| 抗封鎖傳輸協定 | Hysteria2 (QUIC/UDP 443) + VLESS+REALITY (TLS 1.3/TCP 443) | 裸 UDP WireGuard 封包特徵明顯,易遭防火牆阻斷 |
| 全球低延遲樞紐 | 美國 (US)、日本 (JP)、新加坡 (SG)、香港 (HK) 智慧選路 | 單一靜態節點,切換地區需重新申請設定 |
| 密鑰輪換與撤銷 | 支援 /rotate 原子級轉移剩餘天數與 DELETE 立即撤銷 | 無內建請求時間戳防重放機制 |
透過 PUT /api/v1/vpn/settings,Agent 可即時啟用惡意網域攔截與廣告過濾,並與國際版 YiPro 享有完全一致的定價:
| 護欄 / 方案週期 | 技術機制 / 價格 (USD) | 應用場景 |
|---|---|---|
| guardrails: malware(預設啟用) | Cloudflare Security DoH (1.1.1.2) + 釣魚網域規則阻斷 | 防止無頭瀏覽器連線至惡意程式或釣魚網站 |
| guardrails: ads / adult | 廣告追蹤規則阻斷 / Family DoH (1.1.1.3) | 加速網頁載入、降低自動化擷取雜訊 |
| guardrails: smart_split | 區域網路與指定網段直連,跨境流量走加密通道 | 兼顧內網資料庫直連與外部 API 隱私存取 |
| 免費試用(rail: "trial") | $0(90 分鐘 / 1 GB 配額 · 24h 冷卻) | 免註冊免綁卡即開 US-Ohio 通道(掛著既有代理或雲端環境皆可領取) |
| API 訂閱定價(最多 5 並發) | 1 個月 $2.99 · 3 個月 $6.99 · 6 個月 $12.99 · 12 個月 $21.99 | 解鎖美/日/新/港全節點與不限時連線,單一公鑰最多 5 個沙盒同時連線 |
可以。直接把頁面頂部的指令傳給你的 AI Agent(或執行 npx --yes github:yivpn-official/yivpn-agent-cli connect --auto-trial),免註冊免綁卡即可獲得 90 分鐘 / 1 GB 的 US-Ohio 加密通道(每台裝置每 24 小時限領一次,支援既有代理與雲端環境)。
不需要。全程透過標準 HTTP API 與開源 sing-box 核心運作,無需註冊帳號或安裝任何圖形介面用戶端。
不會。預設的 mode=proxy 僅在 127.0.0.1:10808 提供本地 HTTP 與 SOCKS5 代理,不變更主機路由表,也不需要 Root 權限。
呼叫簽章介面 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.0)時會自動偵測執行環境:在 Docker 或雲端伺服器上自動啟用免帳號 API 與 127.0.0.1:10808 免 Root 代理守護行程;若偵測到本機 YIVPN 桌面版開啟了 Local MCP(127.0.0.1:38410),則自動橋接桌面核心以支援 preview_routing_rules、apply_routing_rules 與自動回滾。
下載 YIVPN v1.0.6 官方客戶端,內建離線 sing-box 核心與智慧分流,安裝即用。
支援最多 5 台裝置同時連線 · 全球高速節點 · 桌面端本地 AI MCP 服務
在 Windows、macOS 或 Android 應用程式選擇「啟用碼登入」輸入此碼即可免密連線,亦可用於重設密碼:
YIVP-XXXX-XXXX-XXXX
您尚未複製或下載保存啟用碼!請先點擊「一鍵複製」或「下載備份」以免遺失憑證。
使用專屬 YIVP 啟用碼免密登入,或使用帳號 / 信箱與密碼登入。
註冊後將同時產生專屬 YIVP 啟用碼;填寫信箱可隨時透過 6 位數驗證碼重設密碼。
支援透過綁定信箱接收 6 位數驗證碼重設,或直接使用 YIVP 啟用碼重設密碼。
YIVP-••••-••••-••••